Pinterest 公开数据 API | SandBase
用一个 REST API 读取 Pinterest 公开的搜索结果、board 和 pin。无需 Pinterest 登录、无需 SDK——一个 SandBase 密钥,为 Agent 工作流而生。

Pinterest 是一台视觉发现引擎——人们在这里筹划家装、穿搭、食谱和旅行。这让它成为趋势研究、电商灵感和创意规划的丰富信号。可要用程序去拿这些数据,通常意味着跟无头浏览器较劲,而且站点一变你就得重写采集器。
SandBase 的 Pinterest 公开数据 API 把这些前置成本换成了普通 REST。它通过简单端点读取 Pinterest 公开的搜索结果、用户 board 和 board 上的 pin——一个 SandBase API 密钥,不需要登录 Pinterest、也不需要 SDK。端点参考定义当前参数与响应契约。原来 2026-09-27 UTC 的观察保留为有日期的历史证据;当前 search、board 接入说明则依据下文单独记录的参考核对。
这不是 Pinterest 官方 API。 当你需要经过授权的会员操作,或需要有正式授权协议的数据时,请走 Pinterest 官方开发者平台。当你的工作流需要用于研究和监测的公开、只读数据时,用 SandBase。想上手?获取 SandBase API 密钥,然后浏览 Pinterest 端点。
先说结论
- 一套 API 即可读取 Pinterest 公开的搜索结果、用户 board 和 board 上的 pin。
- 每个端点都是
POST /v1/api/pinterest/<path>——只传该端点的参数,无 SDK,一个SANDBASE_API_KEY。- 端点以自然输入为入口:搜索用
query,用户 board 用handle,board 或 pin 用url。- 只返回公开、只读数据。无需发帖、无需平台登录、不涉及私有数据;用 SandBase API 密钥鉴权即可。
当前契约与历史证据
2026-11-08 本次更新核对了 pinterest/search、pinterest/board 的当前 schema 和公开样本,没有执行付费业务请求。当前应检查 status: "completed",读取文档化的 outputs[0].data 对象并验证 pins 数组,不回退到顶层 output,也不把数据缺失变成空结果。能力地图里的其他端点不在本次复验范围。
下方 2026-09-27 UTC 的观察保留为历史。旧顶层 output 样本不再是接入规范。Pinterest 视觉研究教程提供带检查的单次 Python 示例,以及已有 Key、已连接 agent 和新项目的接入路径。
你需要哪种 Pinterest API?
| 你的需求 | 选择 | 原因 |
|---|---|---|
| 发帖、保存 pin,或以会员身份操作 | Pinterest 官方平台 | 会员和账号级操作应通过 Pinterest 直接进行。 |
| 读取公开的搜索、board 或 pin | SandBase Pinterest 公开数据 API | 普通 REST、一个 SandBase 密钥、结构化 JSON,面向只读工作流。 |
| 私有或仅账号可见的数据 | 两种公开方案都不适用 | 这类数据不在本篇公开数据指南范围内。 |
Pinterest API 能取到什么
按用途分组:
- 搜索 — 关键词搜索,返回公开 pin。
- 用户 board — 给定
handle的公开 board。 - Board — 一个 board 上的 pin,用它的
url定位。 - Pin — 单条 pin 的数据,用它的
url定位。
动手前请以每个端点的线上 API 参考为准核对参数;可用性因端点而异。
历史目录截图,2026-09-27:端点路径和当时搜索的“From $0.012”标价,不是本次检查到的 $0.018 价格。
Pinterest 提供什么,SandBase 补什么
公开数据来自 Pinterest。SandBase 并不拥有或运营 Pinterest,它为符合条件的公开数据工作流提供一层统一的 API。每个能力都成为一个稳定端点,鉴权收敛为单个密钥,响应回来是可预测的 JSON——于是 Agent 可以沿着”从关键词到一组 pin”、或”从 handle 到它的 board”这样一条约定链式走,而不用维护采集器。
快速上手:只搜一次
使用 Model API 的 POST 路径,不替换成目录 GET 路径。本地配置 SANDBASE_API_KEY,选定一个关键词。这条请求省略 cursor,显式选择 trim: true;schema 没有声明这两个可选字段的默认值。
curl --fail-with-body --connect-timeout 10 --max-time 90 \
-X POST https://api.sandbase.ai/v1/api/pinterest/search \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "home office setup", "trim": true}'命令只打印返回,不会检查业务是否完成。使用结果前必须确认 status: "completed",并验证 outputs[0].data 对象内的 pins 数组,或直接使用教程中已加检查的 Python helper。当前搜索公开样本没有 success,不要强制要求它出现;但如果返回这个字段,就必须是布尔值 true。即使 pins 为空数组,也应拒绝显式 false 或类型不对的值。列表缺失应报错,不能据此断言搜索没有匹配内容。
当前免费 inspect 显示,search 和 board 都是 $0.018/次,均无 free_quota 项,不能套用其他 API 的免费资格。本次没执行这两个业务端点。参考载荷中的上游 credit 计数不是读者自己的 SandBase 余额,也不是本次美元扣费。
历史搜索记录:2026-09-27
run bb49ff54-271a-403b-82c7-ca510922c580 原本保留了下面的裁剪示意。省略号、占位 URL 和 title: {} 都原样保留作追溯,不能当成有效 cursor、当前标题类型或新验证的响应。原 Python 代码已经归档,不再作为当前推荐。
{
"id": "bb49ff54-271a-403b-82c7-ca510922c580",
"model": "pinterest/search",
"status": "completed",
"output": {
"success": true,
"pins": [ { "id": "…", "title": {}, "url": "https://www.pinterest.com/pin/…" } ],
"cursor": "…"
}
}
历史搜索参考截图,2026-09-27。当前 search、board 契约已在 2026-11-08 单独核对。
能力地图
| 能力 | 端点 | 输入 | 典型用途 |
|---|---|---|---|
| 搜索 | pinterest/search | query | 关键词 pin 发现 |
| 用户 board | pinterest/user-boards | handle | 某用户的公开 board |
| Board | pinterest/board | url | 一个 board 上的 pin |
| Pin | pinterest/pin | url | 单条 pin 的数据 |
search 和 board 的当前 schema 都声明了可选字符串 cursor,但本次没有测试分页。实现前先检查完整响应并设定请求上限,不能使用参考里的占位符或截断 token。
历史 User Boards 参考页,2026-09-27:handle 与 trim 输入。此图用于保留原能力地图,该端点的当前行为不在本次复验范围。
串联之前先选任务
关键词和已选定的 board 是两个独立输入。前者用搜索,后者直接读 board;新版教程每次只执行所选的一条请求。先列用户 board 再逐一打开,可能把调用量扩大到预期之外。追加端点前先检查当前契约并约定预算,共用鉴权不代表所有业务字段都相同。
常见用法
寻找主题方向
用搜索第一页收集候选视觉方向,再人工评估。保存样本时记录关键词和日期,返回一页不能证明全站趋势或热门排名。
阅读已知 board 的参考资料
给出完整公开 board URL,读取首次返回。参考示例为 https://www.pinterest.com/pinterest/official-news/。先检查元数据,再决定是否需要下一页或具体图片;JSON 返回不等于自动下载图片或获得素材使用权。
其他 Pinterest 任务
能力地图保留了原文的用户 board 发现与 pin 详情。这些仍是需要先检查的独立任务,本次没有确认它们的当前参数、价格和业务响应。
局限与边界
- 公开读取。 本文用于公开研究,不负责发帖、保存 pin 或访问私有 board。
- 当前信封。 只读
outputs[0].data,状态未完成、数据缺失或格式错误都应明确失败,不能静默返回空数组。 - 一页只是样本。 不假设覆盖完整,也不自动重试、翻页或下载全部图片。先检查完整响应,再约定后续任务。
- 元数据不统一。 可选标题、图片结构和计数可能不同;缺失就保留未知,不补值做排名。
- 产品边界独立。 SandBase 提供 API 层,本文不宣称 Pinterest 官方合作或返回素材的转载授权。
常见问题
我需要 Pinterest 开发者应用或登录吗?
不需要。你用自己的 SANDBASE_API_KEY 向 SandBase 鉴权。这些读取端点不需要你这边有 Pinterest 账号或 OAuth。
为什么历史样本用 output?
它记录的是 2026-09-27 的观察。当前示例只使用 outputs[0].data,旧结构保留作历史,不是兼容建议。
什么标识一次搜索、某用户的 board、一个 board 或一条 pin?
query 驱动搜索,handle 驱动 user-boards,url 定位一个 board 或一条 pin。
我能读私有或仅账号可见的数据吗? 不能。这套 API 只返回公开数据。私有和账号授权内容不在范围内。
从一次搜索开始
复用已有 SandBase 连接,选择搜索或已知 board,先看一份结果再扩展。视觉研究教程提供输入、超时、响应检查与接入说明。准备好后:
觉得有用?分享给更多人