按邮政编码及个人资料条件搜索美国房产经纪人

查看 美国房产与房贷数据 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 功能

以邮编定位经纪人名单 以必填的 postal_code 发起搜索。一次曼哈顿邮编查询测试成功返回了非空的经纪人列表。
按代理角色与服务语言缩小范围 使用文档列出的 BUYER 或 SELLER 角色及单个语言标识值构建候选名单;这些筛选条件尚未单独测试验证。
面向经纪人的多维排序 按文档提供的取值,选择相关性、评分与评价、成交量、推荐或近期活动排序。文档默认值为 RELEVANT_AGENTS。
区分匹配总数与当前页记录 结合最大为 20 的 limit 与 offset 分页,并将已观察到的 matching_rows 总数与当前页 agents 数组分别处理。
参考所属公司及房源活动信息 比较成功响应中已观察到的经纪公司、评分与房源统计信息,但不要将活动日期视为数据时效保证。

在线 API 演示

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

使用场景

常见问题

提供 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 月,但这并不能验证每位经纪人记录的时效性或完整性。

相关接口

相关指南

查看订阅方案 →