The Pinterest ads your agent needs.
Pinterest Ad Library returns the ads shown in a country, each with reach, run dates and audience, a page at a time.
terminal
Pinterest Ad Library APIfor AI agents
One API call to search Pinterest's ads library. Get ads with reach and audience as JSON.
What people use it for.
Review a brand's Pinterest ads
Set country to a market and advertiser to a competitor. Open each imageUrl to see the ads the brand runs there.
See who ads are aimed at
Read ageRanges, genders and interests on each ad. They show the audience the advertiser chose.
Find the ads with the most reach
Sort the results by reachMax. The first ads are the ones that reached the most people in the country.
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 Pinterest business account and no login.
A results list and a cursor. Each ad has adId, adUrl, headline, text, imageUrl, videoUrl, links, firstShownAt, lastShownAt, reachMin, reachMax, reachByCountry, countries, ageRanges, genders, interests and audienceTypes.
country is required. It takes an EU country code such as fr or de, or br or tr. Pinterest publishes ads for these countries only.
Send the advertiser's name in advertiser. The search has no keyword input, so country and advertiser are the two filters.
Send the cursor from the last response, with the same country and advertiser.
1 credit for each call that returns data. A call that returns an error or an empty list 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 pinterestAdsSearch.
Get started
Give your agent the web today.
Sign up for 1,000 free credits. No card needed.