The Meta ad details your agent needs.
Meta Ad Details returns one ad with its text, media, payer, audience by age and region, and EU reach.
terminal
Meta Ad Details APIfor AI agents
One API call to read a Meta ad. Get its audience, payer and reach as JSON.
What people use it for.
See who an ad reached
Read audienceAgeGender and audienceRegions on a competitor's ad. They show who saw the ad.
Compare reach in the EU
Read euReachByCountry to compare the countries of a campaign in the EU.
Check who is behind an ad
Read payers and advertiserVerification before you report on an ad. They show who stands behind it.
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 and an ad link or an ad id. You need no Meta developer app.
One ad. It has the fields of a search result, plus advertiserDescription, advertiserCategory, advertiserVerification, advertiserInstagram, audienceAgeGender, audienceRegions, euReachTotal, euReachByCountry and payers.
audienceAgeGender has one item for each age group, with the female, male and unknown values. audienceRegions has one item for each region, with its share.
Each item in payers has paidBy and beneficiary. paidBy names who paid for the ad, and beneficiary names who the ad is for.
The fields exist on every ad: spendMin, spendMax, impressionsMin and impressionsMax. A field is null when the Ad Library does not publish that number for the ad.
1 credit for each call that returns data. A call that returns an error uses 0 credits.
Yes. Add the MCP server at https://api.stophy.dev/mcp to Claude, Cursor or Codex. The agent calls the endpoint by the id metaAdsAd.
Get started
Give your agent the web today.
Sign up for 1,000 free credits. No card needed.