搜索 Pinterest 公开账号
查看 Pinterest 用户资料、粉丝与 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 或画板。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/pinterest-scraper/search-users API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/pinterest-scraper/search-users?key=<API_KEY>&username=example_user'
查询结果
使用场景
- 构建由人工审核的创作者账号选择器，搜索提供的名称、展示候选用户名，并记录最终选定的账号 ID。
- 将返回的资料关联到内部品牌档案前，先比较多个候选账号，区分名称相近的品牌账号。
- 为内容研究维护账号发现队列，分别记录已选定、存在歧义和未找到候选的结果，而不是把第一条结果当作已核实的匹配。
- 将只有显示名称的联系人备注整理为可审阅的 Pinterest 用户名候选清单，仅对选定的候选另行执行资料查询。
常见问题
username 参数可以填写带空格的名称吗？
可以。虽然参数名为 username，但文档将其定义为用户名、部分名称等搜索文本。已记录的成功请求使用了 martha stewart。请将示例默认值 example_user 替换为所需的查询内容。
搜索结果中的哪些账号字段已通过实测确认？
已观察到的响应包含 status、request_id、值为 null 的 message 和 data.users。首个候选包含 username、id 和 full_name。头像链接、资料计数、验证标记及其他字段出现在文档示例中，但实测摘要未逐项确认。
第一条结果就是我想找的账号吗？
不一定。实测响应同时包含 marthastewart 和 MarthaWeddings。选定候选前，请比较用户名及可用资料；结果排名和相似显示名称都不能独立证明身份或账号归属。
会返回所有匹配账号吗？支持分页吗？
已记录的查询返回了 49 个用户，但这不代表固定结果数量或完整覆盖。此接口没有分页输入，请勿自行添加文档未提供的页码或游标参数。
后续请求应该使用显示名称还是用户名？
另行调用按用户名查询的资料或 Pin 接口时，请使用所选候选返回的 username。账号 ID 应保留为字符串，以便匹配记录。full_name 只是显示名称，不一定是有效的账号用户名。
此搜索接口能返回 Pin 或画板集合吗？
不能。此接口通过 data.users 发现用户资料。选定目标账号后，请另行请求该账号当前可返回的公开 Pin。