Realtor.com API

Realtor.com 搜索 API

按地点搜索 Realtor.com 房源，可按价格、房产类型、卧室/浴室数、房源状态和关键词筛选，以标准化 JSON 返回房产记录（价格、地址、卧室数、浴室数）。

POST/v1/run/realtor.search
可用率
100.00%
30d · 40 次调用
请求数
40
30d
响应时间
23.8s
中位数 · 30d

价格

一个价格，以美元计

试一试

发出你的第一个请求

propertyTypesarray
按一个或多个房产类型筛选；省略则包含所有类型（例如 ["single_family", "townhomes"]）。
searchStatusesarray
for_sale 模式下包含的房源状态；省略则为在售的 For Sale + Ready to Build。在 sold 模式下忽略（例如 ["for_sale", "pending"]）。
打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "data": {
    "items": [
      {
        "addressLine": "123 Main St",
        "agentEmail": "alex@example.com",
        "agentName": "Example title",
        "agentPhone": "+1 555-0142",
        "agentUrl": "https://example.com/page",
        "baths": "example",
        "beds": 12.5,
        "brokerName": "Example title",
        "city": "San Francisco",
        "country": "US",
        "county": "example",
        "createdUtc": 12.5,
        "daysOnMarket": 12.5,
        "description": "A short example description of this item.",
        "garageSpaces": 29,
        "hoaFee": 12.5,
        "image": "https://example.com/image.jpg",
        "images": [
          "https://example.com/image.jpg"
        ],
        "isNewConstruction": true,
        "latitude": 37.7749,
        "listingId": "a1b2c3d4",
        "longitude": -122.4194,
        "lotSqft": 12.5,
        "mlsId": "a1b2c3d4",
        "mlsName": "Example title",
        "postalCode": "94107",
        "price": 19.99,
        "pricePerSqft": 19.99,
        "propertyId": "a1b2c3d4",
        "propertyType": "general",
        "sqft": 12.5,
        "state": "CA",
        "status": "for_sale",
        "stories": 12.5,
        "tags": [
          "example"
        ],
        "taxAmount": 19.99,
        "taxAssessedValue": 19.99,
        "title": "Example title",
        "updatedUtc": 12.5,
        "url": "https://example.com/page",
        "yearBuilt": 2024
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface RealtorSearchResponse {
  data: {
    items: {
      addressLine?: string;
      agentEmail?: string;
      agentName?: string;
      agentPhone?: string;
      agentUrl?: string;
      baths?: string;
      beds?: number;
      brokerName?: string;
      city?: string;
      country?: string;
      county?: string;
      createdUtc?: number;
      daysOnMarket?: number;
      description?: string;
      garageSpaces?: number;
      hoaFee?: number;
      image?: string;
      images?: string[];
      isNewConstruction?: boolean;
      latitude?: number;
      listingId?: string;
      longitude?: number;
      lotSqft?: number;
      mlsId?: string;
      mlsName?: string;
      postalCode?: string;
      price?: number;
      pricePerSqft?: number;
      propertyId: string;
      propertyType?: string;
      sqft?: number;
      state?: string;
      status?: "for_sale" | "ready_to_build" | "sold" | "pending" | "contingent" | "coming_soon";
      stories?: number;
      tags?: string[];
      taxAmount?: number;
      taxAssessedValue?: number | null;
      title?: string;
      updatedUtc?: number;
      url: string;
      yearBuilt?: number;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

完整的参数与响应参考：这个接口的每个字段、类型和示例。

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/realtor.search
curl -X POST https://api.getanyapi.com/v1/run/realtor.search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bedsMin":4,"limit":3,"location":"Austin, TX","propertyTypes":["single_family"],"searchStatuses":["pending"]}'
字段类型示例值
请求体
locationstring"Austin, TX"要搜索的城市、ZIP 码、街区或州（例如 Las Vegas, NV）。
bathsMininteger最少浴室数（例如 2）。
bedsMininteger4最少卧室数（例如 3）。
keywordstring房源描述中必须出现的自由文本关键词（例如 'pool'）。
limitinteger3最多返回的结果数（1-25，默认 25）。按返回的结果数扣费，所以上限越低，费用越少。
priceMaxinteger最高挂牌价，以 USD 计（例如 750000）。
priceMininteger最低挂牌价，以 USD 计（例如 250000）。
propertyTypesarray["single_family"]按一个或多个房产类型筛选；省略则包含所有类型（例如 ["single_family", "townhomes"]）。
searchModeenum要搜索的房源类型：for_sale 或 sold（例如 for_sale）。
searchStatusesarray["pending"]for_sale 模式下包含的房源状态；省略则为在售的 For Sale + Ready to Build。在 sold 模式下忽略（例如 ["for_sale", "pending"]）。
响应
dataobjectThe result wrapper, or null when nothing matched.
data.itemsobject[]Matching Realtor.com property listing records. Populated whenever the provider has data for the entity.
data.items[].addressLinestringStreet address line of the property.
data.items[].agentEmailstringContact email for the listing agent.
data.items[].agentNamestringName of the listing agent.
data.items[].agentPhonestringContact phone number for the listing agent.
data.items[].agentUrlstringRealtor.com profile URL of the listing agent.
data.items[].bathsstringConsolidated bathroom count (e.g. "3.5" for three full and one half bath).
data.items[].bedsnumberNumber of bedrooms.
data.items[].brokerNamestringListing brokerage or office name.
data.items[].citystringCity the property is in.
data.items[].countrystringCountry the property is in.
data.items[].countystringCounty the property is in.
data.items[].createdUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
data.items[].daysOnMarketnumberNumber of days the listing has been on the market.
data.items[].descriptionstringListing description written by the agent.
data.items[].garageSpacesnumberNumber of garage spaces.
data.items[].hoaFeenumberHomeowners association fee, in US dollars, at the frequency Realtor.com reports.
data.items[].imagestringPrimary listing photo URL.
data.items[].imagesstring[]Listing photo URLs.
data.items[].isNewConstructionbooleanTrue when the listing is new construction.
data.items[].latitudenumberLatitude of the property in decimal degrees.
data.items[].listingIdstringRealtor.com listing id for this specific listing of the property.
data.items[].longitudenumberLongitude of the property in decimal degrees.
data.items[].lotSqftnumberLot size in square feet.
data.items[].mlsIdstringMLS number for the listing.
data.items[].mlsNamestringName of the multiple listing service the listing came from.
data.items[].postalCodestringPostal (ZIP) code of the property.
data.items[].pricenumberCurrent list price in US dollars.
data.items[].pricePerSqftnumberList price per square foot in US dollars.
data.items[].propertyIdstringRealtor.com property id (stable identifier for the listing). Populated whenever the provider has data for the entity.
data.items[].propertyTypestringProperty type (e.g. single_family, condos, townhomes).
data.items[].sqftnumberInterior living area in square feet.
data.items[].statestringTwo-letter state code the property is in.
data.items[].status"for_sale" | "ready_to_build" | "sold" | "pending" | "contingent" | "coming_soon"Display listing status, including ready-to-build, pending, contingent, and coming-soon sub-statuses when present.
data.items[].storiesnumberNumber of storeys in the home.
data.items[].tagsstring[]Realtor.com feature tags for the property (e.g. central_air, garage_1_or_more).
data.items[].taxAmountnumberMost recent annual property tax paid, in US dollars.
data.items[].taxAssessedValuenumberMost recent assessed value from the county tax authority, in US dollars, or null when none is published (common on new construction).
data.items[].titlestringHuman-readable street address line used as the listing title.
data.items[].updatedUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the listing was last updated.
data.items[].urlstringCanonical Realtor.com listing detail page URL. Populated whenever the provider has data for the entity.
data.items[].yearBuiltnumberYear the property was built.
foundbooleanTrue when the search returned at least one matching listing.
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
价格
每次请求价格（上限）USDUS$0.0468
价格（/千条结果）USDUS$1.80

常见问题

关于 Realtor.com 搜索 API

AnyAPI 的 Realtor.com 搜索 API 只需一次 POST 请求 /v1/run/realtor.search，就以统一格式的 JSON 返回 Realtor.com 数据。按地点搜索 Realtor.com 房源，可按价格、房产类型、卧室/浴室数、房源状态和关键词筛选，以标准化 JSON 返回房产记录（价格、地址、卧室数、浴室数）。无论哪个数据源提供服务，AnyAPI 都返回同一套统一的 schema。费用：每千条结果 US$1.80，单次请求最多 US$0.0468，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Realtor.com 搜索 API 调用中有 100.0% 成功，响应时间中位数为 23.8 秒，共测量 40 次调用。

费用：每千条结果 US$1.80，单次请求最多 US$0.0468，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。

按地点搜索 Realtor.com 房源，可按价格、房产类型、卧室/浴室数、房源状态和关键词筛选，以标准化 JSON 返回房产记录（价格、地址、卧室数、浴室数）。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。

过去 30 天，通过 AnyAPI 发起的 Realtor.com 搜索 API 调用中有 100.0% 成功，响应时间中位数为 23.8 秒，共测量 40 次调用。这些是 AnyAPI 对经过网关的流量的自有测量，持续重新计算，并非公开承诺的服务等级目标。