按邮编搜索旧版房产经纪人目录(已弃用)
查看 美国房产与房贷数据 API 的全部接口 →通过已弃用的 GET /agents/list 接口搜索经纪人目录。必填参数为 postal_code,还可按姓名、买方或卖方经纪人角色、结果类型、最低评分、最低推荐次数及价格上下限筛选。文档列出的结果类型为 agent、team 和 office。分页使用 limit 和 offset:limit 的文档上限为 20,offset 表示跳过的条目数。sort 支持五种已说明的排序方式,分别涉及近期活跃度、近期成交、在售数量、推荐次数和评分。现有 HTTP 200 示例仅为空 JSON 对象,无法据此确认经纪人集合、记录字段、总数或分页元数据。旧版评价接口的文档说明 advertiser_id 来自此目录,但未采集到包含实际数据的目录记录来验证这一标识传递流程。本接口未进行实际调用测试,仅适合审计或迁移旧版目录筛选流程,不建议用于新集成;也不要假定当前搜索接口具有相同的筛选语义。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/agents-list-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-list-deprecated?key=<API_KEY>&postal_code=<postal_code>'
查询结果
使用场景
- 在替换旧版本地经纪人目录搜索页面之前,盘点其实际使用的邮编、名称及实体类型筛选条件。
- 编制迁移检查清单,标出在当前接口中没有明确对应项的买卖方角色、价格、评分或推荐次数条件,避免悄然扩大结果范围。
- 将已保存的 limit、offset 和 sort 设置与拟替换的目录接口逐项比较,在切换前发现分页及排序差异。
- 审查现有门店或团队搜索是否误将 types 与 agent_type 合并为同一个控件,保留两者在文档中各自独立的用途。
- 准备能处理空对象的旧版目录测试样例,不虚构经纪人列表、结果总数或已有值的 advertiser_id 字段。
常见问题
按名称搜索时也必须提供 postal_code 吗?
是。postal_code 是必填的字符串查询参数。name 为可选参数,文档说明可用于搜索经纪人、团队或公司,但不能替代必填的邮编。
types 和 agent_type 有什么区别?
types 用于选择文档列出的结果实体:agent、team 或 office。agent_type 用于选择 buyer 或 seller 角色,也可以省略。两者是独立的筛选条件,不应合并为一个字段。
分页和筛选门槛有哪些文档限制?
limit 的文档上限为 20,offset 表示跳过的条目数。agent_rating_min 的文档上限为 5,recommendations_count_min 的文档上限为 10。空示例未能证实响应中的总数或下一页字段。
文档列出了哪些 sort 值?
文档列出的值为 recent_activity_high、recently_sold_high、for_sale_count_high、recommendations_count_high 和 agent_rating_high。提供的 sort 示例是 recent_activity_high,但不能据此认定它是服务端默认值。
价格筛选和响应记录有哪些已确认的信息?
price_min 和 price_max 是可选数值型筛选参数,但文档未说明它们具体对应哪个价格字段。提供的成功示例为 {},因此记录字段、数量及实际填充的广告主标识仍未经验证,也未采集到实际调用响应。
能否将全部旧版筛选条件直接迁移到当前经纪人搜索接口?
不要作此假设。此操作已弃用,应逐项对照当前接口文档中的约定,对不支持的旧筛选条件明确提示,而不是悄然丢弃这些条件或宣称结果等价。