按 Pinterest 用户名获取其关注的账号列表
查看 Pinterest 用户资料、粉丝与 Pin 数据 的全部接口 →获取指定 Pinterest 账号公开可见的关注对象。在名为 userid 的查询参数中填写目标账号的用户名。虽然参数名称相同，本接口接收的是用户名，而非粉丝接口使用的数字 userid。参数定义中 userid 仍为可选项，但文档所述的首页查询流程需要提供用户名。首次请求应省略 bookmark。如果响应返回 data.bookmark，请保持 userid 中的用户名不变，并将该令牌原样作为 bookmark 传入。令牌缺失或重复时应停止，并对返回的账号 ID 去重。实测观察到了续页令牌，但没有请求下一页，因此尚未验证分页流程或完整采集能力。已记录的一次成功实测返回了 message: null、data.request_id、值为 ok 的 data.status、非空的 data.bookmark，以及五十条 data.followings[] 记录。每条记录包含 node.username 和 node.id，记录级 cursor 均为 null。请将 ID 保留为字符串；文档所述的下一页输入是集合级 data.bookmark，而非这些空的记录级游标。文档示例还展示了 node.__typename、entityId、fullName、imageMediumUrl、imageXlargeUrl、isPrivateProfile、type、board_count、follower_count、pin_count、domain_verified、is_default_image、is_verified_merchant、last_pin_save_time、pin_thumbnail_urls 和 recent_pin_images。这些额外字段未经过实测验证，仅供说明，不保证返回。文档中的错误示例包括 HTTP 400 和 500 的 detail，以及 HTTP 422 的 detail[]，其中包含 loc、msg 和 type；这些错误未在成功实测中出现。关注关系表示目标账号关注了哪些账号，不是目标账号的粉丝，也不能据此认定其背书、受众重合或私下兴趣。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/pinterest-scraper/list-user-following API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/pinterest-scraper/list-user-following?key=<API_KEY>&userid=example_user'
查询结果
使用场景
- 从某个品牌或创作者公开关注的账号中筛选编辑研究候选对象，不把关注关系标记为推荐或背书。
- 构建有数量上限的关注列表采集器，保存原始用户名和返回的 bookmark，对 ID 去重，并在令牌缺失或重复时停止。
- 在关系浏览工具中展示账号向外关注的对象，并在界面上清晰区分粉丝方向与关注方向。
- 测试请求适配器，确保本接口在 userid 中发送用户名，而不是误用粉丝请求中的数字标识符。
常见问题
为什么关注列表接口的 userid 要填写用户名？
这是本接口文档规定的输入格式。请在 userid 中填写 Pinterest 用户名；成功实测使用的是 marthastewart。不要沿用粉丝接口要求的数字 userid。
如何使用 bookmark 请求下一页？
首次请求省略 bookmark。响应返回 data.bookmark 后，保持用户名不变，并原样传入该令牌；令牌缺失或重复时应停止。实测观察到了非空书签，但未验证下一页请求。
应该使用每条关注记录中的 cursor 吗？
已记录的各条记录中 cursor 均为 null。本接口文档规定的续页输入是集合级 data.bookmark，而不是记录级 cursor。
成功实测确认了哪些关注列表数据？
实测确认了 message: null、data.request_id、值为 ok 的 data.status、非空的 data.bookmark，以及五十条包含 node.username 和 node.id 的 data.followings[] 记录。其他资料指标和图片仅出现在尚未验证的文档示例中。
关注列表能证明账号背书或完整的兴趣范围吗？
不能。它仅标识返回的、目标账号公开关注的账号，不代表其粉丝、背书对象或私下兴趣。已记录的实测也未证明能够完整遍历关注对象或分析受众重合。