🏠

美国房产与房贷数据 API

为美国住宅搜索、经纪人检索和含税保险的房贷月供估算接入结构化数据。

打开独立调试页

用 New York 查询地点候选

在平台控制台获取你有权使用的 API 密钥,替换 <API_KEY>。请求链接可能包含密钥,请勿公开分享或写入日志。

示例将 input 设为 New York、limit 设为 3,不需要房产或经纪人 ID。可改为美国州名、城市、地址或邮编;候选可能变化或为空,只有主动发送请求才会查询。

基础 URL https://api.opendata-api.com

curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/locations-v2-auto-complete?key=<API_KEY>&input=New+York&limit=3'
发送前核对输入与单位
  • 新集成优先使用房产 v3、地点 v2、经纪人 v2 和房贷 v2 操作。标注“已弃用”的路由仅用于检查或迁移已有系统,不代表仍能稳定返回数据;不同版本的参数与响应不可直接互换。
  • property_id 标识房产,listing_id 标识具体房源,两者都应保留为字符串。详情必填 property_id,可同时传入所选结果的 listing_id 以保留房源上下文;照片、通勤和周边查询不能用 listing_id 替代房产 ID。
  • 房源列表使用 POST JSON 请求体。status、type 为数组,list_price、beds、baths、sort 为对象,不要改成逗号分隔字符串或查询参数。尚未明确的筛选子字段不能凭常见写法补造,应先核对接口契约。
  • 地点补全返回 autocomplete=[] 可以表示正常无匹配,应提示没有候选。房产详情即使 HTTP 200,也可能返回空 home 与 errors;需结合业务状态及正文判断,不能一律视为正常未找到。
  • 房贷 v2 的 rate=0.065 表示年利率 6.5%,property_tax_rate=0.012 表示年房产税率 1.2%,首付传金额而非百分比。区分本息、税费、保险和总月供,不要把 total_payment 当作含税保险月供乘以还款期数;非零 HOA 费用的周期及未返回的费用需另行核实。
  • 数据面向美国住宅,覆盖范围、可用字段、照片数量及更新时间随记录而异。获得房源或图片链接不等于取得 MLS/IDX 访问与展示授权或图片转载许可;通勤、周边、洪水及学区信息需另行核实,房贷结果不是正式报价或审批。

查看地点候选与业务状态

HTTP 状态与业务结果需分开判断:同时检查网关响应中的 code、message 和 data,以及数据内是否存在错误。HTTP 200 不保证有匹配结果,地点空候选与房产详情错误应分别处理。

按查询目标选择操作
查找房源并补充详情与照片

用 JSON 请求体提交房源条件;选定结果后保留 property_id 和 listing_id。详情、照片与相似房源查询使用房产标识,详情还可携带原房源标识。

评估通勤、周边环境与学校背景

通勤查询需房产 ID 和目的地地址,周边查询需房产 ID。学校与学区详情须分别准备已确认的学校 ID 或学区 ID;本目录没有可依赖的学校搜索入口,不能用房产 ID 代替。

将地点文字补全为候选位置

输入美国州名、城市、地址或邮编,可选设置候选数量。先核对候选是否符合目标地区;没有候选可以是正常结果,不需要预先准备房产 ID。

按邮编与服务语言寻找经纪人

经纪人检索必填邮编,即使补充姓名或区域条件也不能省略。位置搜索可提供区域候选;查询资料需 profile_id,查询房源、评价和推荐需 fulfillment_id,请从所选记录分别取得。

估算房贷月供并查看地区利率

月供计算需房价、首付金额、年限、利率、税率、保险与 HOA 费用,利率和税率填小数比例。两类地区利率查询分别使用 postal_code 或 loc 邮编;估算与利率参考不等于正式贷款报价。

核对旧版经纪人、地点与附近学校调用

维护旧版目录功能时,按所选操作核对原有经纪人标识、地点搜索词或经纬度。旧版与新版的标识和筛选条件不能直接混用,新项目不应以这些已弃用路由为起点。

核查旧版房贷与可负担金额计算

迁移已有月供、可负担金额或权益贷款调用时,逐项核对金额、地区、信用条件及费用周期。旧版利率单位需独立确认,不能直接套用房贷 v2 的小数比例规则。

旧版经纪人接口(已弃用)

GET /api/project/realty-in-us/agents-get-listings-deprecated

旧版经纪人房源列表查询(已弃用)

完整文档 →
说明

按旧版接口约定查询与经纪人关联的房源。此接口已弃用,仅适合维护和审查现有经纪人页面,不建议用于新接入。三个必填查询参数必须取自同一条旧版 /agents/list 结果:agent_id 为 member/id 中的数值,fulfillment_id 为 advertiser_id 中的数值,id 为 abbreviation 中的字符串。可选参数 page 用于选择页码;type 可选 all、forSale、forSold、forRent 或 openHouses。文档示例使用 page=1 和 type=all,但未明确省略参数时的行为,也未说明每页条数。现有响应文档仅提供一个未经验证的 HTTP 200 示例,内容为空 JSON 对象({})。目前没有实测响应可供参考,文档也未明确房源字段、结果总数、分页结构或错误格式。不能据此认定经纪人没有房源,也不能认定该弃用接口目前仍然可用。迁移已保存的页面前,应对照现行经纪人房源接口核实标识符要求和响应结构,不要假定不同接口的标识符可以直接互换。

填写参数并手动测试 3 个必填 · 2 个可选
参数位置值
query
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-get-listings-deprecated?key=<API_KEY>&agent_id=<agent_id>&fulfillment_id=<fulfillment_id>&id=<id>'
GET /api/project/realty-in-us/agents-get-profile-deprecated

旧版经纪人档案查询(已弃用)

完整文档 →
说明

通过旧版经纪人目录和客户关系管理系统曾使用的接口约定查询经纪人档案。两个查询参数都必填:数值型 advertiser_id 和字符串型 nrds_id,分别取自目标经纪人在旧版 /agents/list 结果中的同名字段。nrds_id 应保留为文本,不能当作数值型广告主标识处理。此接口仅供审查和迁移已有接入,不建议用于新建档案页面。现有响应文档只有一个未经验证的 HTTP 200 示例,内容为空 JSON 对象({})。目前没有实测结果可供参考,因此无法确认经纪人档案属性、个人简介、联系方式、所属经纪公司字段或错误处理行为。该示例既不能证明档案不存在,也不能证明此接口目前仍然可用。与现行档案接口对照时,应明确核实经纪人身份,不能假定 advertiser_id 或 nrds_id 等同于现行接口的 fulfillment_id 或 profile_id。迁移缓存档案前,请只按相关接口约定中已经确认的字段逐项核对内容。

填写参数并手动测试 2 个必填 · 0 个可选
参数位置值
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-get-profile-deprecated?key=<API_KEY>&advertiser_id=<advertiser_id>&nrds_id=<nrds_id>'
GET /api/project/realty-in-us/agents-get-recommendations-deprecated

旧版经纪人推荐评价查询(已弃用)

完整文档 →
说明

通过经纪人的广告主标识查询其旧版推荐评价资源。此接口已弃用,仅供维护现有推荐评价组件及规划迁移时参考,不建议用于新接入。唯一必填的查询参数是数值型 advertiser_id,取自目标经纪人在旧版 /agents/list 结果中的 advertiser_id 字段。文档没有列出分页或筛选参数。现有资料仅有一个标为 HTTP 200 的响应示例,内容为空 JSON 对象({});该示例未经验证,且没有实测响应可供参考。文档未明确推荐评价正文、作者署名、日期、评分、条数、结果排序或错误字段。不能把该示例当成推荐评价数量为零的证明,也不能据此保证接口目前仍然可用;此外,不应将这项资源理解为推荐经纪人搜索结果或经过验证的评分数据。若计划迁移到以 fulfillment_id 为标识的现行推荐评价接口,应明确核实经纪人身份和各项标识映射,不能直接将 advertiser_id 等同于 fulfillment_id。

填写参数并手动测试 1 个必填 · 0 个可选
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-get-recommendations-deprecated?key=<API_KEY>&advertiser_id=<advertiser_id>'

经纪人资料与房源

GET /api/project/realty-in-us/agents-get-reviews-deprecated

按 advertiser_id 查询经纪人评价(已弃用)

完整文档 →
说明

通过已弃用的 GET /agents/get-reviews 接口请求经纪人评价。唯一有文档说明的入参是必填的数值型 advertiser_id,该标识据文档由旧版 /agents/list 接口返回,不能用经纪人的 fulfillment_id 替代。现有 HTTP 200 示例仅为空 JSON 对象,无法据此确认评价集合、评价正文、评分、时间、作者归属或分页字段。本接口未采集到实际调用响应,空示例也不代表某位经纪人没有评价。仅建议在审计或迁移已有 advertiser_id 评价查询流程时保留此接口,并在依赖它之前核实接口可用性及响应结构。

