Pinterest Profiles
Pinterest 主页是包含 username、显示名称、简介、主页图片、关联网站以及可见粉丝数、关注数、board 数和保存数的公开账号页面。这些身份字段和账号信号可用于补全主页资料、比较公开账号和按时间监测变化。
主要特性
- 公开主页 URL 范围可处理一个或多个受支持的 Pinterest 主页 URL，并排除 Pin 链接、短链、搜索页和其他非主页路径。
- 主页身份与展示信息在一条标准化记录中返回主页 ID、规范 URL、username、显示名称、简介、主页图片和关联网站。
- 可见账号数量将可用粉丝数、关注数、board 数和保存数保留为独立指标，便于进行账号层面的比较。
- 采集与来源上下文返回 collected_at 以及可用国家代码、已创建 Pin 页面 URL、来源更新时间和 discovery_input，不与身份字段混合。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的公开 Pinterest 主页 URL 列表。每个 URL 必须使用 Pinterest 域名下的 HTTP 或 HTTPS 地址，并且路径只包含一个非保留 username 段。 |
如何使用
提交已知公开主页 URL，跟踪异步任务，再通过 cursor 分页读取标准化主页记录。
- 准备一个或多个路径只包含单个 username 段的公开 Pinterest 主页 URL。
- 将链接作为 urls 提交到 /v1/pinterest/profiles，并保存 task_id。
- 轮询 /v1/tasks/{task_id}，直到处理成功或返回失败。
- 读取 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
需要其他类型的 Pinterest 公开数据时，可以使用以下 API。
- Pinterest Pins API — 从公开 Pin URL 获取标准化内容、创作者、媒体、分类、时间和可见指标。
- Pinterest User Pins API — 通过主页 URL 和每个主页的结果上限发现公开 Pin，返回标准化内容、创作者、媒体、时间和可见指标。
- Pinterest Search API — 通过文本 query 和结果上限搜索公开 Pin，返回标准化内容、创作者、媒体、分类、时间和可见指标。