The Facebook page ads your agent needs.
Facebook Page Ads returns the ads that a page runs. Find the page by id, name or link, and control the ads by country, status, media type and date.
terminal
Facebook Page Ads APIfor AI agents
One API call to get the ads of a Facebook page. Get each ad's text and media as JSON.
What people use it for.
Watch a competitor's new ads
Set advertiser to a competitor's page and run the call each day. An adId that you have not saved is a new ad.
Find the pages a brand promotes
Read linkUrl on each ad and count the links. The pages that get the most ads are the ones the brand pushes.
Measure how often ads change
Set status to all and compare the active count with the inactive count. You see how often the page changes its ads.
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 Facebook login and no access to the page.
Send advertiser. It takes the page's id, its name or its URL.
A results list and a cursor. Each ad has adId, adUrl, pageName, pageLikes, pageCategories, isActive, firstShownAt, lastShownAt, platforms, format, text, linkUrl, ctaText, imageUrls and videoUrls.
Set status to inactive or all. The default is active. Use shownFrom and shownTo to keep the ads shown in a date range.
country takes a two-letter code or all. mediaType, platforms and language work as they do on meta.ads.search.
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 metaAdsPage.
Get started
Give your agent the web today.
Sign up for 1,000 free credits. No card needed.