填写参数并手动测试 1 个必填 · 0 个可选
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-get-reviews-deprecated?key=<API_KEY>&advertiser_id=<advertiser_id>'
GET /api/project/realty-in-us/agents-list-deprecated

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

完整文档 →
说明

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

填写参数并手动测试 1 个必填 · 10 个可选
参数位置值
query
query
query
query
更多可选参数 (7)
参数位置值
query
query
query
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-list-deprecated?key=<API_KEY>&postal_code=<postal_code>'
GET /api/project/realty-in-us/agents-v2-get-listings

按经纪人 fulfillment_id 查询关联房源

完整文档 →
说明

通过 GET /agents/v2/get-listings 请求指定经纪人的关联房源。必须提供字符串类型的 fulfillment_id,文档说明该标识来自 /agents/v2/list,给出的入参示例和默认值均为 1365510。文档未列出房源状态、日期范围、limit 或 offset 等查询参数。本操作未采集到实际调用响应。提供的 HTTP 200 示例是一段被截断、未经验证的 JSON,其中出现的是经纪人资料,无法据此确认可用的房源集合。示例可见字段包括 fulfillment_id、fullname、bio,以及地址中的 city、country、line、postal_code、state 和 state_code;broker 与 office 含各自的身份信息,ratings 与 recommendations 含经纪人资料中的评价指标。这些仅在示例中出现的字段均不构成实际响应保证,片段也未证实房源标识、价格、房源状态、房源数组字段或分页元数据。只有在核实实际返回结构后,才应将此查询用于所选经纪人的房源展示流程;不要宣称结果是完整库存、代表当前可售状态,或能够区分在售与已售房源。

填写参数并手动测试 1 个必填 · 0 个可选
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-v2-get-listings?key=<API_KEY>&fulfillment_id=1365510'
GET /api/project/realty-in-us/agents-v2-get-profile

获取指定房产经纪人的职业档案

完整文档 →
说明

通过必填查询参数 profile_id 获取经纪人档案。该值取自 /agents/v2/list 所选结果的 id 字段;可选参数 fulfillment_id 则取自同一结果的 fulfillment_id 字段。两种标识需要分别保存和传递,不能相互替代。文档中的 profile_id 示例为 56d09a4b2cfde1010000abb1,fulfillment_id 未提供默认值。 现有文档示例列出了档案标识 id 和 _id,姓名及简介字段 fullname、profile_name、bio 和 profile_description,以及包含 line、city、postal_code、state、state_code 和 country 的 address 对象。示例还包括表示买方、卖方代理身份的布尔值 agent_represents.buyer 和 agent_represents.seller、字符串 areas_served,以及 languages 和 licenses 数组;这两个数组的示例均为空,因此无法据此确定数组项结构。此外,示例包含带有 name 和 fulfillment_id 的 broker、office 对象,照片地址 photo.href,以及档案更新时间 meta.last_update_date。反馈相关字段包括 recommendations.count,以及 ratings 对象中的 average_rating、overall_rating、reviews_count 和 responseCount。评分字段混用了数值和字符串,不能假设所有字段都采用同一种数值类型。 上述字段仅来自未经实际响应验证的文档示例,并非返回保证:此接口没有可用的实测响应,且所提供的示例并不完整。接入时应兼容字段缺失,不要仅凭返回档案推断联系方式仍然有效、执照有效、照片可自由使用,或职业经历完整。若需要展示推荐反馈或评价,应分别调用对应的独立接口。

填写参数并手动测试 1 个必填 · 1 个可选
参数位置值
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-v2-get-profile?key=<API_KEY>&profile_id=56d09a4b2cfde1010000abb1'
GET /api/project/realty-in-us/agents-v2-get-recommendations

查询指定房产经纪人的推荐反馈

完整文档 →
说明

使用必填字符串查询参数 fulfillment_id 请求指定经纪人的推荐反馈。该值取自 /agents/v2/list 所选结果的 fulfillment_id 字段,文档示例为 1365510。不要用经纪人的档案 id 替代 fulfillment_id。此接口未记载分页、排序或按推荐者筛选的参数。 现有文档示例除其他档案字段外,还包含带数值型 count 的 recommendations 对象,以及含 recommendation_rating 的 ratings 对象。这是一个不完整的档案形式示例,档案和评价接口也使用了同一示例,不能据此确定推荐条目集合的结构。现有资料未验证推荐正文、作者署名、日期、条目标识或推荐列表的外层结构。 此接口没有可用的实测响应。recommendations.count 和 ratings.recommendation_rating 仅是未经验证的示例字段,并非保证返回的响应结构,也不保证数量反映当前情况。界面上应将推荐反馈与评价分开。缺少反馈或数量字段表示信息不可用,不代表无人推荐、经纪人表现不佳,也不能据此判断执照状态或可信程度。

填写参数并手动测试 1 个必填 · 0 个可选
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-v2-get-recommendations?key=<API_KEY>&fulfillment_id=1365510'
GET /api/project/realty-in-us/agents-v2-get-reviews

查询指定房产经纪人的评价

完整文档 →
说明

通过必填字符串查询参数 fulfillment_id 请求指定经纪人的评价。该值来自 /agents/v2/list 所选结果的 fulfillment_id 字段,文档示例为 1365510。此请求不接受 profile_id。文档未记载评价分页、日期范围、星级筛选或排序参数。 现有文档示例是一个不完整的档案形式对象,经纪人档案、推荐反馈和评价接口均使用了这一示例。其中 ratings 对象将 reviews_count、average_rating 和 overall_rating 列为数值,而 responseCount、overall_satisfaction、performance_rating、recommendation_rating、show_scores 和 testimonial_return_rate 则显示为字符串。这些字段只是未经验证的示例,并非实际评价响应的返回保证。现有资料没有定义逐条评价的列表、评价正文、评价者姓名、评价日期、署名字段或评分尺度。 此接口没有可用的实测响应。构建评价卡片或汇总评分前,应先检查实际结果,并保留响应中确实返回的评价元数据和署名信息。不要自行推定星级尺度,也不要依据缺失字段计算分数。若实际结果明确返回空的评价集合,可标注为未获取到评价,而非评分低;响应缺失或请求失败也不能作为评价数量为零的证据。

填写参数并手动测试 1 个必填 · 0 个可选
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-v2-get-reviews?key=<API_KEY>&fulfillment_id=1365510'

经纪人检索

GET /api/project/realty-in-us/agents-v2-list

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

完整文档 →
说明

按邮政编码查找美国房产经纪人,可结合姓名或服务区域、买方或卖方代理角色、服务语言、标识符是否存在及排序条件筛选。本接口将 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 月,但这不能用于推断更新周期,也不能保证每条记录的时效性。所提供的响应示例为空,因此未能据此确认更多响应字段或保证字段完整性。目前仅验证了上述邮政编码与排序组合,其他文档列出的筛选条件尚未分别验证。

填写参数并手动测试 1 个必填 · 8 个可选
参数位置值
query
query
query
query
query
更多可选参数 (4)
参数位置值
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
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'
GET /api/project/realty-in-us/agents-v2-search-location

搜索地点候选项,用于选择房产经纪人服务区域

完整文档 →
说明

使用必填的 input 文本搜索地点信息,为查找房产经纪人时的地区选择提供候选项。文档默认搜索文本为 cali。可选参数 area_types 用于限定地点类别,支持 neighborhood、city、county、postal_code、building 和 street;其文档默认值为逗号分隔的字符串 neighborhood,city,county,postal_code,building,street。limit 默认 10,文档规定最大为 20。应将返回结果作为供用户选择的服务区域候选项,不要自动选定地点或发起经纪人列表查询。本接口没有提供成功测试的响应。未经验证的响应示例内容不完整,开头是包含经纪人资料的 agents 数组,无法据此确定可靠的地点建议响应结构。因此,结果字段名、标识符格式、坐标以及无匹配结果时的响应结构均未验证。经纪人列表接口将 marketing_area_city 描述为本接口返回的地点 ID,但使用前仍需根据实际响应核对映射关系。不要假定本接口的标识符或字段与房源地点自动补全接口相同。

填写参数并手动测试 1 个必填 · 2 个可选
参数位置值
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-v2-search-location?key=<API_KEY>&area_types=neighborhood%2Ccity%2Ccounty%2Cpostal_code%2Cbuilding%2Cstreet&input=cali&limit=10'

房贷利率参考

GET /api/project/realty-in-us/finance-rates

按邮政编码查询房贷利率参考信息

完整文档 →
说明

