自助式房产数据 API
来自 Housing Market Group 各门户的房源与市场数据。尽在一个 API。
在控制台中订阅：选择国家和级别，登记您的服务器并完成付款，您的密钥随即生效。两个级别都返回包含全部房产信息的房源；汇总的市场洞察一经推出，高级版即可通过同一个密钥获取。之后添加国家，同一个密钥即可覆盖。
curl -H "x-api-key: $HMA_API_KEY" \
"https://api.housingmarketapi.com/v1/properties?country=TH&listing_type=sale&property_type=condominium&limit=100"使用流程
从注册到发出第一个请求，无需与销售人员沟通
选择覆盖范围
逐个选择国家，或选择某个区域或全球，再选择标准版或高级版，按月或按年计费。
登记您的服务器
您的密钥只响应来自您所登记 IP 地址的请求，因此无法在其他任何地方使用。
接受条款并付款
阅读并接受 API 使用条款，然后付款。付款成功后即创建您的密钥，且只向您显示一次。
调用 API
在 x-api-key 请求头中发送密钥，即可读取返回的 JSON。之后添加国家或升级，同一个密钥即可覆盖。
级别不同，价格相同
选择 API 返回的内容
无论哪种方案，标准版与高级版的价格都相同。您可以稍后升级，同一个密钥即可覆盖。
标准版
已发布的房源，包含参考文档中描述的全部房产信息。
高级版
包含标准版的全部内容，另加即将推出的 Insights（按地点和时期汇总的市场数据）。Insights 一经推出，高级版客户即可通过同一个密钥使用。
为集成而设计
用来构建产品，而不是用来复制数据
游标分页
跟随游标逐页读取。没有页码，没有总数，也没有批量导出。
一个密钥，范围与您的方案一致
您的密钥包含您所选的国家和级别。新增的国家和升级会在付款确认后立即应用于同一个密钥。
可据以分支处理的错误
每个错误都带有 HTTP 状态码和稳定的错误代码，在所有语言的文档中完全一致。
机器可读的规范
一个 OpenAPI 3.1 文件、据此生成的参考文档，以及可在线阅读或下载为 PDF 的集成指南。
关于数据，坦诚相告
您能获得什么，又可以如何使用
- 描述中的联系方式已被删除，任何级别都不会返回发布者、房产经纪人、业主或咨询数据。
- 业主自行发布的房屋，返回时不含门牌号，且位置经过模糊处理。
- 房源目前不含图片。图片链接将于日后提供；原始照片仍在各门户上公开展示。
- 数据仅供在您自己的产品内使用，不得转售、作为数据集重新发布或转交他人。
覆盖范围
按国家、按区域或全球购买
每个国家的数据都来自一个 Housing Market Group 门户。房源数量尚不足以单独销售的国家会标记为“即将推出”。
亚太地区
亚洲、澳大利亚、新西兰及太平洋地区
- Australia
- Cambodia
- China
- Hong Kong
- India即将推出
- Indonesia
- Japan
- Malaysia
- Philippines
- Singapore
- Taiwan即将推出
- Thailand
- Vietnam
中东
包括埃及
- Bahrain即将推出
- Dubai, UAE
- Egypt
- Oman
- Qatar
- Saudi Arabia即将推出
欧洲
包括土耳其和塞浦路斯
- Cyprus
- Germany
- Spain
- Turkey
- United Kingdom
美洲
北美洲、中美洲和南美洲，夏威夷计入美国
- Argentina
- Brazil
- Canada即将推出
- Colombia
- Mexico
- Panama
- Paraguay
- United States
- Uruguay
- Venezuela