点评口碑 · 数据 API

Realtor API

Q: 「按 Realtor 房源状态整理挂牌与已售记录」怎样接入 Realtor API？

用 property_search 查房源，把出售、出租和已售记录分开比较。 keyword 填美国五位邮编或 城市，州缩写；status 使用单个字符串，例如 for_sale、for_rent、sold，不要传数组。结合 id、status、price、sold_price 与 sold_at 区分价格标准。 price 可能取挂牌价，也可能回落到已售价，不能仅凭字段名判断成交；sort=list_price 仍是降序，不支持用 price_asc 表示低价优先。

Q: 「按 Realtor 房源编号核对住宅详情」怎样接入 Realtor API？

从房源链接定位单套住宅，核对面积、房型和最近记录。 url 优先填含 _M数字-数字 后缀的详情链接，也可填房源 ID 或完整地址；结合 id、address、beds、baths、area_sqft 与 updated_at 核对同一房屋。 area_sqft 是平方英尺，不是平方米；sold_price 与 sold_at 缺失不等于从未成交，updated_at 也不是本次查询时间或实地验房日期。

按地区查找 Realtor 经纪人，或按出售、出租和已售状态整理美国住宅房源；详情保留房型、面积及成交记录字段，便于核对房屋与经纪服务信息。调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始看文档

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Realtor 能力清单

action	必填参数	可选参数	单次条数	模式	单价	返回字段
search	keyword	agent_type, min_rating	默认 100 · 最多 500	同步	$1.39 / 千次	id · name · url · title · text · office_name · broker_name · city · state · postal_code · country · license_no · rating · rating_scale · review_count · active_listings · recently_sold · price_min · price_max · specialties · languages · served_areas · emails · phones · image_url · platform
property_search	keyword	baths_min, beds_min, city, max_price, min_price, sort, status	默认 20 · 最多 200	同步	$1.39 / 千次	id · url · title · status · price · sold_price · sold_at · listed_at · property_type · beds · baths · area_sqft · lot_sqft · year_built · address · city · state · postal_code · county · lat · lng · image_url · photo_count · is_new_listing · is_price_reduced · is_foreclosure · platform
property_detail	url	—	—	同步	$1.39 / 千次	id · url · title · status · price · sold_price · sold_at · updated_at · property_type · beds · baths · area_sqft · year_built · address · city · state · postal_code · platform

Realtor 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。请求都发到 POST /api/v1/social，切换 action 时，也要按对应接口调整参数。同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

怎么调用 Realtor 关键词搜索 API？

search

使用 platform="realtor"、action="search" 调用“关键词搜索”能力；返回列表，默认 100 条、单次最多 500 条，主要包含 id、name、url、title、text、office_name 等 26 个字段。

Realtor search 的参数分别是什么意思？

keyword必填: 按城市和州查找经纪人，例如 Austin, TX；也可填写美国邮编，不是经纪人姓名搜索。
agent_type可选: 经纪人类型：both 同时包含买方和卖方（默认），buyer 买方经纪，seller 卖方经纪；不是房源状态。
Realtor 的经纪人搜索区分 Buy、Sell 和 Both，并说明买方经纪人与挂牌卖方经纪人的角色不同。这里解释从业者类别，不表示 EveryInfra 提供经纪代理服务。官方来源：Realtor：买方与卖方经纪人的区别来源核查：2026-09-04
查看全部 3 个允许值
bothbuyerseller
min_rating可选: 最低经纪人星级，可传 0–5 的单值或数组，例如 4 或 ["4"]；0 表示不按评分过滤。这里不是房屋评级。
查看全部 6 个允许值
012345

Realtor 特有返回字段与含义（14）

price_min: 价格区间下限（经纪人成交区间里用）。
price_max: 价格区间上限。
state: 州。
postal_code: 邮编。
broker_name: 经纪公司名称。
office_name: 经纪办公室名称。
license_no: 经纪人执业牌照号，可用于官方核验资质。
specialties: 经纪人专长领域。
served_areas: 服务区域。
languages: 经纪人可用语言。
active_listings: 该经纪人当前在售房源数。
recently_sold: 该经纪人近期成交房源数。
emails: 联系邮箱（经纪人公开信息）。
phones: 联系电话（经纪人公开信息）。