通过必填的 loc 邮政编码字符串查询房贷利率参考信息,文档示例为 loc=93505。此接口未提供其他查询条件,也不支持选择贷款机构、填写贷款金额或提交借款人资料。目前没有成功实测记录,以下响应字段仅见于未经验证的文档示例。示例的顶层包含 meta 和 rates 对象;rates 中以字符串形式列出 average_rate_10_year、average_rate_15_year、average_rate_20_year、average_rate_30_year 等期限参考字段,以及 average_rate_30_year_fha、average_rate_30_year_va 和标注为浮动利率类别的 average_rate_51_arm、average_rate_71_arm 字段。此外还包含数值类型的 insurance_rate、property_tax,以及嵌套的 meta.warnings 字符串。 现有示例未明确报价日期、更新频率、贷款机构、年化总成本利率(APR)、折扣点数、借款人资格要求,也没有完整说明各字段的单位与计算规则。因此,这些数据只能作为参考背景,不能视为可申请的贷款方案或保证实时有效的利率。看似数字的平均利率字段在示例中实际为字符串,展示或计算前应核实其格式和含义。税费、保险字段的单位未经确认,不应直接据此推算金额。 此接口用于查询参考数据,不计算房贷月供。如需搭配房贷计算器,应将查询结果与用户明确选定的计算假设分开展示,不能默认把参考值直接用于计算。

填写参数并手动测试 1 个必填 · 0 个可选
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/finance-rates?key=<API_KEY>&loc=<loc>'

地点补全

GET /api/project/realty-in-us/locations-auto-complete-deprecated

旧版城市与地址联想查询(已弃用)

完整文档 →
说明

此接口为现有集成保留,通过唯一必填的 input 查询字符串获取地点候选项。文档说明支持城市、行政区和地点名称,接口介绍还提到街道名称检索及从地址查找房产标识符,用例输入为 new york。该接口已弃用,适合用于梳理旧系统的迁移需求,不建议用于新建地点选择器;新项目应评估 /locations/v2/auto-complete。 文档示例包含 autocomplete 数组,候选项示例字段包括标识候选项的 _id、表示相关度的 _score、地点类别 area_type、坐标 centroid.lat 和 centroid.lon,以及 city、state_code、country 等地理信息。示例中的 counties 条目包含 fips、name、state_code。其他随地点类别而变化的示例字段包括 geo_id、slug_id、county_needed_for_uniq、city_slug_id、line、postal_code、has_catchment、school 和 school_id。不能假定每条建议都包含这些字段,也不能将城市标识符混同于房产标识符。 现有测试未记录此旧版接口的成功响应。上述字段来自未经验证且被截断的文档示例,并非已观测到的响应。从地址查找房产标识符只是文档描述的用途,不能保证某个地址一定返回房产标识符。迁移前应核实候选项类别、可选字段及后续房产接口接受的输入,不能假定新版接口具有完全相同的响应约定。

填写参数并手动测试 1 个必填 · 0 个可选
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/locations-auto-complete-deprecated?key=<API_KEY>&input=<input>'
GET /api/project/realty-in-us/locations-v2-auto-complete

查询美国地点建议并正确处理无匹配结果

完整文档 →
说明

通过必填的 input 字符串搜索美国地点建议,可使用可选的数值参数 limit 指定希望返回的条目数。文档说明支持州、城市、行政区、街道地址和邮政编码,输入示例包括 California、Los Angeles 和 2425 Sahalee Dr W Sammamish, WA;参数示例为 input=new york、limit=10。limit 用于指定请求的结果数量,此接口未提供 offset、分页令牌,也未保证可以遍历全部匹配结果。 成功实测确认响应包含 autocomplete 数组和 meta.es_total_hits 匹配总数。使用 input=New York、limit=3 时,响应的 meta.es_total_hits 为 5731,并返回 state:ny、city:ny_new-york、city:ny_manhattan 三个候选项,state_code 为 NY,country 为 USA。因此,匹配总数不一定等于实际返回的建议数量。输入一个特意构造的不存在地点时,接口返回 HTTP 200、meta.es_total_hits=0、autocomplete=[],且没有错误对象。这种组合应作为正常的无建议结果处理,而非请求失败。这些实测仅说明具有代表性的响应情况,并不保证匹配数量、排序或未来仍会返回相同候选项。 另一个被截断的文档示例列出 _id、_score、area_type、centroid.lat、centroid.lon、city、state_code、country、包含 fips/name/state_code 的 counties,以及 geo_id 和 slug_id 等候选字段。示例还列出随地点类别而变化的 city_slug_id、county_needed_for_uniq、line、postal_code、has_catchment、school 和 school_id。这些附加字段并未全部经过实测确认,也不是每个候选项的必备字段。应保留用户选中项的标识符、类别及可用地理信息,再核实后续接口接受什么输入。虽然文档提到可从地址查找房产标识符,但现有实测并未证明地址一定能解析为房产。

填写参数并手动测试 1 个必填 · 1 个可选
参数位置值
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/locations-v2-auto-complete?key=<API_KEY>&input=<input>'

房贷计算与利率

GET /api/project/realty-in-us/mortgage-calculate-deprecated

房贷月供计算(旧版,已弃用)

完整文档 →
说明

此接口已弃用,仅为现有房贷计算器保留。请求包含六个必填数值型查询参数:downpayment 表示首付,hoi 表示住房保险输入值,price 表示房价,rate 表示利率,tax_rate 表示房产税输入值,term 表示房贷类型。排查旧系统时,应保留这些参数的原始名称。文档中的请求示例为 downpayment=44980、hoi=56、price=224900、rate=3.827、tax_rate=1.2485549449920654、term=30。这些数值仅是示例,不代表默认值,也不构成可选值清单。 文档响应示例包含 meta 和 mortgage 对象。mortgage 中展示了 down_payment、loan_amount、rate、term、principal_and_interest、monthly_property_taxes、monthly_home_insurance、monthly_mortgage_insurance、hoa_fees、monthly_payment 和 total_payment 等字段。monthly_* 字段名用于区分月度金额,principal_and_interest 则单独表示本金与利息部分。未经核实,不应将 monthly_payment、principal_and_interest 和 total_payment 视为相同金额,也不应推断各汇总字段包含哪些费用。 现有资料未提供此已弃用接口的成功验证记录,上述响应字段均来自未经验证的文档示例。简短的参数说明未明确币种、保险输入值的计费周期、利率数值尺度、房产税率单位或贷款期限单位;term 的示例值为 30,也不足以确定支持的期限列表。将旧版输入映射到当前计算器前,应先核对原应用的单位约定和还款金额涵盖的费用。此接口仅适用于旧系统梳理与迁移,不建议用于新建计算器,也不能作为利率数据源、贷款机构报价或贷款审批依据。

填写参数并手动测试 6 个必填 · 0 个可选
参数位置值
query
query
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/mortgage-calculate-deprecated?key=<API_KEY>&downpayment=<downpayment>&hoi=<hoi>&price=<price>&rate=<rate>&tax_rate=<tax_rate>&term=<term>'
GET /api/project/realty-in-us/mortgage-calculate-affordability-deprecated

按收入测算购房预算(旧版,已弃用)

完整文档 →
说明

此旧版 GET 接口根据收入测算购房预算。必填参数包括 annual_income、monthly_debt、debt_to_income_ratio、down_payment、loan_term、interest_rate、tax_rate 和 homeowner_insurance_rate;hoa_fees 与 is_pmi_included 为可选参数。文档中的比率和利率示例采用小数形式,例如 0.43 表示 43% 的债务收入比,0.03119 表示 3.119% 的利率。迁移时需谨慎保留旧版标志参数:is_pmi_included 的说明将其与服役情况关联,并称设为 false 时会将 down_payment 置为零,这与参数名称的表面含义存在冲突,且该行为尚未验证。 现有资料没有此已弃用接口的实测响应。未经验证且不完整的文档示例包含 affordability 对象,其中展示了 calculated_price、debt_to_income_ratio、house_expenses_ratio、hoa_fees、monthly_payment、principal_and_interest、monthly_property_taxes、monthly_home_insurance 和 monthly_mortgage_insurance。示例还包含以数字字符串为键的 range 对象,其嵌套的购房预算明细沿用相同字段。尽管输入示例采用小数,输出示例中的债务收入比却采用百分数数值形式。因此,不能假设输入和输出使用相同的比率尺度;该样本也不足以确定 range 的完整覆盖范围或完整响应结构。 此接口仅用于记录与迁移现有购房预算集成,不建议用于新开发。房贷月供计算与根据收入估算购房预算回答的是不同问题,不能直接视为等价替代。这些计算数值不代表贷款资格认定、贷款审核通过或贷款机构报价。

填写参数并手动测试 8 个必填 · 2 个可选
参数位置值
query
query
query
query
query
query
query
query
更多可选参数 (2)
参数位置值
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/mortgage-calculate-affordability-deprecated?key=<API_KEY>&annual_income=<annual_income>&debt_to_income_ratio=<debt_to_income_ratio>&down_payment=<down_payment>&homeowner_insurance_rate=<homeowner_insurance_rate>&interest_rate=<interest_rate>&loan_term=<loan_term>&monthly_debt=<monthly_debt>&tax_rate=<tax_rate>'
GET /api/project/realty-in-us/mortgage-check-equity-rates-deprecated

查询美国房屋净值贷款利率(已弃用)

完整文档 →
说明

