Meta Ad Library API - Facebook and Instagram Ad Search

Search the Meta Ad Library by keyword, list every ad a Facebook Page is running, or pull one ad by its archive id - with the full creative, the platforms each ad ran on, its run dates, and spend/reach/impressions on political and issue ads. All three endpoints return structured JSON.

The paths are hyphenated: /api/v1/meta-ads/*. Copy them exactly.

When to trigger

Use this skill when the user asks to:

• See what ads a brand or competitor is running on Facebook and Instagram
• Pull every ad from a specific Facebook Page
• Build a creative swipe file - ad copy, headlines, CTAs, images and videos
• Research political or issue ads, their spend, reach and paid-for-by disclosure
• Track how long an ad has been running, and on which Meta platforms
• Scrape a whole keyword or advertiser out of the Ad Library into a dataset

Full cursor pagination is the point

Most Ad Library tools show you a page and stop. This one walks the whole thing.