Pinterest 用户资料、粉丝与 Pin 数据 APIs

获取关注指定 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。这些错误结构未在已记录的成功实测中出现。本接口列出的是关注目标账号的人，而非目标账号关注的人，也不提供私有受众分析数据。

获取指定 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；这些错误未在成功实测中出现。关注关系表示目标账号关注了哪些账号，不是目标账号的粉丝，也不能据此认定其背书、受众重合或私下兴趣。

通过必填的 username 查询参数获取公开账号资料。应填写 Pinterest 账号的用户名，而非展示名称；已记录的成功请求使用的也是用户名。资料是否可用可能受账号可见性和数据可用性影响。实测成功响应为 HTTP 200，包含 status: ok、request_id、message: null 和非空的 data.user。实测记录确认了 data.user.id、username、full_name、pin_count、follower_count、following_count 和 last_pin_save_time。实测返回的 id 是带引号的十进制字符串 "32088353503445352"。请保留其完整字符串，用于数字 ID 粉丝查询，不要将其转换为 JavaScript 数值。只有在其他响应将 ID 编码为无引号 JSON 整数时，才需要先无损解析原始数字，再转为字符串。实测也确认了未找到账号的情况：响应仍为 HTTP 200，但包含 status: error、request_id、说明未找到数据的 message，以及 data.user: {}。应同时检查业务状态和资料内容，不要将 HTTP 请求成功或空对象当作有效的零计数账号。缺失的计数与数值零必须分别处理。文档示例还展示了 about、first_name、board_count、created_at、domain_verified、eligible_profile_tabs、image_medium_url、image_xlarge_url、indexed、interest_following_count、is_ads_only_profile、is_gco_account、is_inspirational_merchant、is_partner、is_primary_website_verified、is_private_profile、is_verified_merchant、node_id、partner、profile_cover.url、seo_description、seo_title 和 type。这些额外字段未由所提供的实测记录逐一确认，可能无法获取。文档中的错误示例包括 HTTP 400 的 detail、HTTP 422 的 detail[]（含 loc、msg 和 type），以及 HTTP 500 的 data.user、request_id 和 status；这些 HTTP 错误情况未经过实测。粉丝总数和关注总数属于账号资料，不是关系名单，也不能证明可以完整遍历关系。本响应仅代表一次快照，任何计数变化历史都需要通过你自己的多次观察建立。

通过 GET /ping 发送轻量请求，检查服务是否响应。此接口无需专用查询参数，也无需请求体，不会返回 Pinterest 用户资料、Pin 或关注关系集合。 响应依据：文档提供的 HTTP 200 示例为空 JSON 对象。此接口没有已记录的实测结果，因此尚未确认任何具体响应字段、状态文本、请求标识或耗时指标。请检查 HTTP 状态码及实际返回的响应体，不要依赖未在文档中明确规定的 JSON 属性。 建议设置有限的客户端超时时间，并采用低频轮询。健康检查成功仅表示健康检查路由作出了响应，并不代表能够获取 Pinterest 数据、查询特定账号、调用其他接口、继续分页或取得完整内容。排查这些能力时，应另行测试具有代表性的数据接口。

通过必填的字符串查询参数 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。

通过必填的字符串查询参数 username，搜索可公开发现的 Pinterest 账号。虽然参数名为 username，但它接受用户名、部分名称等账号搜索文本；已记录的实测使用了带空格的查询 martha stewart。请将示例默认值 example_user 替换为所需的搜索文本。文档没有提供页码或游标参数。 已观察到的响应：已记录的请求返回 HTTP 200，包含值为 ok 的 status、request_id、值为 null 的 message，以及含 49 条账号记录的 data.users。首条结果包含值为 marthastewart 的 username、一个 id，以及值为 Martha Stewart 的 full_name；另一候选账号为 MarthaWeddings。这些结果仅证明该查询可发现候选账号，并不代表固定结果数量、保证的排名、账号归属或完整账号目录。请将 ID 保留为字符串。 文档还列出了以下字段，但实测摘要未逐项确认：用户记录可能包含 image_small_url、image_medium_url、image_large_url、image_xlarge_url、board_count、pin_count、follower_count、last_pin_save_time、domain_verified、is_primary_website_verified 和 is_verified_merchant。文档示例还包含 contextual_pin_image_urls、pin_thumbnail_urls、recent_pin_images、node_id、type、blocked_by_me、explicitly_followed_by_me、is_ads_only_profile 和 is_default_image。请将这些视为可选的示例字段，而非保证完整出现的结构；公开搜索示例中的标记，不能证明某个已登录浏览者与账号之间的关系。计数和验证标记即使存在，也只是资料属性，不代表私密分析数据，亦不能独立证明身份。 文档提供了 HTTP 400 示例，包含 detail 字符串；HTTP 422 示例的 detail 条目包含 loc、msg 和 type；HTTP 500 示例包含 status、request_id 和 data.users。已提供的实测没有记录这些错误，因此它们只是文档示例，并非已观察到的失败格式。 请比较候选账号的用户名及可用资料，不要直接采用第一条结果。显示名称不一定是后续账号请求所需的用户名。由人工或应用选定候选账号后，再使用返回的 username 单独查询资料或获取 Pin；搜索接口不会自动补充这些数据。结果可能存在歧义或覆盖不全，此接口搜索的是用户，而不是 Pin 或画板。