用于房屋净值融资场景的旧版 GET 查询接口,与购房房贷利率比较不同。七个查询参数均为必填项:creditScore、loanAmount、loanProduct、mortgageBalance、propertyValue、state 和 zip。creditScore 接收信用等级类别,而非具体信用分数。loanProduct 支持 HELOC 及文档列出的固定利率房屋净值贷款代码,多种产品以逗号分隔;示例同时选择了 20 年期和 30 年期固定利率产品。propertyValue 虽然表示金额,但仍须使用字符串;loanAmount 和 mortgageBalance 则使用数值。 该弃用接口未观察到实际请求响应。现有文档示例未经验证且内容不完整,其中展示了 disclosures.advertising_disclosure、disclosures.rate_disclosure、meta.count、meta.version 和 rates 数组。示例利率条目包含 advertiser、loanType、loanAmount、loanPayment、apr、annualFee、autoDebitDisc、introApr、introPeriod、maxLTV、minDraw、points、conditions、summary、isEditorial、isSponsored 和 lastUpdated。可见示例中的 loanTerm 与 rate 均为 null,不能假定这两个字段一定返回数值。该示例不足以确认完整响应结构、当前是否有可用利率,或各项财务字段的单位与计费周期。 仅保留此接口作为旧版房屋净值贷款利率功能的迁移参考。接口目录中没有经过验证的现行同类替代接口;购房房贷利率查询或通用还款估算不能直接视为等价替代。示例利率不代表当前贷款机构报价、审批结果或借款资格保证,带有赞助标记的条目也不应被包装成中立排名。

填写参数并手动测试 7 个必填 · 0 个可选
参数位置值
query
query
query
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/mortgage-check-equity-rates-deprecated?key=<API_KEY>&creditScore=excellent&loanAmount=<loanAmount>&loanProduct=HELOC&mortgageBalance=<mortgageBalance>&propertyValue=<propertyValue>&state=<state>&zip=<zip>'
GET /api/project/realty-in-us/mortgage-check-rates-deprecated

按购房或再融资条件比较美国房贷利率(已弃用)

完整文档 →
说明

用于购房或再融资场景的旧版 GET 房贷利率比较接口。所有查询参数均为必填项:creditScore、loanPercent、loanPurpose、loanTypes、points、propertyPrice 和 zip。creditScore 接收文档列出的信用等级类别;loanPurpose 用于选择购房或再融资;loanTypes 可设为 ALL 或一个已记录的固定利率、浮动利率产品代码;points 可设为 all、zero、zero_to_one 或 one_to_two。loanPercent 的文档示例为 85.2,不是小数形式的 0.852;propertyPrice 为数值类型的房产价格。 该弃用接口未观察到实际请求响应。现有文档示例未经验证且内容不完整,其中包含 disclosures.advertising_disclosure、disclosures.rate_disclosure、meta.count、meta.version、布尔值 primary,以及 providers 和 rates 数组。可见利率条目包含 advertiser、aprVal、rate、loanFees、loanPayment、loanTypeDisplayName、points 和 isSponsored,其中 points 在示例中为字符串。该片段不能确认完整字段范围、当前利率、排序规则,也未明确所有财务数值的单位与周期。信息披露与赞助标记只能作为理解结果的背景,不能证明某项产品最适合借款人。 此接口仅作为旧版系统迁移参考。不要在不作说明的情况下,用仅按邮政编码查询利率的接口替换这里的信用类别、融资用途、贷款类型、贷款百分比和点数筛选,否则会丢失尚未验证的条件假设。历史示例数值不代表当前贷款机构报价、利率锁定、借款资格判断或放贷承诺。

填写参数并手动测试 7 个必填 · 0 个可选
参数位置值
query
query
query
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/mortgage-check-rates-deprecated?key=<API_KEY>&creditScore=excellent&loanPercent=<loanPercent>&loanPurpose=purchase&loanTypes=ALL&points=all&propertyPrice=<propertyPrice>&zip=<zip>'
GET /api/project/realty-in-us/mortgage-v2-calculate

使用小数形式的利率和房产税率估算房贷月供

完整文档 →
说明

根据必填查询参数 price、down_payment、hoa_fees、home_insurance、property_tax_rate、rate 和 term 估算住房贷款还款金额;apply_veterans_benefits 为可选布尔参数。首付款 down_payment 填写金额,而不是百分比。年利率和年度房产税率均使用小数形式:rate=0.065 表示年利率 6.5%,property_tax_rate=0.012 表示年度房产税率 1.2%。曾有一次检查使用 6.5 和 1.2,虽然返回 HTTP 200,但计算金额明显偏高,因此不能仅凭请求成功就认定财务输入合理。 已成功核验的情景使用 price=500000、down_payment=100000、hoa_fees=0、home_insurance=100、term=30、apply_veterans_benefits=false,以及上述小数形式的利率和税率。返回的 data.loan_mortgage 包含 loan_amount=400000、rate=0.065、term=30、monthly_payment=3128 和 total_payment=910178。monthly_payment_details 中的 principal_and_interest=2528、property_tax=500、home_insurance=100,三项月度支出合计为 3128。应将 total_payment 单独标注为返回的贷款总额指标,不可将其等同于综合月供乘以 360,也不能假定它包含所有经常性费用。 另有一个未经核验的文档示例使用顶层 mortgage 对象,字段包括 down_payment、hoa_fees、loan_amount、monthly_home_insurance、monthly_mortgage_insurance、monthly_payment、monthly_property_taxes、principal_and_interest、rate、term 和 total_payment。不要假定已观察到的响应也采用这一旧示例结构,或必然提供房贷保险分项。非零 HOA 费用的计算方式,以及启用退伍军人福利后的影响,均未核验。本接口仅用于情景估算,不代表贷款机构报价、资格认定、房产税核定或保险报价。

填写参数并手动测试 7 个必填 · 1 个可选
参数位置值
query
query
query
query
query
query
query
更多可选参数 (1)
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/mortgage-v2-calculate?key=<API_KEY>&apply_veterans_benefits=false&down_payment=100000&hoa_fees=0&home_insurance=100&price=500000&property_tax_rate=0.012&rate=0.065&term=30'
GET /api/project/realty-in-us/mortgage-v2-check-rates

按美国邮政编码查询房贷利率参考信息

完整文档 →
说明

通过必填查询参数 postal_code 请求房贷利率参考信息,填写美国 ZIP 邮政编码,例如 90004。邮编应保留为字符串,以免丢失开头的零。目前没有本接口的请求核验记录,因此实际可用性、邮编覆盖范围、数据时效及返回利率的数值单位均未核验。 现有文档示例并不完整,展示的顶层字段包括 disclosures、meta、primary、providers 和 rates。disclosures 对象包含 advertising_disclosure 与 rate_disclosure,meta 包含 count 与 version。providers 数组中的字段包括 Name、Logo、Url、DisclaimerFull 和 DisclaimerShort。示例中的 rates 记录包含 advertiser、rate、aprVal、loanTypeDisplayName、loanPayment、loanFees、points、isSponsored 和 cpcUrl。以上仅为文档示例字段,不保证当前响应一定提供;示例也未明确数据观测时间或每项金额的含义与单位。 展示数据时应分别标注贷款利率与年化综合成本率(APR),保留适用的披露信息和赞助标识,并在比较还款额或费用前核实贷款假设。未经确认数值口径,不要将返回的利率直接填入房贷计算器。本接口提供按邮编查询的利率参考,不代表个人专属报价、贷款机构承诺、贷款审批通过或保证实时的报价。

填写参数并手动测试 1 个必填 · 0 个可选
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/mortgage-v2-check-rates?key=<API_KEY>&postal_code=90004'

旧版房产接口(已弃用)

GET /api/project/realty-in-us/properties-detail-deprecated

使用成对房源与房产标识获取旧版房产详情(已弃用)

完整文档 →
说明

此旧版房产详情接口仅保留用于兼容与迁移,不建议新项目使用。查询时必须同时提供三个字符串参数:listing_id、property_id 和 prop_status。文档说明 listing_id 与 property_id 应取自房源搜索结果,包括旧版及第二版房源列表接口的结果。务必使用同一条搜索记录中的房源标识与房产标识;两者含义不同,不可相互替代。prop_status 的文档可选值为 for_sale 和 for_rent。listing_id=608763437、property_id=4599450556 等仅为示例,并非已核验的当前有效记录。 目前没有本接口的请求核验记录,因此接口可用性、标识有效性及当前响应约定均未确认。不完整的文档示例使用顶层 listing 对象,其 address 部分展示 city、county、state、state_code、postal_code、line、lat、long、neighborhood_name、neighborhoods 和 time_zone。其他可见 listing 字段包括 beds、baths、baths_full、advertiser_type、agent、branding、broker、client_display_flags、client_display_text、client_event_data 和 client_provider_data。上述均只是文档示例字段,不能保证当前仍会返回、内容完整,或与新版详情响应等价。 迁移前应先盘点已存储的标识组合与状态值,再单独确认当前详情接口的输入要求和输出结构,之后再调整链接或字段映射。接口已弃用并不意味着已有明确下线日期,也不保证服务会持续可用。

