按数字用户 ID 获取 Pinterest 公开粉丝列表
查看 Pinterest 用户资料、粉丝与 Pin 数据 的全部接口 →获取关注指定 Pinterest 账号的公开粉丝记录,结果仅代表有限范围的快照。首次查询时,在 userid 中传入以字符串表示的 Pinterest 数字用户 ID,不能用用户名代替。接口定义中的各查询参数均为可选,但文档所述的起始请求需要提供 userid。如需继续获取记录,只能使用响应实际提供的 node_id 和 cursor,并省略 userid 及其默认值,因为 userid 的优先级更高。不要自行构造续页参数;缺少可用的参数组合或令牌重复时应停止。已记录的一次成功实测返回了 message: null、data.request_id 和十条 data.followers[] 记录。每条记录的 node 包含 username、fullName、entityId 和 id,记录级 cursor 均为 null。请将标识符保留为字符串。实测未获得可用的续页信息,因此这些记录不能证明已导出全部粉丝。文档示例还展示了 node.__typename、imageMediumUrl、imageXlargeUrl、isPrivateProfile 和 status,但这些额外字段仅供说明,并非实测保证会返回的字段。文档中的错误示例包括:HTTP 400 的 detail 和 headers.Error;HTTP 422 的 detail[] 数组,其中包含 loc、msg 和 type;HTTP 500 的 data.followers、request_id 和 status。这些错误结构未在已记录的成功实测中出现。本接口列出的是关注目标账号的人,而非目标账号关注的人,也不提供私有受众分析数据。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/pinterest-scraper/list-user-followers API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/pinterest-scraper/list-user-followers?key=<API_KEY>&userid=125186202050495625'
查询结果
使用场景
- 根据返回的节点 ID 和用户名建立带时间戳的粉丝关系表,保留字符串标识符,并明确标注覆盖范围不完整。
- 为尊重用户同意边界的人工受众研究生成有限规模的粉丝 CSV,不将所列账号宣称为全部受众。
- 实现粉丝续页诊断:缺少节点与游标信息或令牌重复时立即停止,而不是自行构造下一页参数。
- 对比已保存的粉丝快照,记录本次新增或不再出现的账号,同时说明覆盖不完整时无法据此确认取消关注。
常见问题
userid 应填写 Pinterest 用户名还是数字 ID?
首次请求粉丝列表时,应使用字符串形式的 Pinterest 数字用户 ID,成功实测采用的也是这种格式。请先查询并确认目标账号的资料,再取得其 ID,不要直接填入用户名。
如何获取下一页粉丝?
只有响应提供可用的 node_id 和 cursor 时才能继续。提交这两个值时,应省略 userid 及其默认值,因为 userid 的优先级更高。缺少续页信息或令牌重复时应停止;现有实测并未验证分页可正常工作。
请求成功就表示返回了全部粉丝吗?
不能保证完整性。已记录的成功响应包含十条粉丝记录,游标均为 null,也没有可用的续页信息。应将结果标注为有限范围的快照,而非完整导出。
哪些粉丝字段经过了实际验证?
实测记录确认了 message: null、data.request_id、data.followers[],以及 node 中的 username、fullName、entityId 和 id,记录级游标为 null。图片 URL、隐私标记和 status 虽出现在文档示例中,但未由该实测记录单独验证。
粉丝列表和关注列表是同一种关系吗?
不是。粉丝列表列出关注目标账号的其他账号;关注列表则列出目标账号主动关注的账号,两者使用不同的接口和输入格式。