API de Realtor
Busca profesionales e inmuebles en Realtor.com y consulta una propiedad concreta por URL. La acción general de agentes no debe confundirse con property_search.
Precio listado, precio vendido, estado y fecha son hechos distintos de la ficha. Licencias, disponibilidad y valoración del inmueble requieren verificación independiente.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Realtor, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar profesionales inmobiliariossearch | Busca profesionales inmobiliarios mediante keyword, con tipo de agente y valoración mínima opcionales. | $1.39 por 1.000 solicitudes | No disponible temporalmente |
Buscar propiedades en Realtor.comproperty_search | Busca inmuebles con keyword y permite acotar ciudad, precio, estado u orden. | $1.39 por 1.000 solicitudes | Normal |
Consultar el detalle de una propiedadproperty_detail | Abre la url de una propiedad y recoge estado, precios, fechas, características y agente visibles. | $1.39 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Realtor?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar profesionales inmobiliarios Busca profesionales inmobiliarios mediante | keyword | agent_type, min_rating | Entrega síncrona | El catálogo declara defaultLimit = 100 y maxLimit = 500 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | 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_searchBuscar propiedades en Realtor.com Busca inmuebles con | keyword | baths_min, beds_min, city, max_price, min_price, sort, status | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 200 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | 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 · advertiser_emails · advertiser_phones · platform |
property_detailConsultar el detalle de una propiedad Abre la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | 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 |
¿Qué significan los parámetros de Realtor search?
Busca profesionales inmobiliarios mediante keyword, con tipo de agente y valoración mínima opcionales. Devuelve oficina, licencia y ubicación publicadas; no acredita vigencia ni recomienda contratar.
keywordObligatorio- Para la acción
search, busca agentes por ciudad y estado, por ejemplo,Austin, TX. Paraproperty_search, busca propiedades por código postal de 5 dígitos de EE. UU. o porciudad, abreviatura_estado. No admite descripciones arbitrarias de propiedades. agent_typeOpcional- Tipo de agente para la acción
search:both(incluye agentes de comprador y vendedor, por defecto),buyer(agente de comprador) oseller(agente de vendedor). No se refiere al estado de la propiedad.Valores permitidos:bothbuyersellerRealtor.com: agentes de compra y de venta — El buscador de agentes de Realtor.com distingue Buy, Sell y Both y separa el papel del agente comprador del agente del vendedor. Esta API muestra datos; no presta servicios de intermediación ni valida licencias profesionales. · Consultada min_ratingOpcional- Valoración mínima por estrellas del agente para la acción
search. Envíala como un array de strings, por ejemplo,["4"]. Valores posibles:0,1,2,3,4,5. El valor0no aplica ningún filtro. No se refiere a la valoración de la propiedad.Valores permitidos:012345
¿Qué significan los parámetros de Realtor property_search?
Busca inmuebles con keyword y permite acotar ciudad, precio, estado u orden. Distingue precio listado, precio vendido y fechas; no confirma disponibilidad ni valoración futura.
keywordObligatorio- Para la acción
search, busca agentes por ciudad y estado, por ejemplo,Austin, TX. Paraproperty_search, busca propiedades por código postal de 5 dígitos de EE. UU. o porciudad, abreviatura_estado. No admite descripciones arbitrarias de propiedades. baths_minOpcional- Número mínimo de baños. El valor se usa como entero, por lo que no conserva un medio baño como
1.5. beds_minOpcional- Número mínimo de dormitorios, expresado como entero. No es el número total de habitaciones de la vivienda.
cityOpcional- Valor para sobrescribir el nombre de la ciudad en
property_search. Cuando busques por código postal, no envíes una ciudad que no corresponda para evitar conflictos en los criterios de localización. max_priceOpcional- Entrada estándar para el importe máximo de la propiedad. Sobrescribe
price_maxen la misma petición. Interpreta los importes de venta y alquiler de forma separada. min_priceOpcional- Entrada estándar para el importe mínimo de la propiedad. Sobrescribe
price_minen la misma petición. No se refiere a la tarifa de servicio del agente. sortOpcional- Orden de las propiedades en
property_search, siempre descendente. El valor por defecto esnewest(publicadas más recientemente). También puedes usarprice_desc(precio de publicación),sold_price_desc(precio de venta),recently_sold(vendidas más recientemente),bedrooms_desc(dormitorios),lot_size_desc(superficie del terreno),photo_count_desc(número de fotos) orecently_updated(actualizadas más recientemente). No hay orden ascendente, así que no puedes empezar por los precios más bajos.Valores permitidos:bedrooms_desclot_size_descnewestphoto_count_descprice_descrecently_soldrecently_updatedsold_price_desc statusOpcional- Un único estado de la propiedad para
property_search, enviado como string. El valor por defecto esfor_sale. Los valores conocidos sonsold,for_rent,ready_to_build,off_market,otherynew_community; el campo no se valida contra una lista cerrada, así que otros valores no se rechazan. No envíes un array enstatus.
¿Qué significan los parámetros de Realtor property_detail?
Abre la url de una propiedad y recoge estado, precios, fechas, características y agente visibles. No sustituye una inspección, tasación o comprobación registral.
urlObligatorio- Enlace a los detalles de la propiedad en Realtor para la acción
property_detail. Debe contener el sufijo_M<números>-<números>para poder extraer elproperty_id. También puedes enviar el ID de la propiedad o la dirección completa en este campo. No se garantiza la localización si la URL no contiene un ID extraíble.
Cómo usar la API de Realtor
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"realtor","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Realtor
¿Cómo llamo a la API de Realtor?
Envía POST /api/v1/social con platform igual a realtor, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Realtor?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye name, title, text y office_name. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Realtor?
El buscador de agentes de Realtor.com distingue Buy, Sell y Both y separa el papel del agente comprador del agente del vendedor. Esta API muestra datos; no presta servicios de intermediación ni valida licencias profesionales.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; property_search requiere keyword; property_detail requiere url.
¿Las acciones de Realtor responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.