API para Realtor.com
API para Realtor.com: Buscar
Busque anúncios do Realtor.com por localização com filtros opcionais de preço, tipo de imóvel, quartos/banheiros, status do anúncio e palavra-chave, e receba registros de imóveis (preço, endereço, quartos, banheiros) em JSON normalizado.
POST/v1/run/realtor.search
Disponibilidade
100,00%
30d · 40 chamadas
Requisições
40
30d
Resposta
23,8s
mediana · 30d
Teste
Faça sua primeira requisição
propertyTypesarrayFiltra por um ou mais tipos de imóvel; omita para todos os tipos (ex.: ["single_family", "townhomes"]).
searchStatusesarrayStatus de anúncio a incluir no modo for_sale; omita para os ativos For Sale + Ready to Build. Ignorado no modo sold (ex.: ["for_sale", "pending"]).
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
"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 da resposta
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";
}Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.
Referência
Requisição, resposta e preço
Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30dPOST /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"]}'| Campo | Tipo | Valor de exemplo |
|---|---|---|
| Corpo da requisição | ||
| location | string | "Austin, TX"Cidade, ZIP code, bairro ou estado a buscar (ex.: Las Vegas, NV). |
| bathsMin | integer | Número mínimo de banheiros (ex.: 2). |
| bedsMin | integer | 4Número mínimo de quartos (ex.: 3). |
| keyword | string | Palavra-chave em texto livre que precisa aparecer na descrição do anúncio (ex.: 'pool'). |
| limit | integer | 3Número máximo de resultados a retornar (1-25, padrão 25). A cobrança é por resultado retornado, então um limite menor custa menos. |
| priceMax | integer | Preço máximo do anúncio em USD (ex.: 750000). |
| priceMin | integer | Preço mínimo do anúncio em USD (ex.: 250000). |
| propertyTypes | array | ["single_family"]Filtra por um ou mais tipos de imóvel; omita para todos os tipos (ex.: ["single_family", "townhomes"]). |
| searchMode | enum | Tipo de anúncio a buscar: for_sale ou sold (ex.: for_sale). |
| searchStatuses | array | ["pending"]Status de anúncio a incluir no modo for_sale; omita para os ativos For Sale + Ready to Build. Ignorado no modo sold (ex.: ["for_sale", "pending"]). |
| Resposta | ||
| data | object | The result wrapper, or null when nothing matched. |
| data.items | object[] | Matching Realtor.com property listing records. Populated whenever the provider has data for the entity. |
| data.items[].addressLine | string | Street address line of the property. |
| data.items[].agentEmail | string | Contact email for the listing agent. |
| data.items[].agentName | string | Name of the listing agent. |
| data.items[].agentPhone | string | Contact phone number for the listing agent. |
| data.items[].agentUrl | string | Realtor.com profile URL of the listing agent. |
| data.items[].baths | string | Consolidated bathroom count (e.g. "3.5" for three full and one half bath). |
| data.items[].beds | number | Number of bedrooms. |
| data.items[].brokerName | string | Listing brokerage or office name. |
| data.items[].city | string | City the property is in. |
| data.items[].country | string | Country the property is in. |
| data.items[].county | string | County the property is in. |
| data.items[].createdUtc | number | UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. |
| data.items[].daysOnMarket | number | Number of days the listing has been on the market. |
| data.items[].description | string | Listing description written by the agent. |
| data.items[].garageSpaces | number | Number of garage spaces. |
| data.items[].hoaFee | number | Homeowners association fee, in US dollars, at the frequency Realtor.com reports. |
| data.items[].image | string | Primary listing photo URL. |
| data.items[].images | string[] | Listing photo URLs. |
| data.items[].isNewConstruction | boolean | True when the listing is new construction. |
| data.items[].latitude | number | Latitude of the property in decimal degrees. |
| data.items[].listingId | string | Realtor.com listing id for this specific listing of the property. |
| data.items[].longitude | number | Longitude of the property in decimal degrees. |
| data.items[].lotSqft | number | Lot size in square feet. |
| data.items[].mlsId | string | MLS number for the listing. |
| data.items[].mlsName | string | Name of the multiple listing service the listing came from. |
| data.items[].postalCode | string | Postal (ZIP) code of the property. |
| data.items[].price | number | Current list price in US dollars. |
| data.items[].pricePerSqft | number | List price per square foot in US dollars. |
| data.items[].propertyId | string | Realtor.com property id (stable identifier for the listing). Populated whenever the provider has data for the entity. |
| data.items[].propertyType | string | Property type (e.g. single_family, condos, townhomes). |
| data.items[].sqft | number | Interior living area in square feet. |
| data.items[].state | string | Two-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[].stories | number | Number of storeys in the home. |
| data.items[].tags | string[] | Realtor.com feature tags for the property (e.g. central_air, garage_1_or_more). |
| data.items[].taxAmount | number | Most recent annual property tax paid, in US dollars. |
| data.items[].taxAssessedValue | number | Most recent assessed value from the county tax authority, in US dollars, or null when none is published (common on new construction). |
| data.items[].title | string | Human-readable street address line used as the listing title. |
| data.items[].updatedUtc | number | UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the listing was last updated. |
| data.items[].url | string | Canonical Realtor.com listing detail page URL. Populated whenever the provider has data for the entity. |
| data.items[].yearBuilt | number | Year the property was built. |
| found | boolean | True 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. |
| Preço | ||
| Preço por requisição (teto) | USD | US$ 0,0468 |
| Preço /mil resultados | USD | US$ 1,80 |
Dúvidas frequentes
Sobre o endpoint Buscar da API para Realtor.com
O endpoint Buscar da AnyAPI para Realtor.com retorna dados de Realtor.com em JSON normalizado com uma chamada POST para /v1/run/realtor.search. Busque anúncios do Realtor.com por localização com filtros opcionais de preço, tipo de imóvel, quartos/banheiros, status do anúncio e palavra-chave, e receba registros de imóveis (preço, endereço, quartos, banheiros) em JSON normalizado. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa US$ 1,80 por mil resultados, e nunca mais de US$ 0,0468 por requisição, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar da API para Realtor.com feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 23,8 segundos, em 40 chamadas medidas.
Custa US$ 1,80 por mil resultados, e nunca mais de US$ 0,0468 por requisição, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.
Busque anúncios do Realtor.com por localização com filtros opcionais de preço, tipo de imóvel, quartos/banheiros, status do anúncio e palavra-chave, e receba registros de imóveis (preço, endereço, quartos, banheiros) em JSON normalizado. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.
Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar da API para Realtor.com feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 23,8 segundos, em 40 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.