怎么调用 Realtor 房源搜索 API？

property_search

使用 platform="realtor"、action="property_search" 调用“房源搜索”能力；返回列表，默认 20 条、单次最多 200 条，主要包含 id、url、title、status、price、sold_price 等 27 个字段。

Realtor property_search 的参数分别是什么意思？

keyword必填: 房源位置，填写美国五位邮编或城市,州缩写，例如 78701 或 Austin, TX；不接受任意房源描述。
官方说明可按州、城市、县、ZIP、街区、地址或学校查找房源，并按价格、卧室、卫浴、房产类型和挂牌状态等筛选；EveryInfra 当前 keyword 只接受 ZIP 或“城市，州”，来源不证明其 status、sort 枚举或 baths_min 的整数转换。官方来源：Realtor.com：房源位置搜索与筛选维度来源核查：2026-09-05
baths_min可选: 最少卫浴数量，当前转换为整数，不能保留 1.5 这类半卫值。
beds_min可选: 最少卧室数量，整数；不是整套房屋的总房间数。
city可选: 城市名覆盖值；邮编搜索时不要再传不匹配城市，避免组合成相互冲突的定位条件。
max_price可选: 最高挂牌价，整数，与 min_price 配合；出售与出租请分别解读价格。
min_price可选: 最低挂牌价，整数；价格随出售或出租状态分别为售价或租金，不是 API 调用费用。
sort可选: 降序排序：newest 最新上架、price_desc 挂牌价、sold_price_desc 成交价、recently_sold 最近成交、bedrooms_desc 卧室数、lot_size_desc 地块面积、photo_count_desc 图片数、recently_updated 最近更新。默认 newest。
查看全部 8 个允许值
bedrooms_desclot_size_descnewestphoto_count_descprice_descrecently_soldrecently_updatedsold_price_desc
status可选: 单个房源状态字符串，默认 for_sale；已知值包括 sold、for_rent、ready_to_build、off_market、other 或 new_community。当前接口未声明完整可选清单，因此这里只解释已知输入，不据此拒绝其他值。

Realtor 特有返回字段与含义（19）

state: 州。
postal_code: 邮编。
beds: 卧室数量。
baths: 卫生间数量，可能是小数（1.5 = 一全卫加一半卫）。
area_sqft: 室内面积，平方英尺。
lot_sqft: 地块面积，平方英尺。
year_built: 建成年份。
property_type: 房屋类型。
status: 房源状态（在售/已售/待定等）。
listed_at: 挂牌时间。
sold_at: 成交时间。
sold_price: 成交价。
is_new_listing: 是否为新上架房源。
is_price_reduced: 是否已降价。降价是买方议价的重要信号。
is_foreclosure: 是否为法拍房。
photo_count: 房源照片数量。
county: 所属县。
lat: 纬度。
lng: 经度。

怎么调用 Realtor 房源详情 API？

property_detail

使用 platform="realtor"、action="property_detail" 调用“房源详情”能力；返回单个对象，主要包含 id、url、title、status、price、sold_price 等 18 个字段。

Realtor property_detail 的参数分别是什么意思？

url必填: Realtor 房源详情链接，应含 _M数字-数字后缀以提取 property_id；也可在此字段传房源 ID 或完整地址。无可提取 ID 的其他 URL 不保证定位成功。
官方产品说明确认房源详情页可包含挂牌资料、图片、户型、3D、估值和周边信息；它没有证明 EveryInfra 可接受完整地址、数字 property ID 或从 _M… URL 还原 ID 的规则。官方来源：Realtor.com：房源详情页的信息范围来源核查：2026-09-05

Realtor 特有返回字段与含义（11）

