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-10-17.
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
platformquerycurl https://api.socialtoai.com/v1/search \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -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
platformid or urlcurl https://api.socialtoai.com/v1/detail \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -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.
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": [], "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": [], "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.