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 Ad Library APIfor AI agents
One API call to search the Meta Ad Library. Get Facebook and Instagram ads as JSON.
What people use it for.
Research ads in a market
Search a product type with status set to active. Read text and ctaText to see how advertisers in your market sell.
Collect video ads
Set mediaType to video and platforms to instagram. Open each link in videoUrls to study the video ads.
Find ads that keep running
Compare firstShownAt with today for the active ads. An ad that has run for months is one that the advertiser keeps paying 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 and no access token.
A results list and a cursor. Each ad has adId, adUrl, pageId, pageName, isActive, firstShownAt, lastShownAt, platforms, format, text, linkUrl, linkTitle, ctaText, imageUrls, videoUrls, cards and versions.
country takes a two-letter code or all, and defaults to us. status takes active, inactive or all. mediaType takes image, video, text, meme or imageAndMeme. platforms takes facebook, instagram, audienceNetwork, messenger, whatsapp and threads. language, shownFrom and shownTo narrow the list more.
A carousel ad has several cards. Each card has its own text, linkUrl, linkTitle, ctaText, imageUrl and videoUrl.
Call meta.ads.page with the page's id, name or URL in advertiser. A keyword search returns ads from every page that matches the words.
1 credit for each call that returns data. A call that returns an error or an empty list uses 0 credits. To get more ads, send the cursor from the last response.
Yes. Add the MCP server at https://api.stophy.dev/mcp to Claude, Cursor or Codex. The agent calls the endpoint by the id metaAdsSearch.
Get started
Give your agent the web today.
Sign up for 1,000 free credits. No card needed.