state: 州。
postal_code: 邮编。
beds: 卧室数量。
baths: 卫生间数量，可能是小数（1.5 = 一全卫加一半卫）。
area_sqft: 室内面积，平方英尺。
year_built: 建成年份。
property_type: 房屋类型。
status: 房源状态（在售/已售/待定等）。
sold_at: 成交时间。
sold_price: 成交价。
updated_at: 信息更新时间。

一次 Realtor search 调用的全过程：向 POST /api/v1/social 发送 platform="realtor"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、name、url、title、text 等字段；返回列表，单次最多 500 条，计费 $1.39 / 千次，失败与空结果不计费。

Realtor 原始字段名

EveryInfra 统一字段名

左边是 Realtor 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配；切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

Realtor 的独有字段名（当前目录）

全站 89 个平台的当前目录中，这 9 个字段名只在 Realtor 出现。这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

office_name
license_no
active_listings
recently_sold
served_areas
lot_sqft
is_new_listing
is_price_reduced
is_foreclosure

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。机器可读版：/api/v1/social/fields

id: 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
name: 名称。用于账号/商品/商家类能力，指该对象本身的名字。
url: 该记录在原平台上的可访问链接。
title: 标题。平台无标题概念时（如纯文本帖）为 null。
text: 正文内容，已去除 HTML 标签。长文可能被截断。
office_name: 经纪办公室名称。
broker_name: 经纪公司名称。
city: 城市名，用原平台的语言书写，未做中英归一。
state: 州。
postal_code: 邮编。
country: 国家或地区。可能是全称也可能是 ISO 代码，取决于平台，未归一。
license_no: 经纪人执业牌照号，可用于官方核验资质。
rating: 评分。分制随平台而异，同一行的 rating_scale 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale: 上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
review_count: 评价条数，用于商品/商家类能力。null 表示不公开，不等于 0。
active_listings: 该经纪人当前在售房源数。
recently_sold: 该经纪人近期成交房源数。
price_min: 价格区间下限（经纪人成交区间里用）。
price_max: 价格区间上限。
specialties: 经纪人专长领域。
languages: 经纪人可用语言。
served_areas: 服务区域。
emails: 联系邮箱（经纪人公开信息）。
phones: 联系电话（经纪人公开信息）。
image_url: 图片链接。多图能力可能返回 image_urls 数组。
platform: 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
status: 房源状态（在售/已售/待定等）。
price: 价格数值，不含货币符号；币种见 currency。
sold_price: 成交价。
sold_at: 成交时间。
listed_at: 挂牌时间。
property_type: 房屋类型。
beds: 卧室数量。
baths: 卫生间数量，可能是小数（1.5 = 一全卫加一半卫）。
area_sqft: 室内面积，平方英尺。
lot_sqft: 地块面积，平方英尺。
year_built: 建成年份。
address: 详细地址，原文透传。
county: 所属县。
lat: 纬度。
lng: 经度。
photo_count: 房源照片数量。
is_new_listing: 是否为新上架房源。
is_price_reduced: 是否已降价。降价是买方议价的重要信号。
is_foreclosure: 是否为法拍房。
updated_at: 信息更新时间。

请求填写示例

search 按城市和州发现经纪人；查房源应使用 property_search，不是此接口。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

realtor_search.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"realtor","action":"search","params":{"keyword":"Austin, TX"}}'

记录字段预览（非真实响应）

仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json

