获取账号当前可返回的公开 Pin
查看 Pinterest 用户资料、粉丝与 Pin 数据 的全部接口 →通过必填的字符串查询参数 username,获取指定账号当前可返回的公开 Pin 记录。参数文档允许填写 Pinterest 用户名或账号 ID,但已记录的实测仅验证了用户名。默认值 example_user 仅作示例,请替换为目标账号。此接口不提供分页参数。 已观察到的响应:对 marthastewart 的成功请求返回 HTTP 200,包含值为 ok 的 status、request_id、值为 null 的 message,以及含 25 条记录的 data.pins。实测确认了 Pin ID、公开画板链接、账号的 pinner 身份信息、图片和外部链接。这只能证明当次返回了这组记录,不代表固定分页大小或完整账号导出。 文档还列出了以下字段,但实测摘要未逐项确认:每条 Pin 可能包含 id、title、description、description_html、alt_text、created_at、domain、link、seo_title 和 seo_url;board 包含 id 和 name,pinner 包含 id 和 username,images 可能按尺寸提供条目,例如 images["236x"].url。文档示例还包含 comment_count、repin_count、reaction_counts.like、comments、grid_title、grid_description、dominant_color,以及 is_video、is_repin、is_promoted、privacy 等标记。请将这些示例字段视为可选字段,而非保证完整出现的记录结构;将 ID 保留为字符串,并兼容文字、图片或链接缺失的情况。计数字段即使存在,也只是记录属性,不代表互动历史。 文档另有 HTTP 400 示例,包含 detail 字符串;HTTP 422 示例的 detail 条目包含 loc、msg 和 type;HTTP 500 示例包含 status、request_id 和 data.pins。这些错误示例未经实测确认,不应当作已发生的错误或保证一致的错误格式。 请保留返回的来源链接用于标注出处,并在判断作者身份前核对 pinner 信息。账号集合可能包含收藏的内容;内容出现在集合中,或能访问媒体链接,都不代表拥有该内容或获得了使用授权。此路由不提供分页,也不支持私密画板、受限 Pin 或已删除内容,因此不能将当前可返回的集合描述为该账号相关的全部 Pin。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/pinterest-scraper/list-user-pins API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/pinterest-scraper/list-user-pins?key=<API_KEY>&username=example_user'
查询结果
使用场景
- 使用所选账号当前返回的 Pin ID、图片链接和来源链接制作内容审阅表,并单独记录内容使用权审核结果。
- 根据返回的 Pin 链接整理外链域名清单,研究账号当前可见内容将读者或购物者引向哪些网站。
- 保存带采集时间且按 ID 去重的 Pin 快照,标记首次观察到的记录,但不把某条 ID 的缺失视为内容已删除的证据。
- 将每条记录的 pinner 信息与目标账号进行比较,确认内容与账号的关联,避免在缺乏依据时直接认定账号为原创作者。
常见问题
调用 /pins 应该填写用户名还是数字用户 ID?
必填查询参数名为 username。文档提到可使用用户名或账号 ID,但已记录的实测仅验证了用户名。能够获得目标账号用户名时,建议优先使用;数字 ID 输入的行为尚未确认。请将示例默认值 example_user 替换为目标账号。
此接口会返回全部 Pin,或者允许请求下一页吗?
文档没有提供分页参数。成功实测返回了 25 条 Pin,但这既不代表保证固定返回 25 条,也不代表覆盖完整历史。请将结果视为当前可返回的公开集合,而非全量导出。
实测具体确认了哪些 Pin 响应内容?
已记录的 HTTP 200 响应包含 status、request_id、值为 null 的 message 和 data.pins。其 25 条记录包含 Pin ID、公开画板链接、pinner 身份信息、图片及外部链接。文字、计数、内容标记等其他文档字段未在实测摘要中逐项确认,应按可选字段处理。
图片链接和 pinner 信息能证明媒体所有权吗?
不能。公开集合可能包含收藏的内容,pinner 身份信息或图片链接都不代表拥有内容或获得了使用授权。再次使用前,请保留来源链接,并单独核实署名和使用权。
如何保存 Pin ID 并比较多次请求结果?
将 Pin ID 保留为字符串,记录每次快照的采集时间,并按 ID 去重。首次出现的 ID 可用于内容变化审阅,但后续局部集合中缺少某个 ID,并不能证明该 Pin 已删除。