pinterest/
user-boards

提交 Pinterest 主页链接,列出主页下的公开 Board,返回名称、描述、封面、所有者、创建时间,以及 Pin 数、关注者数、分区数和协作者数。

Pinterest User Boards API

主页链接输入
每个主页最多 500 个 Board
Pin 数与关注者数
协作 Board 标记
每条结果 0.5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Pinterest User Boards

Pinterest Board 是用户给收藏的 Pin 建的分组,有名称、描述、封面和创建时间,还记录着 Pin 数、关注者数、分区数、协作者数,以及是否允许其他账号往里添加内容。把一个主页的 Board 摆在一起看,就能知道这个账号在哪些主题上收藏得最多、哪些合集有自己的关注者,又在哪些 Board 上开放了多人共建。

Pinterest User Boards API 主要特性

  • 一个主页的全部 Board在 urls 里放一个或多个 Pinterest 主页链接,这些主页上的每个 Board 各返回一行,带有 Board 自己的 id 和 url。
  • Board 的体量与关注度metrics.pins_count 表示 Board 里存了多少 Pin,metrics.followers_count 表示有多少人关注它,借此能分清哪些只是囤得多、哪些真正有人看。
  • 协作 Board 与分区is_collaborative 标出允许其他账号添加 Pin 的 Board,metrics.collaborators_count 给出协作者人数,metrics.sections_count 说明 Board 分成了几个分区。
  • 名称、描述、封面和创建时间name、text 和 cover_url 让人一眼看出 Board 的主题,published_at 记录 Board 的创建时间,也就是这个主题从什么时候开始出现在账号里。
  • 每个主页最多 500 个 Boardresults_limit 按每个主页分别计算,默认 25,最高 500,维护着几百个 Board 的账号也能完整列出。

Pinterest User Boards API 参数

参数必填描述
urls必填Pinterest 主页链接,路径里只有用户名一段,例如 https://www.pinterest.com/marthastewart/;pinterest.co.uk、de.pinterest.com 这类国家或地区域名同样可用。
results_limit可选每个主页最多返回的 Board 数,取 1 到 500 之间的整数,默认 25。

如何使用 Pinterest User Boards API

提交主页链接,等任务完成后按页读取,每个 Board 一行。

  1. 把主页链接和可选的 results_limit 发送到 POST /v1/pinterest/user-boards,记下返回的 task_id。
  2. 每隔几秒调用 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
  3. 从 results.items 读取 Board;has_more 为 true 时,用 results.next_cursor 请求下一页。
curl -X POST "https://api.socq.ai/v1/pinterest/user-boards" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/marthastewart/"],"results_limit":25}'

# Each board returned costs 0.5 credits.

Pinterest User Boards API 最佳使用场景

  • 盘点竞品的 Pinterest 主题布局: 把 Board 的 name、text 和 pins_count 对照着看,就知道一个品牌持续往哪些主题里存内容,再结合 followers_count 判断哪些合集真的有人关注。
  • 按细分领域筛选创作者: 采集候选创作者的 Board,用名称和描述去匹配你的领域,留下在多个 Board 里都围绕这个主题收藏的账号。
  • 挑选值得加入的群组 Board: 筛出 is_collaborative 为 true 的行,对比 collaborators_count 和 followers_count,找到既开放共建又有关注者的共享 Board。
  • 跟踪哪些合集在增长: 定期重新采集同一批主页,按 Board 的 id 对比 pins_count 和 followers_count,看出哪些 Board 的 Pin 或关注者在增加。

Pinterest User Boards API 使用建议

  • 提交前把 Board 链接或 Pin 链接截回主页根路径,urls 只接受 https://www.pinterest.com/{username}/ 这种形式;Board 链接请交给 Pinterest Board Pins API。
  • 主页的 Board 多于 25 个时,把 results_limit 调高到默认值以上;上限按每个主页计算,只对实际返回的 Board 计费。
  • 一个任务里提交了多个主页时,按 author.username 分组,每个 Board 都带着所属账号的信息。
  • 要取 Board 里的 Pin,就把它的 url 交给 Pinterest Board Pins API,并参考 metrics.pins_count 设置那边的 results_limit。

除了 Pinterest User Boards API,需要其他类型的 Pinterest 公开数据时,可以使用以下 API。

  • Pinterest Pins API — 从公开 Pin URL 获取标准化内容、创作者、媒体、分类、时间和可见指标。
  • Pinterest User Pins API — 通过主页 URL 和每个主页的结果上限发现公开 Pin,返回标准化内容、创作者、媒体、时间和可见指标。
  • Pinterest Profiles API — 通过主页 URL 获取公开身份、简介、图片、网站、可见账号数量和采集上下文。
  • Pinterest Search API — 通过文本 query 和结果上限搜索公开 Pin,返回标准化内容、创作者、媒体、分类、时间和可见指标。
  • Pinterest Board Pins API — 通过 Board URL 按展示顺序采集 Board 中的 Pin,返回 Pin 文字、保存它的账号、原尺寸图片和 Pin 链接。
  • Pinterest Topic API — 通过灵感页 URL 获取 Pinterest 话题的月搜索量、更新时间和推荐的细分话题。

探索其他平台

还可以将 Pinterest 数据与其他已支持社交平台的公开数据结合使用。

Pinterest User Boards API — 常见问题

Pinterest User Boards API 是一个用于根据主页链接列出公开 Pinterest 主页上全部 Board 的 API。它返回每个 Board 的名称、描述、封面、所有者、创建时间、是否为协作 Board,以及 Pin 数、关注者数、分区数和协作者数。

把账号的主页链接放进 urls,并把 results_limit 设为不少于它的 Board 数,最高 500。每个 Board 单独返回一行,包含名称、url 和各项计数。

每一行描述的是 Board 本身,其中 metrics.pins_count 是它包含的 Pin 数。要读取具体的 Pin,把 Board 的 url 提交给 Pinterest Board Pins API。

协作 Board 也常被叫作群组 Board,除所有者外,其他账号也能往里添加 Pin。这类 Board 的 is_collaborative 为 true,metrics.collaborators_count 给出协作者人数。

每个 Board 计 0.5 积分,按默认上限 25 提交 3 个主页,最多计 37.5 积分。主页的 Board 少于上限时,只按实际返回的数量计费。