{
  "id": null,
  "name": null,
  "url": null,
  "title": null,
  "text": null,
  "office_name": null,
  "broker_name": null,
  "city": null,
  "state": null,
  "postal_code": null,
  "country": null,
  "license_no": null,
  "rating": null,
  "rating_scale": null,
  "review_count": null,
  "active_listings": null,
  "recently_sold": null,
  "price_min": null,
  "price_max": null,
  "specialties": null,
  "languages": null,
  "served_areas": null,
  "emails": null,
  "phones": null,
  "image_url": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

按服务地区查找 Realtor 经纪人

用 search 查经纪人资料，而不是同一地区的住宅房源。

查看 search 的 agent_type 参数 →

keyword 填 Austin, TX 这样的城市与州；agent_type 的 buyer、seller、both 分别表示买方、卖方或两类经纪人，结合 name、office_name、served_areas 和 specialties 核对资料。
min_rating 筛的是经纪人评价，不是房屋评级；license_no 出现在结果中不代表 EveryInfra 已独立核验执照状态，也不替用户联系或委托经纪人。

按 Realtor 房源状态整理挂牌与已售记录

用 property_search 查房源，把出售、出租和已售记录分开比较。

查看 property_search 的 status 参数 →

keyword 填美国五位邮编或城市，州缩写；status 使用单个字符串，例如 for_sale、for_rent、sold，不要传数组。结合 id、status、price、sold_price 与 sold_at 区分价格标准。
price 可能取挂牌价，也可能回落到已售价，不能仅凭字段名判断成交；sort=list_price 仍是降序，不支持用 price_asc 表示低价优先。

按 Realtor 房源编号核对住宅详情

从房源链接定位单套住宅，核对面积、房型和最近记录。

查看 property_detail 的 url 参数 →

url 优先填含 _M数字-数字后缀的详情链接，也可填房源 ID 或完整地址；结合 id、address、beds、baths、area_sqft 与 updated_at 核对同一房屋。
area_sqft 是平方英尺，不是平方米；sold_price 与 sold_at 缺失不等于从未成交，updated_at 也不是本次查询时间或实地验房日期。

Realtor API 常见问题

Realtor API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="realtor"、action 和 params。以 search 为例，必填 keyword，可选 agent_type、min_rating。search 按城市和州发现经纪人；查房源应使用 property_search，不是此接口。 Realtor 共 3 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Realtor API 怎么收费？

$1.39 / 千次，Realtor 全部 3 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 Realtor 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

Realtor API 一次能返回多少条数据？

Realtor 有 2 个列表接口，包括 search、property_search。其余 1 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

Realtor API 返回哪些字段？

当前目录为 search 列出 id、name、url、title、text、office_name 等 26 个字段名。按全站当前目录统计，9 个字段名只在 Realtor 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「按服务地区查找 Realtor 经纪人」怎样接入 Realtor API？

用 search 查经纪人资料，而不是同一地区的住宅房源。 keyword 填 Austin, TX 这样的城市与州；agent_type 的 buyer、seller、both 分别表示买方、卖方或两类经纪人，结合 name、office_name、served_areas 和 specialties 核对资料。 min_rating 筛的是经纪人评价，不是房屋评级；license_no 出现在结果中不代表 EveryInfra 已独立核验执照状态，也不替用户联系或委托经纪人。

「按 Realtor 房源状态整理挂牌与已售记录」怎样接入 Realtor API？

用 property_search 查房源，把出售、出租和已售记录分开比较。 keyword 填美国五位邮编或城市，州缩写；status 使用单个字符串，例如 for_sale、for_rent、sold，不要传数组。结合 id、status、price、sold_price 与 sold_at 区分价格标准。 price 可能取挂牌价，也可能回落到已售价，不能仅凭字段名判断成交；sort=list_price 仍是降序，不支持用 price_asc 表示低价优先。

「按 Realtor 房源编号核对住宅详情」怎样接入 Realtor API？

从房源链接定位单套住宅，核对面积、房型和最近记录。 url 优先填含 _M数字-数字后缀的详情链接，也可填房源 ID 或完整地址；结合 id、address、beds、baths、area_sqft 与 updated_at 核对同一房屋。 area_sqft 是平方英尺，不是平方米；sold_price 与 sold_at 缺失不等于从未成交，updated_at 也不是本次查询时间或实地验房日期。

可以先免费试用 Realtor API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 Realtor 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 3 个能力。无需信用卡。

Airbnb API App Store API Booking API Capterra API Clutch API Crexi API Dice API Expedia API 全部 89 平台 ↗

开始调用 Realtor API

加微信领 $1 免费额度，先选一个 Realtor 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始