Pinterest 公开数据 API | SandBase

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

深色电影质感画面:Pinterest 搜索 pin、board 与一张 pin 卡片经由同一条 API 管道汇入 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 或 pinSandBase Pinterest 公开数据 API普通 REST、一个 SandBase 密钥、结构化 JSON,面向只读工作流。
私有或仅账号可见的数据两种公开方案都不适用这类数据不在本篇公开数据指南范围内。

Pinterest API 能取到什么

按用途分组:

  • 搜索 — 关键词搜索,返回公开 pin。
  • 用户 board — 给定 handle 的公开 board。
  • Board — 一个 board 上的 pin,用它的 url 定位。
  • Pin — 单条 pin 的数据,用它的 url 定位。

动手前请以每个端点的线上 API 参考为准核对参数;可用性因端点而异。

SandBase Pinterest 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 没有声明这两个可选字段的默认值。

Shell
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 代码已经归档,不再作为当前推荐。

JSON
{
  "id": "bb49ff54-271a-403b-82c7-ca510922c580",
  "model": "pinterest/search",
  "status": "completed",
  "output": {
    "success": true,
    "pins": [ { "id": "…", "title": {}, "url": "https://www.pinterest.com/pin/…" } ],
    "cursor": "…"
  }
}

某个 Pinterest 端点的 SandBase API 参考,展示带厂商前缀的 URL 和响应结构 历史搜索参考截图,2026-09-27。当前 search、board 契约已在 2026-11-08 单独核对。

能力地图

能力端点输入典型用途
搜索pinterest/searchquery关键词 pin 发现
用户 boardpinterest/user-boardshandle某用户的公开 board
Boardpinterest/boardurl一个 board 上的 pin
Pinpinterest/pinurl单条 pin 的数据

search 和 board 的当前 schema 都声明了可选字符串 cursor,但本次没有测试分页。实现前先检查完整响应并设定请求上限,不能使用参考里的占位符或截断 token。

历史 SandBase Pinterest User Boards API 参考,展示 handle 和 trim 请求字段 历史 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,先看一份结果再扩展。视觉研究教程提供输入、超时、响应检查与接入说明。准备好后:

觉得有用?分享给更多人