pinterest/
topic

根据灵感页链接查询 Pinterest 话题,返回话题名称、Pinterest 公布的月搜索量、最近更新时间和推荐的细分话题,每个话题一行。

Pinterest Topic API

灵感页链接输入
月搜索量
带链接的细分话题
每条结果 0.5 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

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

提交灵感页链接,每个话题返回一行。

  1. 从 Pinterest 复制灵感页链接,放进 urls 发送到 /v1/pinterest/topic。
  2. 轮询 GET /v1/tasks/{task_id},等 status 变成 succeeded。
  3. 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 一起看,每个数字都对应该话题自己最近一次刷新的时间。

除了 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 链接。

探索其他平台

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

Pinterest Topic API — 常见问题

Pinterest Topic API 是一个用于根据灵感页链接读取 Pinterest 话题数据的 API。它返回每个话题的名称、Pinterest 公布的月搜索量、该数字最近的更新时间,以及推荐的细分话题。

它返回 Pinterest 公布的当前月搜索量和对应的更新时间。按固定周期采集同一批话题,就能自己积累历史数据并画出走势。

灵感页位于 pinterest.com/ideas/ 下,结尾带数字 id,例如 /ideas/home-decor/935249274030/。每行结果里的 related_topics[].url 也已经是可直接提交的格式。

name 是完整的话题名,例如 Christmas Home Decor;label 是 Pinterest 给它显示的简短标签,例如 Christmas。

每返回一个话题计 0.5 积分,查询 10 个灵感页计 5 积分。