填写参数并手动测试 3 个必填 · 0 个可选
参数位置值
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-detail-deprecated?key=<API_KEY>&listing_id=<listing_id>&prop_status=for_sale&property_id=<property_id>'
GET /api/project/realty-in-us/properties-v2-list-by-mls-deprecated

旧版 v2 MLS 房源编号查询(已弃用)

完整文档 →
说明

使用必填的 mls_id 查询旧版房源记录。可选的 prop_status 用于筛选房源状态,接受 for_sale、for_rent 或 recently_sold;limit 控制请求的条数,offset 指定跳过的条数以实现分页。比对记录时应保留 MLS 来源和房源状态信息,现有文档并未证明 MLS 编号在所有来源中全局唯一。 以下响应说明来自文档示例,并非实测输出:留存示例包含 meta.matching_rows、meta.returned_rows 以及 properties 数组。示例中的房产字段包括 property_id、listing_id、price、beds、baths、baths_full、prop_status、prop_type、prop_sub_type、photo_count 和 last_update。address 对象包含 line、city、state、state_code、postal_code、lat 和 lon;mls 对象包含 id、abbreviation、name 和 type。这些字段均来自未经验证的示例,此接口没有实测响应记录,无法确认这些字段当前是否返回、是否完整或接口是否可用。 此接口已弃用,保留说明仅用于梳理旧版按 MLS 编号查询的流程及其迁移要求。不建议新项目以此作为接入入口,也不能将其视为完整的 MLS 数据源。不要假定当前的通用房产搜索接受相同的 MLS 编号查询参数。

填写参数并手动测试 1 个必填 · 3 个可选
参数位置值
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v2-list-by-mls-deprecated?key=<API_KEY>&mls_id=<mls_id>'
GET /api/project/realty-in-us/properties-v2-list-for-rent-deprecated

美国租房查询旧版 v2 接口(已弃用)

完整文档 →
说明

用于梳理旧版租赁房源查询及其迁移要求,不建议用于新项目接入。必填查询参数为 city、state_code、limit 和 offset;可选条件包括价格上下限、最少卧室数与浴室数、房屋面积与地块面积、prop_type、prop_sub_type、allows_cats、allows_dogs、以英文逗号分隔的 features、radius 和 sort。文档给出的示例为 New York City、NY、每次 200 条、偏移量 0,以及 relevance 排序;这些示例并非已确认的服务端默认值。radius 的文档范围为 1–20 英里。位置条件存在需要保留的冲突:文档要求 postal_code 不得与 city、state_code 同时使用,并说明只要 postal_code、city 或 state_code 有值,经纬度边界就不起作用;但此保留契约仍将 city 和 state_code 列为必填。因此,不能宣称仅用邮编或仅用地图边界查询已经得到验证,也不能假定地图边界会进一步限制必填城市和州对应的结果。历史响应文档中的示例片段包含 meta.matching_rows、meta.returned_rows 和 properties 数组;首条记录展示了 listing_id、listing_status、address、beds、building_size、lot_size、community、last_update、list_date 和 photo_count。address 中列有 line、city、state_code、postal_code、lat 和 lon;community 中列有 beds_min、beds_max、baths_min、baths_max、price_min、price_max、sqft_min 和 sqft_max,其中示例中的社区面积上下限均为 null。片段还出现了 photos 字段的开头,但示例已被截断,不能作为完整、可解析的响应。当前没有实测响应,这些历史字段不能证明现有房源可租、宠物政策准确、配套设施信息齐全或响应内容完整。此已弃用接口仅供迁移参考;应逐项清点宠物、房产子类型和设施筛选要求,核实替代接口的契约,不要假定所有旧版条件都能原样迁移。

填写参数并手动测试 4 个必填 · 20 个可选
参数位置值
query
query
query
query
query
query
更多可选参数 (18)
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v2-list-for-rent-deprecated?key=<API_KEY>&city=<city>&limit=<limit>&offset=<offset>&state_code=<state_code>'
GET /api/project/realty-in-us/properties-v2-list-for-sale-deprecated

旧版 v2 待售住宅搜索(已弃用)

完整文档 →
说明

此接口用于记录旧版购房房源搜索方式,查询参数 city、state_code、limit 和 offset 均为必填。可选条件包括价格上下限、房屋面积上下限、地块面积、最低卧室数与浴室数、房龄上下限、prop_type、prop_sub_type、以逗号分隔的 features、搜索半径 radius 和排序方式 sort。开放看房、附条件成交、止赎、3D 看房、新建住宅、尚未建成住宅及待成交房源分别使用 has_open_house、is_contingent、is_foreclosure、is_matterports、is_new_construction、is_new_plan 和 is_pending 布尔参数筛选。文档规定 radius 的范围为 1 至 20 英里。New York City、NY、limit=200、offset=0 和 relevance 排序均为示例值,不是已确认的默认值。 位置条件存在文档冲突:postal_code 被标注为不能与 city/state_code 同用,但 city 和 state_code 又是必填项;lat_min、lat_max、lng_min、lng_max 四个地图边界参数则被标注为在 postal_code、city 或 state_code 有值时不生效。迁移时应把这些冲突列为待核实问题,不应据此宣称支持仅按邮编、仅按地图边界,或城市与边界叠加搜索。 响应信息仅来自文档,而非实际调用结果:被截断的示例片段展示了 meta.matching_rows、meta.returned_rows 和 properties 数组。可见的房源字段包括 property_id、listing_id、price、beds、baths、baths_full、prop_status、prop_type、prop_sub_type、photo_count、last_update、address 和 mls。address 对象展示了 line、city、state_code、postal_code、lat 和 lon;mls 对象展示了 id、abbreviation、name 和 type。该片段不是可完整解析的响应,目前也没有实测响应可供核对。这些历史字段不能证明当前房源可用性、响应完整性、开放看房安排或看房媒体数据是否存在。 此弃用接口仅供旧版购房搜索迁移参考。替换时应逐项核对开放看房、未建成住宅、新建住宅和房源状态等需求,不能假定当前房源搜索接口接受同样的 GET 查询参数,或具有完全相同的筛选含义。

填写参数并手动测试 4 个必填 · 27 个可选
参数位置值
query
query
query
query
query
query
更多可选参数 (25)
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v2-list-for-sale-deprecated?key=<API_KEY>&city=<city>&limit=<limit>&offset=<offset>&state_code=<state_code>'
GET /api/project/realty-in-us/properties-list-by-mls-deprecated

按 MLS 编号查询房源(已弃用)

完整文档 →
说明

此 MLS 编号查询接口已弃用,仅适用于维护、核查现有的旧版房源查询流程,不建议用于新接入。必填参数 mls_id 为字符串;可选参数 limit 和 offset 分别控制请求条数和跳过的条数。文档列出的排序值为 price_low、price_high、photos、newest 和 open_house_date。MLS 编号并不保证在所有 MLS 系统中全局唯一,对账时应同时保留所属 MLS 的信息。现有材料中没有实际请求返回的响应,只有未经验证的文档示例,包含 listings 数组、matching_rows 和 returned_rows 计数,以及 meta 对象。示例房源字段包括 property_id、listing_id、mls.id、mls.name、mls.abbreviation、address、address_new、beds、baths、prop_type、prop_sub_type、prop_status、price、price_raw、sqft、sqft_raw、photo_count、list_date 和 last_update。其中 address_new 包含 city、state_code、postal_code、lat 和 lon。示例中的 price 和 sqft 是用于展示的字符串,price_raw 为数值,sqft_raw 为 null;解析时应处理字段缺失和空值,不能假定所有金额、面积字段都是数值。上述示例字段不代表已经确认的当前响应约定。现行的通用房源搜索接口也不一定提供等效的 MLS 编号筛选,迁移前必须核实替代接口的实际行为。

填写参数并手动测试 1 个必填 · 3 个可选
参数位置值
query
query
query
更多可选参数 (1)
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-list-by-mls-deprecated?key=<API_KEY>&mls_id=<mls_id>'
GET /api/project/realty-in-us/properties-list-for-rent-deprecated

搜索出租房源(已弃用)

完整文档 →
说明

