Facebook Ad Archive ID Lookup API - ID-Only Detail Shortcut

Pass ad_archive_id when only a saved public ad archive identifier is available. Documentation warns that this convenience route can be less reliable; use get-ad-details with the matching country and Page ID when available. No response for this endpoint was sampled, so neither creative fields nor an equivalence with the contextual detail route is guaranteed. A failure here alone must not be interpreted as evidence that an ad was deleted.

API Features

Archive-only entry path Does not require country or Page ID as request inputs.

Documented reliability caveat The ID-only shortcut is described as less reliable than a context-rich lookup.

Contextual recovery route If context is known, get-ad-details provides an included alternative with Page and country inputs.

No deletion inference An unresolved archive-only read is not a definitive ad-deletion signal.

Live API Demo

GET /api/project/facebook-scraper/get-ad-details-by-just-id

API Response (JSON)

{}

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

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

📢

Need Help?

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

Use Cases

Inspect an imported archive-ID list before advertiser context has been reconciled.
Offer an archive-ID-only search box in an internal ad review tool.
Measure ID-only resolution separately from contextual detail resolution during client evaluation.
Send unresolved archive IDs to a context-enrichment queue instead of marking them deleted.

Frequently asked questions

Can I look up details with only ad_archive_id?

You can try this endpoint, but the documentation warns that reliability may be lower. Its result structure has not been independently validated either.

When should I switch to the full ad-detail endpoint?

When you know page_id and country for the same ad, use them with ad_archive_id for the contextual lookup, especially if the ID-only lookup fails.

Does a failed lookup mean that the ad no longer exists?

No. Failure of this convenience endpoint is not enough to establish deletion. Supply the missing context and preserve an uncertain state.

Related operations

Guides

View Subscription Plans →

Get an Ad Using Only its Archive ID