按邮政编码及个人资料条件搜索美国房产经纪人
查看 美国房产与房贷数据 API 的全部接口 →按邮政编码查找美国房产经纪人,可结合姓名或服务区域、买方或卖方代理角色、服务语言、标识符是否存在及排序条件筛选。本接口将 postal_code 设为必填:虽然文档将 marketing_area_city、name 和 postal_code 描述为可择一使用的查询条件,但在此接口约定中,即便传入其他条件也仍须提供 postal_code。文档中的 marketing_area_city 指经纪人地区搜索接口返回的地点 ID;此处尚未验证其响应格式。limit 控制每页数量,最大为 20;offset 表示跳过的结果条数。文档默认排序为 RELEVANT_AGENTS。一次使用 postal_code=10001、limit=3、offset=0 和 sort=RELEVANT_AGENTS 的成功测试返回了 data.search_agents.matching_rows=486,以及 data.search_agents.agents 中的 3 条记录。已观察到的经纪人记录包含姓名、标识符、所属经纪公司、评分及房源统计。matching_rows 是匹配总数,不是当前页 agents 数组的长度。部分返回的房源活动涉及 2026 年 10 月,但这不能用于推断更新周期,也不能保证每条记录的时效性。所提供的响应示例为空,因此未能据此确认更多响应字段或保证字段完整性。目前仅验证了上述邮政编码与排序组合,其他文档列出的筛选条件尚未分别验证。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/agents-v2-list API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-v2-list?key=<API_KEY>&postal_code=<postal_code>&sort=RELEVANT_AGENTS'
查询结果
使用场景
- 为搬家用户按邮编建立买方经纪人候选名单,使用文档列出的语言值和 BUYER 角色,并核对返回记录是否符合所选条件。
- 搭建房产经纪人名录,将 matching_rows 匹配总数与通过 limit 和 offset 获取的各页记录分开展示。
- 使用 SELLER 和 MOST_SALES 帮助房主浏览当地卖方代理,同时分别呈现评分与房源活动信息。
- 在必填邮政编码限定的搜索范围内,按经纪人、团队或公司名称查找候选对象。
- 让用户比较已返回的所属经纪公司与个人资料指标,再决定进一步了解哪位经纪人,不暗示平台背书或保证对方可提供服务。
常见问题
提供 name 或 marketing_area_city 后,可以省略 postal_code 吗?
不可以。文档虽然将这三个条件描述为可择一使用,但本接口明确要求 postal_code 必填。使用 name 或 marketing_area_city 时也要提供邮政编码,不要将这些字段视为必填参数的替代项。
matching_rows、limit 和 offset 有什么区别?
matching_rows 是已观察到的匹配总数,limit 是请求的每页条数,文档规定最大为 20;offset 是要跳过的结果条数。一次成功测试的匹配总数为 486,但由于 limit 为 3,当前页仅返回了 3 位经纪人。
可以按哪些经纪人角色和语言筛选?
agent_type 的文档取值为 BUYER 或 SELLER,也可以不传。languages 接收一个文档列出的语言标识值,例如 spanish、chinese 或 english。文档未说明如何在一次请求中组合多种语言,且这些筛选条件尚未单独测试验证。
默认如何排序?还有哪些可选排序?
文档默认排序为 RELEVANT_AGENTS。其他文档取值包括 RATINGS_REVIEWS、MOST_SALES、TESTIMONIALS_RECOMMENDATIONS 和 MOST_RECENT_ACTIVITY。已成功验证的请求使用了 RELEVANT_AGENTS。
标识符筛选或近期活动能证明经纪人资料可靠吗?
不能。agent_filter_criteria 仅按文档定义判断指定标识符是否存在,并非执照核验或服务质量认证。部分已观察到的房源活动涉及 2026 年 10 月,但这并不能验证每位经纪人记录的时效性或完整性。