FACEBOOK AD LIBRARY API
Ad Details
Retrieve ad details from Facebook Ad Library with a single API request.
GET
/api/data/v1/facebook/adLibrary/ad1credit base costZero-credit cache supported
Request parameters
Up to 1 creditFacebook Ad Id
Facebook Ad URL
Set to true for a trimmed down version of the response
If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.]
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v1/facebook/adLibrary/ad?id=702369045530963' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"credits_charged": 1,
"adArchiveID": 1185617869915074,
"endDate": 1750316400,
"isAAAEligible": false,
"isActive": true,
"pageID": 15087023444,
"pageName": "Nike",
"politicalCountries": [],
"reachEstimate": null,
"snapshot": {
"ad_creative_id": 1809449763118705,
"cards": [],
"body_translations": {},
"byline": null,
"caption": "fb.com",
"cta_text": "Learn more",
"dynamic_item_flags": {},
"dynamic_versions": null,
"edited_snapshots": [],
"effective_authorization_category": "NONE",
"event": [],
"extra_images": [
{
"original_image_handle": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/508997149_744746594672572_3057533797808431470_n.jpg?_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=eKgqs7-b06UQ7kNvwGSYm41&_nc_oc=AdnV_v1Anh3aqBBXDa3xwDrMtLJUCvE8yKIgP5ODbX3xsSMCtTv2ucMTy36I8Bq20HU&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=ocFZ2kPWmNZ0nKyk5HCtkQ&oh=00_AfNfDJHp6d0Ie9tIXLBIXFQiMgWHVl1i48DahYYOgANgHg&oe=685A4B4A",
"resized_image_handle": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/508997149_744746594672572_3057533797808431470_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=eKgqs7-b06UQ7kNvwGSYm41&_nc_oc=AdnV_v1Anh3aqBBXDa3xwDrMtLJUCvE8yKIgP5ODbX3xsSMCtTv2ucMTy36I8Bq20HU&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=ocFZ2kPWmNZ0nKyk5HCtkQ&oh=00_AfMe107fPkaznD6Pw8_wDaon3p-31ZXLHIeglHU_P3NYNw&oe=685A4B4A"
}
],
"extra_links": [
"https://www.nike.com.ar/"
],
"extra_texts": [],
"extra_videos": [],
"instagram_shopping_products": [],
"display_format": "image",
"title": "6 cuotas sin interés",
"link_description": null,
"link_url": "https://fb.com/canvas_doc/1952657995267951",
"page_welcome_message": null,
"images": [
{
"original_image_url": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.35426-6/499542231_3815578848587795_5060085138610262269_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=yk26_frcPLkQ7kNvwF5EWnq&_nc_oc=Adk8Xjt1SjUg-mBxkm6iUuDfXpyGXD5G5g6PBae8g0WWsJT-MfnhNGII7JL-KM5MJBE&_nc_zt=14&_nc_ht=scontent-ord5-2.xx&_nc_gid=ocFZ2kPWmNZ0nKyk5HCtkQ&oh=00_AfP6zfVuLkcD2Zts0gItXp801QK1k0lhEfqwwdqfNAU9gw&oe=685A3E80",
"resized_image_url": "https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/509090139_3448752085259208_8196922920009954562_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=tV3v2Y_NIh0Q7kNvwEMM-Vk&_nc_oc=AdnpccGMqNlM0k9O87VmMBIp9pGtj3l1dkO5HaKRCti2V4X6AKUn8BR08SXOc_Y-8TY&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=ocFZ2kPWmNZ0nKyk5HCtkQ&oh=00_AfPXGzKezcPJSpAq8Ql2Xgx6Rn0a3Poit-iTirfhAwuiHA&oe=685A5634",
"watermarked_resized_image_url": "",
"image_crops": {}
}
],
"videos": [],
"creation_time": 1750344986,
"page_id": 15087023444,
"page_name": "Nike",
"page_profile_picture_url": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.35426-6/508670148_9776464209142246_4487234065380829819_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Q0UJas7Kz2wQ7kNvwGKBRCa&_nc_oc=AdnobFr6ScYQJzp_Za4UEgMY34n373z6WuZwOA3h-ixlpbii4wA8lxcgAsbtBpCE3t4&_nc_zt=14&_nc_ht=scontent-ord5-2.xx&_nc_gid=ocFZ2kPWmNZ0nKyk5HCtkQ&oh=00_AfMlwCCMXN-4KPAZac9pYLWrHGZpld9SoTX1r9S9xRHB8Q&oe=685A5861",
"page_categories": {
"1713352298924731": "Sportswear"
},
"page_entity_type": "person_profile",
"page_is_profile_page": false,
"instagram_actor_name": "Nike",
"instagram_profile_pic_url": "https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/499229861_3519049748228633_8442052921006945421_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=eJcuzztd8e4Q7kNvwEpFLbr&_nc_oc=AdlI7WAi5QRhAOZCLwHcU3ZgxpxWSTzJr9PjPiwtUN9U2mkMB49Surq8HsQcDWfnTVc&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=ocFZ2kPWmNZ0nKyk5HCtkQ&oh=00_AfNnIjlMGopiAeVY7yEOxCT0sEvrij87SMrpkGJHs1lT-w&oe=685A55E2",
"instagram_url": "",
"instagram_handle": "",
"is_reshared": false,
"version": 3,
"body": "Aprovechá 6 cuotas sin interés con todos los bancos. ¿Te lo vas a perder? Comprá ahora.",
"brazil_tax_id": null,
"branded_content": null,
"current_page_name": "Nike",
"disclaimer_label": null,
"page_like_count": 37497720,
"page_profile_uri": "https://www.facebook.com/nike/",
"page_is_deleted": false,
"root_reshared_post": null,
"cta_type": "LEARN_MORE",
"additional_info": null,
"ec_certificates": null,
"country_iso_code": null,
"instagram_branded_content": null
},
"totalActiveTime": 23488,
"spend": null,
"startDate": 1750316400,
"publisherPlatform": [
"facebook"
],
"url": "https://www.facebook.com/ads/library?id=1185617869915074",
"startDateString": "2025-06-19T07:00:00.000Z",
"endDateString": "2025-06-19T07:00:00.000Z",
"aaa_info": null
}Example data from the API specification. Run a request to retrieve current data.
Response shape
This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.
View JSON Schema +
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"credits_remaining": {
"type": "integer"
},
"credits_charged": {
"type": "integer"
},
"adArchiveID": {
"type": "integer"
},
"endDate": {
"type": "integer"
},
"isAAAEligible": {
"type": "boolean"
},
"isActive": {
"type": "boolean"
},
"pageID": {
"type": "integer"
},
"pageName": {
"type": "string"
},
"politicalCountries": {
"type": "array"
},
"reachEstimate": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"snapshot": {
"type": "object",
"properties": {
"ad_creative_id": {
"type": "integer"
},
"cards": {
"type": "array"
},
"body_translations": {
"type": "object",
"properties": {}
},
"byline": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"caption": {
"type": "string"
},
"cta_text": {
"type": "string"
},
"dynamic_item_flags": {
"type": "object",
"properties": {}
},
"dynamic_versions": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"edited_snapshots": {
"type": "array"
},
"effective_authorization_category": {
"type": "string"
},
"event": {
"type": "array"
},
"extra_images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"original_image_handle": {
"type": "string"
},
"resized_image_handle": {
"type": "string"
}
}
}
},
"extra_links": {
"type": "array",
"items": {
"type": "string"
}
},
"extra_texts": {
"type": "array"
},
"extra_videos": {
"type": "array"
},
"instagram_shopping_products": {
"type": "array"
},
"display_format": {
"type": "string"
},
"title": {
"type": "string"
},
"link_description": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"link_url": {
"type": "string"
},
"page_welcome_message": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"original_image_url": {
"type": "string"
},
"resized_image_url": {
"type": "string"
},
"watermarked_resized_image_url": {
"type": "string"
},
"image_crops": {
"type": "object",
"properties": {}
}
}
}
},
"videos": {
"type": "array"
},
"creation_time": {
"type": "integer"
},
"page_id": {
"type": "integer"
},
"page_name": {
"type": "string"
},
"page_profile_picture_url": {
"type": "string"
},
"page_categories": {
"type": "object",
"properties": {
"1713352298924731": {
"type": "string"
}
}
},
"page_entity_type": {
"type": "string"
},
"page_is_profile_page": {
"type": "boolean"
},
"instagram_actor_name": {
"type": "string"
},
"instagram_profile_pic_url": {
"type": "string"
},
"instagram_url": {
"type": "string"
},
"instagram_handle": {
"type": "string"
},
"is_reshared": {
"type": "boolean"
},
"version": {
"type": "integer"
},
"body": {
"type": "string"
},
"brazil_tax_id": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"branded_content": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"current_page_name": {
"type": "string"
},
"disclaimer_label": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"page_like_count": {
"type": "integer"
},
"page_profile_uri": {
"type": "string"
},
"page_is_deleted": {
"type": "boolean"
},
"root_reshared_post": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"cta_type": {
"type": "string"
},
"additional_info": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"ec_certificates": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"country_iso_code": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"instagram_branded_content": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
},
"totalActiveTime": {
"type": "integer"
},
"spend": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"startDate": {
"type": "integer"
},
"publisherPlatform": {
"type": "array",
"items": {
"type": "string"
}
},
"url": {
"type": "string"
},
"startDateString": {
"type": "string"
},
"endDateString": {
"type": "string"
},
"aaa_info": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
}