按邮编搜索旧版房产经纪人目录(已弃用)

查看 美国房产与房贷数据 API 的全部接口 →

通过已弃用的 GET /agents/list 接口搜索经纪人目录。必填参数为 postal_code,还可按姓名、买方或卖方经纪人角色、结果类型、最低评分、最低推荐次数及价格上下限筛选。文档列出的结果类型为 agent、team 和 office。分页使用 limit 和 offset:limit 的文档上限为 20,offset 表示跳过的条目数。sort 支持五种已说明的排序方式,分别涉及近期活跃度、近期成交、在售数量、推荐次数和评分。现有 HTTP 200 示例仅为空 JSON 对象,无法据此确认经纪人集合、记录字段、总数或分页元数据。旧版评价接口的文档说明 advertiser_id 来自此目录,但未采集到包含实际数据的目录记录来验证这一标识传递流程。本接口未进行实际调用测试,仅适合审计或迁移旧版目录筛选流程,不建议用于新集成;也不要假定当前搜索接口具有相同的筛选语义。

API 功能

按邮编限定旧版目录搜索范围 必须提供 postal_code,可再按经纪人、团队或公司名称缩小搜索范围;结果实体类型通过独立的 types 参数选择。
区分买卖方角色与结果实体类型 agent_type 用于选择文档列出的 buyer 或 seller 角色,types 则用于选择 agent、team 或 office。这两类参数表示不同的筛选条件。
设置最低评分与推荐次数门槛 通过 agent_rating_min 和 recommendations_count_min 表达旧版最低评分及最低推荐次数筛选条件;文档上限分别为 5 和 10。
审计旧版价格区间筛选条件 审查旧集成时保留可选的 price_min 和 price_max 入参。文档未说明这两个筛选条件具体对应哪项成交价或挂牌价字段。
核对五种排序与偏移量分页 可选择文档说明的活跃度、成交、在售数量、推荐次数或评分排序,并保留 limit 与 offset 分页方式;每页条数的文档上限为 20。

在线 API 演示

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

使用场景

常见问题

按名称搜索时也必须提供 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 是可选数值型筛选参数,但文档未说明它们具体对应哪个价格字段。提供的成功示例为 {},因此记录字段、数量及实际填充的广告主标识仍未经验证,也未采集到实际调用响应。

能否将全部旧版筛选条件直接迁移到当前经纪人搜索接口?

不要作此假设。此操作已弃用,应逐项对照当前接口文档中的约定,对不支持的旧筛选条件明确提示,而不是悄然丢弃这些条件或宣称结果等价。

相关接口

相关指南

查看订阅方案 →