按美国城市或邮编查询出租房源
查看全部 Realtor 美国房产数据 API →通过 location 查询美国广告中的出租房源,邮编 10001 搭配 sort=newest 已实测。结果包含 status=true、message、扁平 data 数组,以及 resultsPerPage、totalResultCount、totalPages、currentPage。样本可见 property_id、listing_id、status=for_rent、含 postal_code 的 location.address、list_date、可为空的 list_price/list_price_min/list_price_max、description 中的卧室与浴室数量或区间、主图及图片列表。广告租金不等于实际签约租金。pageSize=8 仍返回 30 条,汇总总数和页数也可能与实际行数不一致;应明确展示价格不可用状态,逐页检查并按标识去重。宠物、入住日期和设施等可选输入已列入参数,但并未逐项验证筛选效果。
API 功能
实测曼哈顿 10001 邮编 出租样本的已检查地址与请求邮编一致,便于从 ZIP Code 启动租房发现。
如实保留广告租金空值 list_price、list_price_min 和 list_price_max 均可能缺失,不能将 null 解释成零租金。
识别卧室与浴室区间 description 可能提供 beds_min/beds_max、baths_min/baths_max,而非单一户型数量。
按实际出租页长度处理 请求 8 条时曾返回 30 条;界面展示上限与数据分页需要分开管理。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/realtor/property-search-rent API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-search-rent?key=<API_KEY>&location=10001&sort=newest&page=1'
curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-search-rent?key=<API_KEY>&location=10001&sort=newest&page=1'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 构建按美国邮编找租房的页面,为不完整广告显示“租金暂不可用”。
- 采集挂牌租金研究样本,单独报告因价格为空而未参与统计的记录。
- 让搬家用户收藏出租房产 ID,再主动获取详情,而不承诺房源仍可签约。
- 按查询日期比较出租广告变化,并在跨页汇总时去除重复挂牌记录。
常见问题
如何用 Python 按美国邮编查询出租房源?
向此 GET 接口提交 location=10001,可搭配 sort=newest 和 page=1,并使用自己的平台 API 密钥。读取 JSON 后先检查业务状态,再处理 data 数组;页面示例不保证每次都有可用房源。
出租房源的 list_price 为 null 应该怎么办?
保留 null 并展示租金不可用。可以检查 list_price_min/list_price_max,但它们也可能为空;不要猜测租金,也不要把广告租金当作已签租约价格。
能保证筛到允许养宠物、指定日期可入住的房源吗?
不能。pets 和 moveInDate 是文档参数,接受格式与实际筛选效果尚未验证。产品上线前需逐项测试,实际租赁条件仍须向有权提供信息的一方核实。