此租房搜索接口已弃用,仅适用于核查现有租房应用,并按筛选条件逐项规划迁移。旧版参数结构将 city、state_code、limit 和 offset 标记为必填。city 和 state_code 应使用地点自动补全返回的值。文档将 postal_code 描述为另一种地点输入方式,且规定不能与 city、state_code 同时使用,但后两项在参数结构中仍为必填,因此仅传邮编的请求尚未验证。文档还说明,只要 postal_code、city 或 state_code 中任一项有值,lat_min、lat_max、lng_min 和 lng_max 四个地图边界参数就不起作用;不能将地图边界描述为可进一步缩小必填城市、州查询范围的有效条件。可选筛选涵盖价格、最少卧室和卫生间数量、房产面积、房产类型、挂牌日期、以英里计的搜索半径、宠物政策标记和社区配套设施。allows_cats、allows_dogs 均不能与 no_pets_allowed 同时使用。prop_type 和 mapi_community_features 支持以逗号分隔文档列出的值。sort 的说明列出 completeness、photos、freshest、price_low、price_high 和 newest,但示例使用 relevance,这一差异尚未解决。现有材料没有实际租房请求的响应,只有截断且未经验证的文档示例。该片段以 listings 数组开头,包含 property_id、listing_id、address、address_new、beds、baths、pet_policy、has_specials、price、price_raw、price_reduced、price_reduced_date、sqft、photo、photo_count、prop_type、prop_status、list_date 和 last_update。片段中的 beds、baths、price 和 sqft 是字符串,price_raw 为数值;address_new 包含 city、state_code、postal_code、lat 和 long。由于示例不完整,无法据此确认完整响应结构、当前字段可用性、数据时效性或请求能否成功。迁移已保存的租房搜索条件前,必须明确核实宠物政策与社区设施筛选是否存在等效支持,不应静默丢弃不受支持的条件。

填写参数并手动测试 4 个必填 · 19 个可选
参数位置值
query
query
query
query
query
query
更多可选参数 (17)
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-list-for-rent-deprecated?key=<API_KEY>&city=<city>&limit=<limit>&offset=<offset>&state_code=<state_code>'
GET /api/project/realty-in-us/properties-list-for-sale-deprecated

按旧版条件搜索美国待售房源(已弃用)

完整文档 →
说明

此待售房源搜索接口已弃用,仅适合维护旧版购房搜索表单,以及核对已保存搜索条件的迁移情况,不建议用于新接入。旧版参数定义要求填写 city、state_code、limit 和 offset,其中 city 与 state_code 应使用地点自动补全返回的值。文档同时将 postal_code 列为城市与州的替代定位方式,且要求两者不得同时使用,但这与 city、state_code 的必填定义存在冲突;仅凭邮编搜索的行为尚未验证。四个范围坐标参数 lat_min、lat_max、lng_min、lng_max 在 postal_code、city 或 state_code 任一有值时均被描述为无效,因此不能将它们视为必填城市与州搜索之上的有效范围限制。 可选购房条件包括价格、卧室数、浴室数、房龄、房屋面积、地块面积、挂牌日期、以英里计的搜索半径,以及用逗号分隔的房产类型和设施特征。is_contingent、is_foreclosure、is_matterports、is_new_construction、is_pending 为布尔参数,分别涉及附条件成交、止赎、3D 看房、新建房和待完成交易房源。reduced 则保留为字符串参数,文档值为 true 或 false,不能与上述布尔参数混为一谈。排序值包括 relevance、price_low、price_high、photos、newest、open_house_date、sqft_high 和 price_reduced_date。 现有材料未提供实际调用得到的待售搜索响应。唯一的文档示例不完整且未经验证,以 listings 数组开头,包含 property_id、listing_id、address、address_new、beds、baths、baths_full、price、price_raw、sqft、sqft_raw、prop_type、prop_sub_type、prop_status、is_new_construction、is_new_listing、photo_count、list_date、last_update,以及含 id、name、abbreviation 的 mls 对象。片段中,beds 与 baths 为数值,price 与 sqft 为展示字符串,price_raw 为数值,sqft_raw 为 null;address_new 包含 city、state_code、postal_code、lat 和 lon。该片段无法证实完整响应结构、结果总数、当前字段可用性或请求能否成功。迁移前应逐项核实购房状态和设施条件,尤其是止赎、待完成交易和降价筛选;不得默默丢弃没有已验证替代方式的条件。

填写参数并手动测试 4 个必填 · 26 个可选
参数位置值
query
query
query
query
query
query
更多可选参数 (24)
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-list-for-sale-deprecated?key=<API_KEY>&city=<city>&limit=<limit>&offset=<offset>&state_code=<state_code>'

旧版相似房源查询(已弃用)

GET /api/project/realty-in-us/properties-list-similarities-deprecated

按房产 ID 查询相似房源(已弃用)

完整文档 →
说明

通过已弃用的旧版接口获取相似房源推荐。三个查询参数均为必填项:property_id 是房源列表结果中的数值型房产标识,prop_status 用于选择 for_sale(出售)或 for_rent(出租),limit 指定希望获取的推荐数量。这些结果仅是推荐候选房源,不是经过核实的已成交可比房产,也不能作为房产估价。 此接口暂无实测响应记录。现有旧版响应示例已截断且未经验证,因此示例字段不代表当前接口保证返回的数据结构。示例中,results.similar_homes.count 表示数量,results.similar_homes.properties 存放推荐房源。房源条目包含 property_id、listing_id、status、list_price、list_date、last_update_date、location、photos 和 primary_photo。description 对象包含 beds、baths、sqft、lot_sqft、type 和 year_built;additional_info 则包含展示文本以及 compared_price_diff、compared_sqft_diff 等比较字段。last_sold_price 等价格字段可能为 null。不能据此推断确切的推荐排序规则、与新版接口相同的覆盖范围,或已经确认的成交价格。替换旧版推荐组件时,应核对标识映射并处理字段缺失情况。

填写参数并手动测试 3 个必填 · 0 个可选
参数位置值
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-list-similarities-deprecated?key=<API_KEY>&limit=<limit>&prop_status=for_sale&property_id=<property_id>'
GET /api/project/realty-in-us/properties-v2-list-similar-homes-deprecated

按房产 ID 查询相似待售住宅(已弃用)

完整文档 →
说明

此旧版接口用于查询与指定参考房产相似的待售住宅。必填查询参数 property_id 为字符串,应使用房源列表响应中返回的 property_id。该接口已明确弃用,仅用于梳理或迁移现有的待售房源推荐流程。弃用说明指向 /properties/v2/list... 系列接口,但未确认其中存在等价替代接口,也未确认推荐排序保持一致。 目前没有此操作的实测响应或文档响应示例。因此,响应结构、结果字段名、推荐条数、排列顺序以及当前可用性均未经核实。

填写参数并手动测试 1 个必填 · 0 个可选
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v2-list-similar-homes-deprecated?key=<API_KEY>&property_id=<property_id>'
GET /api/project/realty-in-us/properties-v2-list-similar-rental-homes-deprecated

根据邮政编码和房产 ID 查找相似出租房(已弃用)

完整文档 →
说明

此旧版接口用于查找与指定参考房产相似的出租房。postal_code 和 property_id 均为必填的字符串查询参数:postal_code 应取自房源列表响应,property_id 应取自房产列表响应。仅提供邮政编码不构成完整请求,现有文档也未说明可配置搜索半径。 该接口已明确弃用。弃用说明指向 /properties/v2/list... 系列接口,但未确认其中存在功能等同的出租房推荐接口。目前没有该接口的实测响应或文档响应示例,因此响应外层结构、出租状态字段、租金报价字段、排序方式以及空结果格式均未验证。推荐的出租候选房源不代表已完成的租赁交易,也不能用于证明实际成交租金。

填写参数并手动测试 2 个必填 · 0 个可选
参数位置值
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v2-list-similar-rental-homes-deprecated?key=<API_KEY>&postal_code=<postal_code>&property_id=<property_id>'

旧版已售房源列表(已弃用)

GET /api/project/realty-in-us/properties-list-sold-deprecated

按旧版筛选条件查询已售房源(已弃用)

完整文档 →
说明

通过已弃用的接口查询已售住宅房源记录。请求要求提供 city、state_code、limit 和 offset。可选筛选条件包括价格、房龄、房屋面积、地块面积、房产类型、以英里为单位的搜索半径、邮政编码、经纬度边界以及排序方式。prop_type 支持用英文逗号分隔多个文档列出的类型:single_family、condo、mobile、multi_family、farm 和 land。offset 表示分页时跳过的记录数,不是页码。 位置参数的文档限制需要特别留意:postal_code 不能与 city 或 state_code 同时使用;只要 postal_code、city 或 state_code 中任一参数有值,经纬度边界就不生效。但当前请求约定仍要求填写 city 和 state_code,因此不能认定此接口支持仅按邮编或仅按经纬度边界查询。应保留这些约束,不要擅自省略必填参数。sort 的说明列出 price_low 和 price_high,示例却使用 relevance;该示例是否被接受尚未验证。文档没有给出 limit 的上限,也未完整说明排序行为。 此接口暂无实测响应记录。现有响应示例已截断且未经验证。可见的 listings 数组包含 property_id、listing_id、prop_status、prop_type、sold_date、list_date、last_update、address、结构化地址 address_new、经纬度、beds、baths、photo 和 photo_count。示例还区分用于展示的格式化 price、sqft 与原始值 price_raw、sqft_raw。这些字段不代表当前接口保证返回的数据结构。价格筛选条件和 price_raw 本身都不能证明价格是经核实的实际成交价。审查或迁移历史已售房源查询时,应记录请求日期及候选房产标识。

