Pinterest API
Posts.
The Pinterest API lets you search posts and read post details, with no Pinterest account or login. Each call costs 2 credits ($0.004 to $0.0067); failed calls are free. Pinterest does not give view counts, so that field is returned as null. Use it over HTTP with an API key, or through MCP from your AI client. Last tested 2026-11-19.
Last tested: Last updated:
/v1/search200 OK2 creditsplatform: "pinterest" · query: "mid century living room"nullcomments nullshares nullcollects nullviews nullmetrics.likesmetrics.commentsmetrics.sharesmetrics.collects+42 actions.
One response format.
Open a row to see its request. Its full parameters and response fields are on its own page.
SearchFind posts by keyword: text, author and publish time./v1/search2 credits≈ $0.0067$0.13 per 1,000 (up to 50 a page)
platformquerycurl https://socialtoai.app/v1/search \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "pinterest", "query": "mid century living room" }'POST /v1/searchYour key goes in the Authorization headerDetailOne post by ID or link: text, author, likes, comment count and publish time./v1/detail2 credits≈ $0.0067
platformid or urlcurl https://socialtoai.app/v1/detail \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "pinterest", "id": "4601834496922433600" }'POST /v1/detailYour key goes in the Authorization headerNot offered on Pinterest: trending, comments, user_profile and user_posts.
Compared with Instagram: Pinterest posts also give title, author followers, shares and saves but do not give views or hashtags.
What a whole job costs.
| The job | How it adds up | Credits | About |
|---|---|---|---|
| Search 1,000 results on Pinterest | usually 20 a page, 50 pages | 100 credits | about $0.33 |
Priced at the $10 pack; larger purchases bring it down. A watch runs only while it is on, and you can pause it at any time. There is no subscription.
Or skip the parameters.
Just ask.
Connect SocialToAI once over MCP. Your AI picks the calls, and you see what each one cost.
Which is bigger on Pinterest this week: home coffee or matcha?
- search“home coffee”2 credits
- search“matcha”2 credits
Same shape on every platform.
Learn it once.
A Pinterest post and a Xiaohongshu note come back with the same field names. What a platform cannot give comes back as null.
{ "platform": "pinterest", "id": "…", "ref": "…", "approx": [], "extra": {}, "type": "content", "url": "https://example.com/…", "format": "image", "title": "…", "text": "…", "published_at": "2026-09-17T09:40:55.000Z", "author": { "id": "…", "username": "…", "name": "…", "verified": true, "followers": 11240179 }, "metrics": { "likes": 0, "comments": 0, "shares": 0, "collects": 4, "views": null, "reposts": null }, "images": ["https://example.com/…"], "hashtags": null, "is_pinned": null}metrics.viewsmetrics.repostshashtagsis_pinned{ "platform": "xiaohongshu", "id": "…", "ref": "…", "approx": [], "extra": {}, "type": "content", "url": "https://example.com/…", "format": "image", "title": "…", "text": "…", "published_at": "2026-10-09T01:00:34.000Z", "author": { "id": "…", "username": "…", "name": "…", "verified": null, "followers": null }, "metrics": { "likes": 927, "comments": 122, "shares": 256, "collects": 59, "views": null, "reposts": null }, "images": ["https://example.com/…", "https://example.com/…"], "hashtags": ["…", "…"], "is_pinned": false}author.verifiedauthor.followersmetrics.viewsmetrics.repostsOne tool reads Pinterest.
All toolsDoes Pinterest have an official API?
Pinterest offers an official API for creators, advertisers and merchants. Apps must be submitted for review, start with Trial access, and need a further review with a demo of the OAuth flow for Standard access; the docs list reading boards and Pins but do not describe a public content search.
Source: Pinterest's developer documentation, checked 2026-10-17.
1,000 posts here: about 50 pinterest.search calls (typically 20 a page), 100 credits, $0.33 at the first pack. Estimate your cost
- Pinterest MCP serverLet your AI read Pinterest.