Pinterest Board Pins
Pinterest Board 里的 Pin 是有人围绕同一个想法收集起来的图片,每张都带着简短的标题或描述、保存它的账号,以及原始宽高的大图。按 Board 呈现的顺序把它们取出来,就是一套现成的视觉参考,可以拿来做情绪板、设计调研、图片数据集,也能用来观察一个精选合集怎样变化。
Pinterest Board Pins API 主要特性
- 保留 Board 内的排列顺序结果按 Board 自身展示的先后排列,读起来就是策展人整理时的样子。
- 原图和缩略图都有media.url 指向原尺寸图片,media.thumbnail_url 是小尺寸预览,每个文件都附带以像素计的 width 和 height。
- 谁保存的、写了什么author 是保存这个 Pin 的账号,包含用户名、显示名称、主页链接和头像;text 是 Pin 的标题或描述。
- 每个 Pin 都能找回原页url 是根据 Pin 的 id 拼出的 Pin 页面地址,素材集里任何一张图都能回到它在 Pinterest 上的位置。
- 每个 Board 最多 1000 个 Pinresults_limit 按每个 Board 计算,默认 50,最高 1000,多个 Board 可以一起放进 urls。
Pinterest Board Pins API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | Pinterest Board 链接,路径格式为 /{username}/{board}/,例如 https://www.pinterest.com/lizmrodgers/moms-night/。 |
results_limit | 可选 | 每个 Board 最多返回的 Pin 数,取 1 到 1000 之间的整数,默认 50。 |
如何使用 Pinterest Board Pins API
提交 Board 链接,等任务完成后分页读取 Pin。
- 把 Board 链接放进 urls 发送到 /v1/pinterest/board;每个 Board 需要超过 50 个 Pin 时再带上 results_limit。
- 用拿到的 task_id 轮询 GET /v1/tasks/{task_id},直到任务成功。
- 从 results.items 取出 Pin;只要 has_more 为 true,就继续用 results.next_cursor 往下读。
curl -X POST "https://api.socq.ai/v1/pinterest/board" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/lizmrodgers/moms-night/"],"results_limit":50}'
# 0.5 credits per pin; boards that do not exist return no pins.Pinterest Board Pins API 最佳使用场景
- 批量下载 Board 里的图片: 保存 Board 中每个 media.url,建立一份原图参考库,再按 width 和 height 区分竖图和横图。
- 整理带文字说明的图片数据集: 把每张图片和 Pin 的 text、所在 Board 配在一起,形成可用于设计调研或模型训练的带标注样本。
- 盯住竞品的季节性 Board: 每周采集同一个 Board,把 Pin 的 id 和上一次对比,就能准确看到新加了哪些内容。
- 给情绪板里的素材标注来源: 在每张图旁边保留 author.username 和 Pin 的 url,演示稿里的每张图片都能注明出处、随时打开原页。
Pinterest Board Pins API 使用建议
- 请使用 Board 本身的两段式链接;/{username}/_saved/、/{username}/pins/ 这类主页标签页、更深一层的分区路径和 pin.it 短链都会被拒绝,打开 Board 后复制地址栏即可。
- 先用 Pinterest User Boards API 查看 Board 的 metrics.pins_count,再据此设置 results_limit,大 Board 就不会停在默认的 50 个。
- 做网格或预览时加载 thumbnail_url,只对决定保留的图片下载 media.url,几百个 Pin 的 Board 能省下不少流量。
相关 API
除了 Pinterest Board Pins API,需要其他类型的 Pinterest 公开数据时,可以使用以下 API。
- Pinterest Pins API — 从公开 Pin URL 获取标准化内容、创作者、媒体、分类、时间和可见指标。
- Pinterest User Pins API — 通过主页 URL 和每个主页的结果上限发现公开 Pin,返回标准化内容、创作者、媒体、时间和可见指标。
- Pinterest Profiles API — 通过主页 URL 获取公开身份、简介、图片、网站、可见账号数量和采集上下文。
- Pinterest Search API — 通过文本 query 和结果上限搜索公开 Pin,返回标准化内容、创作者、媒体、分类、时间和可见指标。
- Pinterest User Boards API — 通过主页 URL 列出 Pinterest 主页上的 Board,返回名称、描述、封面、创建时间以及 Pin 数、关注者数、分区数和协作者数。
- Pinterest Topic API — 通过灵感页 URL 获取 Pinterest 话题的月搜索量、更新时间和推荐的细分话题。