按用户名查询 Pinterest 公开账号资料
查看 Pinterest 用户资料、粉丝与 Pin 数据 的全部接口 →通过必填的 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 错误情况未经过实测。粉丝总数和关注总数属于账号资料，不是关系名单，也不能证明可以完整遍历关系。本响应仅代表一次快照，任何计数变化历史都需要通过你自己的多次观察建立。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/pinterest-scraper/get-user-details API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/pinterest-scraper/get-user-details?key=<API_KEY>&username=example_user'
查询结果
使用场景
- 将已确认的 Pinterest 用户名解析为准确账号 ID，再单独发起需要数字 ID 的粉丝列表查询。
- 为创作者候选名单保存带时间戳的公开资料快照，仅通过自行重复采集推导计数变化历史。
- 将 HTTP 200 下的空资料结果归类为业务层未找到，避免向账号目录写入虚构的零粉丝账号。
- 使用已确认的身份与计数字段填充资料审核卡片，并将不可用的可选信息与空字符串、数值零分别展示。
常见问题
username 应该填写什么？
填写账号的 Pinterest 用户名，而非展示名称。该参数为必填项，成功实测使用的是 marthastewart。请将默认的 example_user 替换为你实际要查询的账号。
账号不存在时也可能返回 HTTP 200 吗？
可能。已记录的不存在用户名查询返回了 HTTP 200，同时包含 status: error、说明未找到数据的消息和 data.user: {}。判断资料查询成功前，应先检查这些响应字段。
如何保留用户 ID 以便查询粉丝？
已保存的成功资料响应将 id 返回为带引号的十进制字符串 "32088353503445352"。粉丝接口应使用这个准确的字符串 ID，而非资料用户名，也不要将其转换为 JavaScript 数值。只有在其他响应使用无引号 JSON 整数 ID 时，才需要先无损解析原始数字，再转为字符串；已被舍入的数值无法恢复原来的完整数字。
哪些资料字段经过了实测确认？
成功实测记录确认了 data.user 中的 id、username、full_name、pin_count、follower_count、following_count 和 last_pin_save_time，以及响应中的 status、request_id 和 message。其他简介、图片、网站、标记及封面字段虽出现在文档示例中，但未逐一验证。
资料中的计数是否包含完整名单或历史分析？
不包含。计数是快照资料，不是粉丝或关注对象集合。缺失计数必须与零值区分，完整遍历关系的能力尚未得到验证，计数历史也需要通过你自己多次保存的快照建立。