Pinterest Profiles API

Pinterest Profiles

主要特性

• 公开主页 URL 范围可处理一个或多个受支持的 Pinterest 主页 URL，并排除 Pin 链接、短链、搜索页和其他非主页路径。
• 主页身份与展示信息在一条标准化记录中返回主页 ID、规范 URL、username、显示名称、简介、主页图片和关联网站。
• 可见账号数量将可用粉丝数、关注数、board 数和保存数保留为独立指标，便于进行账号层面的比较。
• 采集与来源上下文返回 collected_at 以及可用国家代码、已创建 Pin 页面 URL、来源更新时间和 discovery_input，不与身份字段混合。

参数

如何使用

提交已知公开主页 URL，跟踪异步任务，再通过 cursor 分页读取标准化主页记录。

1. 准备一个或多个路径只包含单个 username 段的公开 Pinterest 主页 URL。
2. 将链接作为 urls 提交到 /v1/pinterest/profiles，并保存 task_id。
3. 轮询 /v1/tasks/{task_id}，直到处理成功或返回失败。
4. 读取 data.results.items；has_more 为 true 时，使用 next_cursor 请求下一页。

curl -X POST "https://api.socq.ai/v1/pinterest/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/example/"]}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor

最佳使用场景

• 公开主页资料补全： 根据已知主页 URL，为现有记录补充 username、显示名称、简介、主页图片、网站和国家信息。
• 账号规模比较： 比较一组选定公开主页的可见粉丝数、关注数、board 数和保存数。
• 公开主页监测： 将身份字段和可见指标与 collected_at 一同保存，比较不同采集时间的主页展示和账号信号。

使用建议

• 使用路径只包含一个 username 段的完整 HTTP 或 HTTPS Pinterest 主页 URL；pin.it、/pin/、/search/ 等保留路径会被拒绝。
• 提交前统一 URL，并优先按返回的 id 对主页去重；没有 id 时使用 url 作为稳定键。
• 将简介、图片、网站、国家代码、来源更新时间、已创建 Pin 页面 URL 和单项指标视为可选字段。
• 将 collected_at 与可见账号数量一同保存，以便把后续运行结果区分为不同时间的公开快照。
• 需要从主页获取 Pin 记录时使用 Pinterest User Pins API；此 endpoint 返回主页资料和数量，不返回 board、Pin 或受众列表。

相关 API