API de plataforma de EveryData
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.
- Endpoint
- POST /api/v1/social
- Funciones
- 3
- Por 1.000
- 1,389 US$
Funciones disponibles
Compara las acciones de Realtor por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| 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 | 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 · 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é 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.
¿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.Realtor.com: agentes de compra y de ventaEl 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.
¿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. 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- Campo de orden para
property_search. El valor por defecto eslist_date(fecha de publicación). También puedes usarlist_price(precio de publicación),sold_price(precio de venta),sold_date(fecha de venta),beds(dormitorios),lot_sqft(superficie del terreno),photo_count(número de fotos) olast_update_date(fecha de actualización). El orden es siempre descendente; no puedes usarprice_ascpara priorizar los precios bajos. statusOpcional- Estado de la propiedad para
property_search, como string único. El valor por defecto esfor_sale. Puedes usarsold,for_rent,ready_to_build,off_market,otheronew_community. El valor de este campo se encapsula en un array de un solo elemento; no envíes un array directamente 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 devuelto si la acción es 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 de origen contengan 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.