Facebook Advertiser Page Ads API

Supply page_id, a two-letter country and one active_status value from ALL, ACTIVE or INACTIVE. cursor and the boolean sort_by_new are optional documented inputs. This advertiser-specific route was not sampled; do not assume the search-ads payload is identical or that sort_by_new guarantees a particular chronology. Inspect returned archive identifiers and creative fields before joining records. Repeated checks and new-ad detection require your own scheduling and storage; this read does not create alerts or manage campaigns.

API Features

Known-advertiser scope Starts from a selected page_id instead of a broad category keyword.

Single ad-status choice Choose ALL, ACTIVE or INACTIVE rather than sending the documentation list as one value.

Optional new-first input sort_by_new is a documented boolean control whose ordering behavior still needs testing.

Application-managed creative tracking Comparing saved ad identifiers is a client workflow, not an embedded notification service.

Live API Demo

GET /api/project/facebook-scraper/get-page-ads

API Response (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/facebook-scraper/get-page-ads?key=<API_KEY>&active_status=ALL&country=US&page_id=<page_id>&sort_by_new=false'

curl -X GET 'https://api.opendata-api.com/api/project/facebook-scraper/get-page-ads?key=<API_KEY>&active_status=ALL&country=US&page_id=<page_id>&sort_by_new=false'

📢

Need Help?

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

Use Cases

Evaluate a country-specific advertiser creative view for a confirmed Page.
Schedule bounded Page ad reads in your own application after validating the response.
Compare stored ad archive IDs to identify newly observed creatives without claiming launch-time alerts.
Test new-first ordering separately from active-status filtering in an advertiser research client.

Frequently asked questions

What other parameters are needed when I know a competitor Page ID?

In addition to page_id, provide a two-letter country code in country and one active_status value. cursor and sort_by_new are optional.

Does sort_by_new guarantee ordering by ad launch time?

This is not yet guaranteed. It is a documented boolean control, but the exact chronology and fields need validation against actual responses.

Does it automatically alert me when a competitor publishes a new creative?

No. Schedule requests, save identifiers and compare snapshots yourself. This can only identify a newly observed ad, not guarantee its exact launch time.

Related operations

Guides

View Subscription Plans →

Find Ads for a Known Advertiser Page