Realtor 搜索链接转房源数据 API - 保存的搜索 URL 查询

将完整 Realtor.com 搜索页面 URL 传入 url，可选 page 与 pageSize。文档列出城市、州、邮编等支持的搜索页面类型；纽约城市链接只是文档示例，本接口尚未实测。适合评估把已保存的搜索条件链接转为 JSON 房源候选的流程。响应字段和分页行为均未确认，应先检查实际结果，再确定映射方式；不能假设所有 URL 都兼容。如果无需链接输入，优先使用已有实测示例的城市或邮编搜索接口。

API 功能

保存的搜索 URL 作为输入 使用完整搜索页面链接，无需先拆解其中的地点条件。

城市与邮编页面兼容性评估 文档覆盖城市、邮编等页面场景，各种 URL 形式仍需分别验证。

基于链接的翻页参数 可提交 page 和 pageSize，但本接口中的实际影响尚未确认。

先检查再映射搜索结果 没有已确认的响应结构，不直接照搬其他搜索接口的字段映射。

在线 API 演示

GET /api/project/realtor/property-search-by-url

API 响应 (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-search-by-url?key=<API_KEY>&url=https%3A%2F%2Fwww.realtor.com%2Frealestateandhomes-search%2FNew-York_NY'

curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-search-by-url?key=<API_KEY>&url=https%3A%2F%2Fwww.realtor.com%2Frealestateandhomes-search%2FNew-York_NY'

📢

需要帮助？

如遇接口异常，或需要其他接口需求，可联系我们

联系我们

使用场景

验证受支持链接后，把研究人员提交的搜索 URL 转为房产工作表候选。
在经纪业务研究记录中保留原搜索链接，方便后续复核查询背景。
比较城市和邮编搜索 URL 与对应地点查询的兼容性。
把搜索页面书签导入人工审核队列，避免从 URL 文本猜测地点名称。

常见问题

这里的 url 应该是搜索页还是某套房的详情页？

本接口要求完整搜索页面 URL。单套房的详情链接应评估 property-detail-by-url，或先取得 property_id 后使用已实测的 property-v2-detail。

纽约搜索链接示例已经实测成功了吗？

没有。该链接是文档中的输入示例，本接口的实际响应、支持模式和分页行为尚未验证，不能据此承诺成功或固定返回字段。

从零开始接入房源搜索，是否应优先使用 URL 方式？

如果只有城市或邮编条件，建议先使用已实测的在售、出租或已售专用搜索。只有确实需要保留搜索链接上下文时，再单独验证本接口。

使用指南

查看订阅方案 →

通过 Realtor 搜索页面链接查询房源