The Pinterest pins your agent needs.
Pinterest Search returns pins for a keyword, each with image, link, author and board. Choose pins or videos and read a page at a time.
terminal
Pinterest APIfor AI agents
One API for Pinterest data. Get pins, boards, profiles and ads as JSON.
The Pinterest endpoints.
- Pinterest Search APIOne API call to search Pinterest. Get pins with images and links as JSON.
- Pinterest Pin APIOne API call to get a Pinterest pin. Get its image, link and counts as JSON.
- Pinterest Board APIOne API call to read a Pinterest board. Get the board and its pins as JSON.
- Pinterest Profile APIOne API call to read a Pinterest profile. Get its stats and pins as JSON.
- Pinterest Ad Library APIOne API call to search Pinterest's ads library. Get ads with reach and audience as JSON.
- Pinterest Ad Details APIOne API call to read a Pinterest ad. Get its reach, dates and audience as JSON.
How agents use it.
Collect visual references
The agent calls pinterestSearch with a keyword and saves imageUrl, title and linkUrl. It then calls pinterestPin with a pinId to get the saves and the comments count.
Map a brand's boards
The agent calls pinterestProfile and collects the boardUrl of each pin. It then calls pinterestBoard with each boardUrl to read the pins count, the followers and the pins.
Find the sites behind popular pins
The agent calls pinterestSearch and groups the results by domain. It then calls pinterestPin on the pins of one domain and ranks them by saves.
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 account and no developer app. The ad endpoints need no Pinterest business account.
A pin has pinId, title, text, linkUrl, domain, imageUrl, saves, reposts, comments and reactions. A board has name, description, pins, followers and sections. A profile has username, bio, website, followers, pins and boards. An ad has headline, text, reachMin, reachMax, ageRanges, genders and interests.
No. The endpoints read public pins, boards and profiles. They do not create pins, save a pin to a board or follow accounts, and they do not log in. The ad endpoints cover the countries where Pinterest publishes ads: EU countries, Brazil and Turkey.
pinterest.search, pinterest.board, pinterest.profile and pinterest.ads.search return a cursor. Send it in the next call with the same inputs. pinterest.pin and pinterest.ads.ad return one item.
A page of search results, a page of a board and a single pin each cost 1 credit when the call returns data. The ad endpoints also cost 1 credit. A call that returns an error or an empty list uses 0 credits.
Connect the agent to https://mcp.stophy.dev/mcp and sign in with your browser. To use an API key, connect to https://api.stophy.dev/mcp and send the header Authorization: Bearer <key>. The agent calls each endpoint by its id in camelCase. For example, pinterest.board is pinterestBoard and pinterest.ads.search is pinterestAdsSearch.
Get started
Give your agent the web today.
Sign up for 1,000 free credits. No card needed.