Facebook Ad Details API - Archive ID, Page ID & Country

Provide the matching ad_archive_id, page_id and two-letter country for a public advertisement. The sampled search-ads response supplies archive and advertiser IDs, but this detail endpoint itself has not been sampled. Validate its exact response layout and available creative fields before using it for enrichment. Keep the three inputs associated with the same advertisement; a public ad lookup does not grant campaign-editing access or guarantee spend and audience statistics.

API Features

Three-part ad context Combines an archive identifier with its advertiser Page and selected country.

Search-to-details linkage Archive and Page IDs were observed in ad search and can seed a validated follow-up lookup.

Contextual detail alternative Offers the contextual lookup to try when the documented ID-only convenience route is unreliable.

No private ad-metric promise Creative research does not imply access to advertiser spend, audience or campaign administration.

Live API Demo

GET /api/project/facebook-scraper/get-ad-details

API Response (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/facebook-scraper/get-ad-details?key=<API_KEY>&ad_archive_id=<ad_archive_id>&country=<country>&page_id=<page_id>'

curl -X GET 'https://api.opendata-api.com/api/project/facebook-scraper/get-ad-details?key=<API_KEY>&ad_archive_id=<ad_archive_id>&country=<country>&page_id=<page_id>'

📢

Need Help?

If you encounter API issues or need other API requirements, please contact us.

Use Cases

Enrich a shortlisted public ad with a context-matched detail request.
Re-fetch a saved archive ID together with its original Page and country for review.
Evaluate detail-field differences from the keyword-search snapshot before building a join.
Provide a contextual fallback in an ad annotation tool when the ID-only route does not resolve.

Frequently asked questions

Why do ad details require an ad ID, a Page ID and a country?

This endpoint locates an ad using ad_archive_id, page_id and country together. Use matching values from the same ad record rather than mixing in another advertiser.

Is the detail structure always the same as ad search?

Not necessarily. The detail endpoint has not been independently validated. Inspect the actual envelope and creative fields before linking records.

Can ad details retrieve spend or modify an ad?

No such capability is promised. This is a public-information read, not ad management, and private performance metrics are not guaranteed.

Related operations

Guides

View Subscription Plans →

Get Ad Details with Archive and Page Context