填写参数并手动测试 4 个必填 · 16 个可选
参数位置值
query
query
query
query
query
更多可选参数 (15)
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-list-sold-deprecated?key=<API_KEY>&city=<city>&limit=<limit>&offset=<offset>&state_code=<state_code>'

旧版房产详情(已弃用)

GET /api/project/realty-in-us/properties-v2-detail-deprecated

旧版 v2 房产详情查询(已弃用)

完整文档 →
说明

通过已弃用的 v2 详情接口查询房产信息。唯一有文档说明的输入是必填查询参数 property_id,类型为字符串,取自房源列表结果。请原样保留标识:文档示例 O3599084026 以字母开头,转为数值可能改变请求。此接口未提供按地址、listing_id 或地理位置搜索的参数。 现有资料未记录此接口的实测响应。留存的旧版示例不完整且未经验证,不能据此确认接口当前可用,也不能视为完整的响应约定。示例可见部分包含 meta 对象及其中的 matching_rows、returned_rows、schema 字段,以及 properties 数组。房产字段包括结构化地址及其中的坐标、邮编、州代码、社区信息和 time_zone;还包括 beds、baths、baths_full、building_size.size、building_size.units、description,以及嵌套的 agents、broker、buyer_agent_for_far 和 buyer_office 对象。可见示例中的 cooling、heating 等可选属性为 null。 迁移房产详情页或缓存记录时,应将这个以数组承载房产的示例结构与替代接口的响应分别处理。不要假定响应顶层是单个房产对象,也不要假定字段齐全、嵌套结构稳定或两种结构可以直接互换。需区分请求获取失败、字段缺失和属性值为 null,并明确检查标识是否被原样保留、字段是否正确映射。

填写参数并手动测试 1 个必填 · 0 个可选
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v2-detail-deprecated?key=<API_KEY>&property_id=<property_id>'
GET /api/project/realty-in-us/properties-v2-list-sold-deprecated

按旧版筛选条件分页查询已售房产(已弃用)

完整文档 →
说明

此已弃用的已售房产搜索接口要求提供 city、state_code、limit 和 offset 查询参数。city 和 state_code 应使用地点自动补全结果中的字符串;limit 是请求每页返回条数的数值,offset 是分页时跳过记录数的数值。可选数值筛选条件包括房龄、最少卧室数和卫生间数、价格、建筑面积、地块面积、经纬度边界,以及 1 至 20 英里的搜索半径。prop_type 支持文档列出的房产类型,多个值用逗号分隔;sort 支持 sold_date、beds_high、price_low、price_high 和 lot_sqft_high。 文档中的位置参数存在约束冲突:postal_code 不应与 city/state_code 同时使用,但此保留的接口约定仍将 city/state_code 列为必填项。文档还说明,只要 postal_code、city 或 state_code 有值,经纬度边界就不会生效。因此,不应承诺仅凭邮政编码或仅凭边界框即可查询。 目前没有该接口的实测响应。文档中一个未经验证且已截断的示例包含 meta.matching_rows、meta.returned_rows,以及 properties 数组;数组条目中有 property_id、listing_id、prop_status、prop_type、price、beds、baths、baths_full 和可为 null 的 baths_half。示例还包含地址字段 line、city、state_code、postal_code、lat 和 lon,带有 size 与 units 的 building_size、lot_size 对象,以及 photo_count、photos、list_date 和 last_update。这些只是文档示例中的字段,既不是已验证的响应结构,也不保证当前仍可获得。示例不能证明 price 是实际成交价,也不能证明 list_date 是交易交割日期。 此接口适合保留用于旧版迁移审查。在将结果用于估值之前,应独立核实已售状态及交易字段。

填写参数并手动测试 4 个必填 · 18 个可选
参数位置值
query
query
query
query
query
更多可选参数 (17)
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v2-list-sold-deprecated?key=<API_KEY>&city=<city>&limit=<limit>&offset=<offset>&state_code=<state_code>'

房产与房源

GET /api/project/realty-in-us/properties-v3-detail

根据房产 ID 获取美国房产详情

完整文档 →
说明

使用房产搜索结果中的必填 property_id,获取选定美国住宅的详情。可选 listing_id 用于传入搜索结果中的具体房源上下文,不能替代 property_id。两个输入都是字符串查询参数。 实测成功响应将房产放在 data.home 下,返回了 property_id、listing_id、list_price、last_update_date、地址信息、描述文本和照片。该次核验记录的 list_price 为 1325000,包含 75 张照片;这只是单条记录的观测结果,不是固定取值,也不保证其他房产具有相同的媒体覆盖。last_update_date 应理解为返回记录的时间戳,不能据此保证整个房源数据集的时效性。 判断结果时,必须同时检查响应体和 HTTP 状态。实测无效 property_id 返回了 HTTP 200,但 data.home 为 null,且 errors 中包含 extensions.code=HTTP_ERROR 和 extensions.data.code=500。不能把所有 HTTP 200 都视为已找到房产,也不能把所有空房产结果都当作没有错误的“未找到”。 接口文档提及 Home Value(房屋价值)功能,但现有成功实测并未确认估值字段名称、自动估值模型或历史估值序列。保留的文档示例已截断,偏重房源信息且未经验证,不应据此推翻实测的 data.home 响应结构。

填写参数并手动测试 1 个必填 · 1 个可选
参数位置值
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v3-detail?key=<API_KEY>&property_id=<property_id>'
GET /api/project/realty-in-us/properties-v3-get-commute-time

查询美国房源到指定地址的通勤时间

完整文档 →
说明

请求查询美国房源到目的地地址的出行时间。必填查询参数为 property_id 和 destination_address,均以字符串传入;property_id 应取自房源搜索结果。目的地尽量填写完整地址,并补充城市、州等信息;地点自动补全功能可用于获取更完整的地址。 可选参数 transportation_type 支持文档列出的 bicycling(骑行)、driving(驾车)、transit(公共交通)和 walking(步行)。walking 只是示例值,并非已确认的默认值。可选布尔参数 with_traffic 用于表达是否请求高峰时段耗时计算;false 同样只是文档示例,省略时的默认行为尚未验证。这些输入选项不代表接口已确认具备实时路况覆盖,也不保证每条行程都支持全部出行方式。 目前没有该接口的实测响应。现有响应示例已被截断,且开头是房源列表数据,无法识别出通勤结果,因此尚不能确认通勤响应的字段名称、耗时单位、路线几何数据或交通预测字段。解析耗时或展示房源间的数值对比前,请先核实实际响应结构,不要仅凭接口名称假定耗时字段或单位。

填写参数并手动测试 2 个必填 · 2 个可选
参数位置值
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v3-get-commute-time?key=<API_KEY>&destination_address=<destination_address>&property_id=<property_id>'
GET /api/project/realty-in-us/properties-v3-get-photos

按房产 ID 获取美国房源照片图库

完整文档 →
说明

通过必填的 property_id 查询参数,获取美国房产关联的照片;该标识应取自房源搜索结果。本接口不接受 listing_id,也没有分页控制、图片尺寸选择或文档列明的照片筛选参数。 实测成功响应中的匹配记录位于 data.home_search.results,而非直接位于 data.home。该次响应包含一条结果,带有 property_id、listing_id 以及 75 张照片,照片条目中可见图片 URL 和图片标签。请遍历 results 集合,将照片与返回的标识关联,并兼容空集合或缺少媒体的情况。75 张仅是某套房产的实测数量,不代表固定图库大小或照片覆盖保证。实测摘要未记录图片 URL 和标签的具体成员名,绑定图片组件前需先核对。 现有示例已被截断,且内容偏向房源列表;该示例未经验证,不能据此认定存在另一套响应结构。按房产标识查询,不代表照片始终属于某条固定挂牌记录,也不保证图片顺序固定或链接长期有效。返回的图片 URL 只是媒体访问引用,并非图片再分发或商业使用许可;存储或重新发布照片前,请先确认相关使用权。

填写参数并手动测试 1 个必填 · 0 个可选
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v3-get-photos?key=<API_KEY>&property_id=<property_id>'
GET /api/project/realty-in-us/properties-v3-get-surroundings

查询美国房产周边信息,可选择包含洪水相关信息

完整文档 →
说明

通过 GET /properties/v3/get-surroundings 请求查询单套美国住宅的周边信息。必填查询参数 property_id 应使用房源列表接口返回的 property_id,而非 listing_id。可选布尔参数 enable_flood 用于控制是否包含洪水相关信息;false 是文档示例值,并非已验证的服务端默认值。 现有资料中没有成功的实测响应,也没有可解析的 JSON 响应示例,因此响应字段名称、嵌套结构、覆盖范围及洪水信息的具体值均尚未验证。不要假定响应必定包含洪水分区、风险评分、地图几何数据或任何特定的社区指标。将可用的周边信息作为补充背景;缺少环境信息时应标记为未知,而不是安全。权威洪水判定或保险评估应另行获取。

