The Meta ads your agent needs.
Meta Ad Library returns ads for a keyword. Control it by country, status, media type, platform and date.
terminal
Meta Ads APIfor AI agents
One API for Meta Ad Library data. Get Facebook and Instagram ads, their audience and their reach as JSON.
The Meta Ads endpoints.
- Meta Ad Library APIOne API call to search the Meta Ad Library. Get Facebook and Instagram ads as JSON.
- Facebook Page Ads APIOne API call to get the ads of a Facebook page. Get each ad's text and media as JSON.
- Meta Ad Details APIOne API call to read a Meta ad. Get its audience, payer and reach as JSON.
How agents use it.
Audit a competitor's ads
The agent calls metaAdsPage with the name of a Facebook page and status set to active. It then calls metaAdsAd with each adId to read audienceAgeGender and euReachTotal.
Collect ad copy for a keyword
The agent calls metaAdsSearch with a keyword, a country and mediaType set to video. It reads text, ctaText and linkUrl, then calls metaAdsPage with a pageId to see what else that page runs.
Check who pays for an ad
The agent calls metaAdsSearch to find an ad on a topic. It then calls metaAdsAd and reads payers, where paidBy names who paid and beneficiary names who the ad is for.
Ways to call it.
- Use the APISend a POST request with a Bearer key. Every endpoint returns success, data, creditsUsed and requestId.
- Use MCPAdd https://api.stophy.dev/mcp to Claude, Cursor or Codex. The agent finds an endpoint and calls it.
- Use the SDKInstall the TypeScript or Python client. Call an endpoint by its id, such as youtube.transcript.
- Use the CLICall an endpoint from the terminal. The CLI prints JSON, so you can pipe the result into a script.
Start free. Pay per call after.
No plans and no monthly fee. 1,000 free credits to start, then $1.50 per 1,000 credits, $1.20 from $100 and $0.80 from $500. Credits never expire.
Free
Every account starts with free credits. No card needed.
1,000 free credits
$0
- ✓Every source
Pay as you go
Add credits to your balance and spend them one call at a time.
$1.50 per 1,000 credits, $1.20 from $100 and $0.80 from $500
$0.0015/ credit
10,000 credits≈ $13.50
Most calls cost 1 credit.
- ✓Never expires
Custom
For teams that need higher rate limits or a source we do not cover yet.
Volume pricing
Custom
- ✓Custom rate limits
- ✓New sources on request
- ✓Direct support
Questions and answers.
No. You call Stophy with a Stophy API key. You need no Meta developer app, no access token and no Facebook login.
An ad has adId, adUrl, pageName, isActive, firstShownAt, lastShownAt, platforms, format, text, linkUrl, ctaText, imageUrls and videoUrls. meta.ads.ad adds audienceAgeGender, audienceRegions, euReachTotal, euReachByCountry and payers.
It covers the ads that Meta publishes in its Ad Library, for Facebook, Instagram, Messenger, WhatsApp, Threads and Audience Network. It does not create or manage ads, and it does not read an ad account or its billing. It returns no Facebook or Instagram posts, profiles or messages.
meta.ads.ad has spendMin, spendMax, impressionsMin and impressionsMax on every ad. A field is null when the Ad Library does not publish that number for the ad.
meta.ads.search and meta.ads.page return a cursor. Send it in the next call with the same filters. meta.ads.ad returns one ad, so it has no pages.
1 credit for each call that returns data: a page of search results, a page of one advertiser's ads, or one ad. A call that returns an error or an empty list uses 0 credits.
Connect the agent to https://mcp.stophy.dev/mcp and sign in with your browser. To use an API key, connect to https://api.stophy.dev/mcp and send the header Authorization: Bearer <key>. The agent calls each endpoint by its id in camelCase. For example, meta.ads.search is metaAdsSearch and meta.ads.page is metaAdsPage.
Get started
Give your agent the web today.
Sign up for 1,000 free credits. No card needed.