Pinterest 公开数据 API
获取公开 Pinterest 账号数据、解析指定 Pin、采集选定账号的 Pin，或按关键词搜索，用于创作者、内容和视觉趋势研究。
可用的 Pinterest API
账号数据使用 Profiles，指定 Pin 使用 Pins，选定账号的内容使用 User Pins，按关键词发现 Pin 使用 Search。
可以获取哪些 Pinterest 数据？
SocQ 返回标准化公开账号和 Pin 记录，并保留身份、内容、媒体、分类、发现来源、互动和采集时间信息。
公开账号资料
获取账号 ID、username、显示名称、简介、图片、关联网站、国家信息和可见账号数量。
Pin 内容与媒体
获取可用的 Pin 身份、标题、正文、创作者信息、媒体引用、发布时间和可见指标。
创作者 Pin 集合
从选定账号主页获取限定数量的公开 Pin，并将每条结果与输入账号关联。
话题与内容分类
按关键词搜索 Pin，并保留可用的帖子类型、分类、标签、来源信息和搜索词。
SocQ 与 Pinterest API 对比
SocQ 专注于受支持的公开 Pinterest 数据采集；Pinterest 官方 API 面向已授权的内容、广告、分析和商品目录集成。
| 能力 | SocQ | Pinterest API |
|---|---|---|
| 主要用途 | 采集公开主页、Pin、用户 Pin 和搜索结果 | 管理已授权的内容、广告、分析和商品目录 |
| 客户 OAuth | 使用 SocQ API key，无需客户 Pinterest OAuth | 需要 Pinterest app、access token 和相应 scope |
| 起始输入 | 公开主页或 Pin URL，也可使用文本 query | 已授权账号上下文和 Pinterest 资源 ID |
| 创建或管理 Pin | 不支持 | 通过已验证用户身份并具备 write scope 时支持 |
| 返回格式 | 标准化 SocQ 记录 | Pinterest API 原生对象 |
Pinterest API 如何工作
四个 Pinterest API 使用相同的异步任务和结果分页流程。
1. 提交输入
将账号主页 URL、Pin URL 或搜索词提交到对应 API，并保存返回的 task_id。
2. 跟踪任务
轮询 /v1/tasks/{task_id}，直到任务处理完成。
3. 获取结果
读取 data.results.items；has_more 为 true 时继续使用 next_cursor。
使用 SocQ API key 鉴权并提交文本 query。Profiles、Pins 和 User Pins 使用相同的任务流程。
curl -X POST "https://api.socq.ai/v1/pinterest/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"home office ideas","results_limit":100}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor常见 Pinterest API 使用场景
创作者与账号研究
通过已知账号主页补充公开身份、简介、网站、国家信息、可见数量和采集时间。
指定 Pin 分析
将选定 Pin URL 解析为内容、创作者、媒体、分类、时间、可见指标和来源链接。
创作者内容监测
从选定账号获取限定数量的 Pin，并比较不同采集时间的内容与账号快照。
视觉话题与趋势研究
搜索指定关键词，构建包含创作者、媒体、分类和发现来源的结构化 Pin 数据集。
限制与公开数据政策
Pinterest 结果是采集时的公开记录。这些 API 不访问私密内容，也不创建、修改、保存或管理账号和 Pin。
- Profiles 要求路径只包含一个 username 段的账号主页 URL，返回账号资料，不返回图板（board）、Pin 或受众成员列表。
- Pins 要求已知公开 /pin/{id} URL 或 pin.it 链接，不会把账号主页扩展为 Pin 集合。
- User Pins 要求公开账号主页 URL；results_limit 默认为 100，可设置为 1 到 2,000，并分别应用于每个账号。
- Search 要求一个文本关键词；results_limit 默认为 100，可设置为 1 到 2,000，不提供排序或其它筛选。
- 公开来源未提供时，身份、内容、媒体、分类、来源、时间和指标等选填字段可能为 null 或空值。
- 这些 API 只读，不创建、修改、保存或管理 Pinterest 账号、图板（board）或 Pin。
Pinterest API 常见问题
Pinterest API 是什么？
Pinterest API 是 SocQ 提供的一组 API，用于获取公开账号数据、解析指定 Pin、采集选定账号的 Pin，以及按关键词搜索公开 Pin。
应该使用哪个 Pinterest API？
账号资料使用 Profiles，指定 /pin/{id} 或 pin.it 链接使用 Pins，账号 Pin 集合使用 User Pins，关键词发现使用 Search。
Profiles 和 User Pins 返回相同数据吗？
不相同。Profiles 返回账号资料和汇总数量，User Pins 返回通过提交的主页 URL 发现的标准化 Pin 记录。
User Pins 的结果上限如何生效？
results_limit 默认值为 100，可设置为 1 到 2,000，并分别应用于每个主页 URL。
为什么字段可能为 null 或空值？
公开主页或 Pin 在采集时可能没有提供每一项身份、内容、媒体、分类、来源、时间或指标值。
Pinterest 数据采集如何计费？
每条返回主页记录或 Search Pin 消耗 0.6 积分，Pins 或 User Pins 的每条返回 Pin 记录消耗 0.5 积分。结果集为空时不收取结果费用。