Pinterest API 数据接口
帖子。
Pinterest API(数据接口)可以搜帖子,读帖子详情,不用登录 Pinterest 账号,也不用提供 Cookie。每次调用 2 积分(约 $0.004–$0.0067),失败不扣。Pinterest 不提供浏览量,这个字段返回 null。可以直接发 HTTP 请求,也可以通过 MCP 接到 AI 客户端里用。最近实测:2026-10-17。
6 个里 2 个动作可用
2 积分起每次调用
同一种格式和其他调用一样
最近实测:最近更新:
POST
/v1/search200 OK2 积分platform: "pinterest" · query: "mid century living room"likes
nullcomments nullshares nullcollects nullviews null这里始终是 null:
metrics.likesmetrics.commentsmetrics.sharesmetrics.collects+4page下一页cursor
billing本次调用2 积分
示例数据录制的 16 条里的 1 条
2 个动作。
同一种返回格式。
点开任意一行,看请求怎么写;完整的参数和返回字段在它自己的页面。
动作每次调用积分
搜索按关键词找帖子:正文、作者和发布时间。/v1/search2 积分
cURL
curl 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/searchKey 放在 Authorization 请求头里详情用编号或链接取一条帖子:正文、作者、点赞数、评论数和发布时间。/v1/detail2 积分
cURL
curl https://api.socialtoai.com/v1/detail \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "platform": "pinterest", "id": "4601834496922433600" }'POST /v1/detailKey 放在 Authorization 请求头里Pinterest 不提供:热榜、评论、账号资料和账号作品。
也可以不管参数。
直接问。
通过 MCP 接一次 SocialToAI,之后该调哪些接口由 AI 决定,每一步花了多少积分你都看得到。
你问01
这周 Pinterest 上,家用咖啡和抹茶哪个更火?
AI 会调用
- search“home coffee”2 积分
- search“matcha”2 积分
合计4 积分
每个平台,同一种结构。
学一次就够。
Pinterest 的帖子和小红书的笔记,返回的字段名一模一样。平台给不了的字段,返回 null。
Pinterest详情 · 2 积分
{ "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}Pinterest 给不了,返回 null:
metrics.viewsmetrics.repostshashtagsis_pinned小红书详情 · 12 积分
{ "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}小红书给不了,返回 null:
author.verifiedauthor.followersmetrics.viewsmetrics.reposts示例数据字段恒在,变的只是值。
1 个工具能读 Pinterest。
全部工具Pinterest 有官方 API 吗?
Pinterest 提供面向创作者、广告主和商家的官方 API。应用须提交审核,先获得试用权限,再提交含 OAuth 授权流程演示的申请才能升级为标准权限;文档列出了读取图板和 Pin 的能力,但未说明可搜索公开内容。
来源:Pinterest 官方开发者文档,核对于 2026-10-17。