Facebook Scraper
Get Facebook Ad Library Ad Details
Retrieves detailed information about a specific Facebook ad by its ID or URL. Returns adArchiveID, pageName, isActive, startDate, endDate, and a snapshot containing body, images, videos, display_format, link_url, and cta_text. Regulated ads may also include source-dependent aaa_info using the structure shown below. Political and social issue delivery data is normalized to location_audience and age_country_gender_reach_breakdown. Political location_audience rows include reach, and political delivery values are fractional shares, so 0.08 means 8%. Regional transparency data may use absolute reach counts. For ads with multiple versions, the ad creative is found in the snapshot.cards array rather than snapshot.body. Transcription is opt-in via get_transcript=true. Over 120 seconds, videos cannot be AI-transcribed by default. These routes remain synchronous. Allow at least 30 seconds on your client.
1 creditNo API key neededEndpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| idstring · optional | string | optional | Facebook Ad Id |
| urlstring · optional | string | optional | Facebook Ad URL |
| trimboolean · optional | boolean | optional | Set to true for a trimmed down version of the response |
| cache_max_agestring · optional | string | optional | See the Caching page for details. One of: |
| get_transcriptboolean · optional | boolean | optional | Transcription is opt-in via get_transcript=true. Over 120 seconds, videos cannot be AI-transcribed by default. These routes remain synchronous. Allow at least 30 seconds on your client. |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"pageID": {
"type": "number"
},
"endDate": {
"type": "number"
},
"isActive": {
"type": "boolean"
},
"pageName": {
"type": "string"
},
"snapshot": {
"type": "object",
"additionalProperties": {}
},
"adArchiveID": {
"type": "number"
},
"isAAAEligible": {
"type": "boolean"
},
"reachEstimate": {},
"totalActiveTime": {
"type": "number"
},
"politicalCountries": {
"type": "array"
}
},
"additionalProperties": true
}
