Meta AdsGET
/v1/facebook/adLibrary/adAd details
1 request
Returns full details for one Facebook ad, looked up by ID or URL: adArchiveID, isActive, pageName, startDate, endDate, plus a snapshot containing body, cta_text, link_url, display_format, images, and videos. Regulated ads can add aaa_info with regulatory transparency details. Delivery data for political and social issue ads is normalized into location_audience and age_country_gender_reach_breakdown; political location_audience rows carry reach, and political delivery figures are fractions of the total (0.08 is 8%). Regional transparency data may report reach as absolute counts. When an ad has several versions, its creative sits in snapshot.cards instead of snapshot.body.
Query parameters
idstring | ID of the Facebook ad. |
urlstring | Link to the Facebook ad. |
trimboolean | true returns a slimmer response. |
cache_max_agestring | Accept a stored response up to this age. Inside that window the answer is free and comes back with cached: true and a cached_at time; past it, the request runs live for 1 request.
|
curl "https://api.pandorlabs.com/v1/facebook/adLibrary/ad" \ -H "Authorization: Bearer $PANDORLABS_KEY"Example response
Response
{
"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_v1Anh3aqBBXDa3xwDrMtLJUCvE8yKIgP5ODbX3xsSMCtTv2ucMTy36I8Bq…",
"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_v1Anh3aqBBXDa3xwDrMtLJUCvE8yKIgP5…"
}
],
"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-KM…",
"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=AdnpccGMqNlM0k9O87VmMBIp9pGtj3l1dkO5H…",
"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_Za4UEgMY34n373z6WuZwOA3…",
"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=AdlI7WAi5QRhAOZCLwHcU3ZgxpxWSTzJr9PjPiwtUN9U2mkMB49Surq8HsQcDW…",
"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"
},
"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
}