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 一行。
- 把主页链接和可选的 results_limit 发送到 POST /v1/pinterest/user-boards,记下返回的 task_id。
- 每隔几秒调用 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
- 从 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。
相关 API
除了 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 话题的月搜索量、更新时间和推荐的细分话题。