填写参数并手动测试 1 个必填 · 1 个可选
参数位置值
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v3-get-surroundings?key=<API_KEY>&property_id=<property_id>'
POST /api/project/realty-in-us/properties-v3-list

搜索美国在售、出租或已售住宅房源

完整文档 →
说明

通过 POST /properties/v3/list 搜索住宅房源,可选择提交 JSON 请求体。文档列出的字段包括字符串 state_code、数组 status 和 type、对象 list_price、beds、baths 和 sort、布尔值 cats 和 dogs,以及整数 limit 和 offset;没有请求体字段被标为必填。一次返回 HTTP 200 的成功调用使用了 state_code="CA"、status=["for_sale"]、limit=3、offset=0 和 sort={"direction":"desc","field":"list_date"}。这仅验证了该组加利福尼亚州在售房源查询条件,不代表所有州、房源状态、住宅类型或筛选组合均已验证。现有证据尚未确定 list_price、beds 和 baths 的嵌套结构、其他排序值、数组枚举值及宠物筛选行为,不应从其他接口套用邮编请求体或筛选语法。 已观察到的响应包含 data.home_search.count、total 和 results。样本中 count=3,results 也包含三条房源,而 total=161224 表示更大范围内符合条件的总数,并非当前页行数。结果中已观察到 property_id、listing_id、status、list_price、list_date、last_sold_date 和 last_sold_price;location.address 下包含 line、city、postal_code、state_code、state、country 和 coordinate。description 对象包含 type、sub_type、beds、baths、baths_full 和 sqft。primary_photo、photo_count 以及部分面积和标记字段可能为 null。后续查询时应分别保留 property_id 与 listing_id,两者不可混用。 样本地址位于加利福尼亚州,挂牌日期包含 2026-10-22,但这不能证明房源覆盖完整、数据实时更新或每条记录的字段都非空。本接口没有另附响应示例,上述响应字段均来自这次成功调用。

填写参数并手动测试 0 个必填 · 11 个可选
参数位置值
body
body
body
body
body
body
body
更多可选参数 (4)
参数位置值
body
body
body
body

调用成本暂不可用,未假定任何价格。

查看价格
curl -X POST 'https://api.opendata-api.com/api/project/realty-in-us/properties-v3-list?key=<API_KEY>'
GET /api/project/realty-in-us/properties-v3-list-similar-homes

根据指定房产查找相似住宅

完整文档 →
说明

通过 GET /properties/v3/list-similar-homes 请求相似住宅候选房源。必填查询参数 property_id 应取自房源列表结果中的 property_id 字段,不能使用 listing_id。可选查询参数 status 为单个字符串,文档列出的取值包括 for_sale、ready_to_build、for_rent、sold、off_market、other 和 new_community。可选数值参数 limit 用于控制每次响应的条目数量;10 只是文档示例,并非已验证的默认值或上限。本接口仅提供 limit 来控制返回数量,没有文档说明支持 offset、页码或游标参数。 现有证据没有成功调用的响应,也没有响应示例,因此响应外层结构、候选房源字段、实际返回数量、相似性标准、排序方式和地理范围均未验证。应将返回的住宅展示为备选建议,并在比较前核对其位置、房源状态和住宅属性,不应将本接口作为可比成交案例估价或房产估值依据。

填写参数并手动测试 1 个必填 · 2 个可选
参数位置值
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v3-list-similar-homes?key=<API_KEY>&property_id=<property_id>'

学校与学区

GET /api/project/realty-in-us/schools-detail

按学校 ID 查询美国单所学校详情

完整文档 →
说明

通过 GET /schools/detail 获取一所学校的详细信息。必填查询参数 id 是已有学校标识的字符串,不是学校名称、学区 ID、房产 ID 或地址。文档将学校列表结果中的 schools[].id 列为标识来源,但相关学校搜索接口不可用,不能依赖它来查找 ID。应使用通过其他途径确认的学校 ID,并原样传入。 本接口的响应覆盖范围尚未验证:现有证据既没有成功调用的响应,也没有响应示例,因此响应外层结构和任何具体详情字段均未确定。验证实际响应前,尤其不应承诺一定提供名称、地址、评分、联系方式、在校人数、招生范围或所属学区。无效或缺失 ID 的处理方式以及字段是否可能为空,同样没有文档说明。 可将结果用于补充已知学校记录,同时保留数据来源,并明确标注缺失数据。学校详情查询不能证明某处房产划归该校、某名学生具备入学资格,也不能证明记录完整或为最新信息。

填写参数并手动测试 1 个必填 · 0 个可选
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/schools-detail?key=<API_KEY>&id=<id>'
GET /api/project/realty-in-us/schools-get-school-district

按学区 ID 查询美国学区信息

完整文档 →
说明

通过 GET /schools/get-school-district 查询指定学区的详细信息。必填查询参数 id 为字符串,必须填写已核实的学区标识。此接口查询的是学区,而非单所学校,也不支持根据地址查找所属学区。文档将学校列表结果中的 districts[].id 标注为学区标识来源,但所引用的学校搜索接口目前无法作为标识发现的前置依赖。请从其他获授权的来源核实学区 ID,并保留其原始值。 本接口未提供成功验证的响应或响应示例,因此响应外层结构及学区记录字段均未经确认。现有资料不能证明响应一定包含学区名称、地址、所属学校列表、联系方式、边界几何数据、评分、入学规则或记录不存在时的错误格式。请勿承诺返回这些内容,也不要套用其他学校接口的响应结构。 学区信息面板应仅展示已在实际响应中核实的字段,并保留数据缺失和来源标记。学区资料本身不能确定房产对应的入学片区、分配学校或学生入学资格;这些事项均须向官方核实最新信息。

填写参数并手动测试 1 个必填 · 0 个可选
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/schools-get-school-district?key=<API_KEY>&id=<id>'

旧版学校接口(已弃用)

GET /api/project/realty-in-us/schools-list-nearby-deprecated

按经纬度查询附近学校(旧版接口,已弃用)

完整文档 →
说明

已弃用:GET /schools/list-nearby 仅供审查或迁移现有集成,不建议用于新开发。文档说明此接口用于列出房产位置附近的学校。请求必须同时提供两个数值型查询参数:lat 为纬度,lon 为经度,均使用十进制度坐标。文档示例为 lat=35.129431、lon=-117.937021。未列出房产 ID、地址、搜索半径、分页、年级筛选或入学分配相关输入。 本接口未提供实际在线验证的响应。资料中有一份标注为 HTTP 200 的未验证示例,但内容已截断,既不是完整有效的 JSON 响应,也不能证明接口当前仍可用。可见的顶层字段包括 districts(示例中为空数组)、meta.build 和 schools。其中一条完整的学校记录包含 id、name、greatschools_id、nces_id、funding_type、education_levels、grades.range.low、grades.range.high、lat、lon 和 distance_in_miles;还展示了 district.id、district.name,location 下的 city、city_slug_id、county、postal_code、state、street,以及 phone、ratings.great_schools_rating、ratings.parent_rating、relevance、student_count、student_teacher_ratio、boundary_trimmed.type 和嵌套的 boundary_trimmed.coordinates。 这些仅是示例中可见的字段,并非当前已验证或保证返回的内容。示例中的 ratings.great_schools_rating 值为 null,空的 districts 数组也不足以确认学区列表的记录结构。不能据此假定结果排序固定、学校覆盖完整、搜索半径稳定、评分采用某一固定量表,或在校人数等统计数据及时更新。地理距离和示例中的边界几何数据都不能证明学校分配关系或入学资格。 此接口只应用于梳理现有的附近学校查询依赖及其可空字段。在承诺继续提供附近学校数据前,请独立验证替代方案;不要将不可用的学校搜索接口当作替代方案或获取 ID 的前置步骤。

填写参数并手动测试 2 个必填 · 0 个可选
参数位置值
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/schools-list-nearby-deprecated?key=<API_KEY>&lat=<lat>&lon=<lon>'

可接入的房产数据能力

为美国住宅搜索、房产详情展示、经纪人检索和房贷月供估算提供结构化数据。新项目优先使用当前版本的房产、地点、经纪人与房贷操作;保留的已弃用接口仅供维护或迁移已有系统。

  • 房源查询:按所选接口支持的条件筛选,分别保存房产标识与房源标识
  • 详情与照片:根据房产 ID 获取可用的描述、房源信息和照片列表
  • 地点补全:将输入的地点文字转换为候选位置,也允许正常返回空候选
  • 经纪人检索:按邮编及可选条件筛选,再用对应标识查询资料、房源、评价或推荐
  • 房贷估算:在明确利率、税率和费用假设后,区分本息、房产税、保险与总月供
  • 位置背景:按各接口要求准备标识,查询通勤、周边环境、学校或学区资料

适用于美国房源搜索产品、经纪业务工具、搬迁研究与月供比较页面,不是中国境内房源库或宏观房价指数。数据覆盖和可用字段因记录而异;房源与图片数据不附带 MLS 访问或图片转载授权,房贷估算也不构成贷款报价或审批。

相关指南