The Pinterest ad details your agent needs.
Pinterest Ad Details returns one ad with its media, links, run dates, reach by country and audience.
terminal
Pinterest Ad Details APIfor AI agents
One API call to read a Pinterest ad. Get its reach, dates and audience as JSON.
What people use it for.
Compare a campaign by country
Read reachByCountry on an ad. Compare reachMax between the countries to see where the campaign is largest.
Find an ad's landing page
Read links and open the first one. You see the page that the advertiser wants people to visit.
Measure how long an ad ran
Read firstShownAt and lastShownAt. The time between them is how long the advertiser ran the ad.
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 Pinterest business account.
One ad. It has adId, adUrl, headline, text, advertisers, imageUrl, videoUrl, links, firstShownAt, lastShownAt, reachMin, reachMax, reachByCountry, countries, ageRanges, genders, interests, audienceTypes and isCommercial.
A list with one item for each country. Each item has country, reachMin and reachMax.
Call pinterest.ads.search with a country. Each result has an adId and an adUrl. Send either one here.
links lists the web pages that the ad sends people to. Read it to find the landing page.
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 pinterestAdsAd.
Get started
Give your agent the web today.
Sign up for 1,000 free credits. No card needed.