获取账号当前可返回的公开 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 功能

按账号获取公开 Pin 集合 通过必填的 username 查询参数选择账号,获取当前可返回的 Pin;已记录的用户名实测请求返回了 25 条 Pin 记录。
保留内容审阅所需的来源链接 实测确认的 Pin ID、公开画板链接、图片和外部链接可用于整理内容审阅表,并保持记录与原始内容之间的对应关系。
依据 pinner 信息核对内容归属 判断作者身份前先比较返回的 pinner 信息,因为收藏的 Pin 和媒体链接都不足以证明每条内容由所选账号创作。
建立边界清晰的局部内容快照 为多次采集记录时间并按 Pin ID 去重,同时明确结果只是局部快照;文档没有提供页码或游标参数。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

调用 /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 已删除。

相关接口

相关指南

查看订阅方案 →