Pinterest Topic
Pinterest 话题是把同一主题的 Pin 聚在一起的灵感页,比如家居装饰,页面上标着 Pinterest 公布的月搜索量、这个数字的更新时间,以及圣诞、二手淘货这类更细的分支话题。搜索量反映一个主题在 Pinterest 上有多少需求,细分话题则指出人们常把它和哪些风格、场景、材质搭配,这正是做关键词调研和内容规划的基础。
Pinterest Topic API 主要特性
- 每个话题的月搜索量search_count 是 Pinterest 公布的该话题每月搜索次数,直接说明有多少人在找它。
- 细分话题自带链接related_topics 列出 Pinterest 推荐的下级话题,每项都有完整名称、DIY 这样的简短标签和灵感页 url。
- 搜索量的更新时间updated_at 记录 Pinterest 最近一次刷新该话题的时间,用来判断搜索量有多新。
- 一次提交多个话题urls 可以同时放多个灵感页,每个只返回一行,以页面地址里的话题 id 作为标识。
Pinterest Topic API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | Pinterest 灵感页链接,路径格式为 /ideas/{topic}/{id}/,需带上数字 id,例如 https://www.pinterest.com/ideas/home-decor/935249274030/。 |
如何使用 Pinterest Topic API
提交灵感页链接,每个话题返回一行。
- 从 Pinterest 复制灵感页链接,放进 urls 发送到 /v1/pinterest/topic。
- 轮询 GET /v1/tasks/{task_id},等 status 变成 succeeded。
- results.items 里每一项是一个话题;has_more 为 true 时,用 results.next_cursor 取剩下的部分。
curl -X POST "https://api.socq.ai/v1/pinterest/topic" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/ideas/home-decor/935249274030/"]}'
# One row and 0.5 credits per topic.Pinterest Topic API 最佳使用场景
- 按需求给选题排序: 采集一批候选话题的 search_count,先做搜索最多的主题,再去规划 Pin 和 Board。
- 在大主题里找长尾切入点: 查看 related_topics 的标签,比如家居装饰下的 Christmas、Thrifted、Earthy Cottage,挑一个受众明确的细分方向。
- 积累自己的 Pinterest 需求走势: 每月采集同一批话题,把 search_count 和 updated_at 一起存下来,就能画出各主题热度随时间的变化。
Pinterest Topic API 使用建议
- 每个链接都要保留数字 id:/ideas/home-decor/935249274030/ 可以通过,只写到话题名就结束的地址会校验失败。
- 想逐层展开一个领域,就把 related_topics[].url 作为下一批输入提交,并跳过已经采过的话题 id,因为不同分支经常绕回同一个灵感页。
- 比较不同话题的 search_count 时要连同 updated_at 一起看,每个数字都对应该话题自己最近一次刷新的时间。
相关 API
除了 Pinterest Topic 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 Board Pins API — 通过 Board URL 按展示顺序采集 Board 中的 Pin,返回 Pin 文字、保存它的账号、原尺寸图片和 Pin 链接。