API de plataforma de EveryData
API de Airbnb
Busca alojamientos de Airbnb y consulta su ficha, reseñas, anfitrión o calendario mediante acciones separadas. Cada objeto mantiene su URL y sus propios campos de disponibilidad, precio y reputación.
Una fecha disponible no constituye reserva y un precio observado puede depender de moneda, ocupación o estancia. Los datos del anfitrión y las reseñas son públicos; no incluyen información de cuenta privada.
- Endpoint
- POST /api/v1/social
- Funciones
- 5
- Por 1.000
- 1,389 US$
Funciones disponibles
Compara las acciones de Airbnb 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 alojamientos en Airbnb Busca alojamientos de Airbnb con | keyword | currency, lang, locale, max_price, min_price | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 100` 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 · text · property_type · person_capacity · price · rating · rating_scale · review_count · lat · lng · location · host_name · amenities · image_url · check_in · check_out · platform |
property_detailRevisar un alojamiento de Airbnb Parte de la | url | city, max_price, min_price | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · title · text · property_type · room_type · person_capacity · bedrooms · bathrooms · beds · location · lat · lng · rating · rating_scale · review_count · price · currency · host_name · is_superhost · amenities · platform |
reviewsLeer reseñas de un alojamiento Lee las reseñas asociadas a la | url | lang, locale, since, sort | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 100` 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 · text · rating · rating_scale · posted_at · language · author_name · author_location · response · platform |
hostConsultar al anfitrión del anuncio Identifica mediante | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · name · text · avatar_url · languages · listing_count · rating · rating_scale · review_count · is_superhost · joined_at · listing_urls · platform |
calendarComprobar el calendario del alojamiento Consulta por | url | check_in, check_out, end_date, since, start_date, until | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · date · available · available_for_checkin · available_for_checkout · bookable · min_nights · max_nights · price · currency · platform |
¿Qué acepta cada acción de Airbnb?
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 Airbnb search?
Busca alojamientos de Airbnb con keyword y permite acotar moneda, idioma y banda de precio. Devuelve capacidad, tipo de propiedad, precio y valoración observados; no confirma disponibilidad para unas fechas concretas.
keywordObligatorio- Ubicación para buscar alojamientos en Airbnb. Usa el nombre de una ciudad, región o destino, como
Tokyo. No es un nombre de usuario de anfitrión ni un ID de alojamiento. currencyOpcional- Moneda para mostrar los resultados de los alojamientos. El valor por defecto es
USD; los valores opcionales se pueden consultar en la lista de esta API. Solo afecta a la moneda de los precios de Airbnb, no cambia el coste de la solicitud ni la moneda de tu cuenta.Valores permitidos:aedaudbgnbrlcadchfclpcnycopcrcczkdkkegpeurgbpghshkdhrkhufidrilsinrjpykeskrwkztmadmxnmyrnoknzdpenphpplnqarronsarseksgdthbtrytwduahugxusduyuvndzar langOpcional- Código compacto de idioma y región, como
enusparaen-US,zhcnparazh-CNojajpparaja-JP. Usa la lista completa de valores permitidos para esta API. No envíes directamente códigos de idioma de dos letras comoen.Valores permitidos:arxxazazbgbgbsbacaescsczdadkdeatdechdededeluelgrenaeenauencaengbengyenieeninennzensgenuses419esaresboesbzesclescoescresecesesesgteshnesmxesniespaespeespyessvesusesveeteefififrbefrcafrchfrfrfrlugaieheilhiinhrhrhuhuhyamididisisitchititjajpkagekokrltltlvlvmkmkmsmymtmtnlbenlnlnonoplplptbrptptrororuruskskslsisqalsrmesrrssvseswxxththtlphtrtrukuavivnxhzazhcnzhhkzhtwzhtwuszhuszuza localeOpcional- Idioma y región de la página de Airbnb, como
en-USozh-CN. El valor por defecto esen-US. No lo envíes junto conlang, ya quelangsobrescribe esta misma configuración de idioma. No filtra por la nacionalidad del autor de la reseña. max_priceOpcional- Límite superior para el filtro de precios de alojamientos. Envía un valor numérico que no sea inferior a
min_price. No confundas el presupuesto total del alojamiento con el coste de una única solicitud a la API. min_priceOpcional- Límite inferior para el filtro de precios de alojamientos. Envía un valor numérico y úsalo junto con
max_price. Es una condición para filtrar alojamientos, no un límite de consumo de la API.
¿Qué significan los parámetros de Airbnb property_detail?
Parte de la url de un anuncio concreto y recoge distribución, capacidad, servicios y datos del anfitrión. city y los importes compatibles no convierten esta acción en otra búsqueda ni en una cotización de reserva.
urlObligatorio- El destino varía según la
action: paraproperty_detail,reviewsocalendar, usa un enlace/rooms/<ID_alojamiento>o el ID del alojamiento; parahost, usa un enlace/users/show/<ID_anfitrión>o el ID del anfitrión. Los identificadores de alojamiento y de anfitrión no son intercambiables.Airbnb: qué partes de una reseña son públicasAirbnb diferencia la reseña pública, la valoración general y cierta información por categorías que solo ven el anfitrión y la plataforma. Esta fuente ayuda a no mezclar la puntuación del alojamiento con la del anfitrión; no garantiza que todos esos datos aparezcan en la respuesta.Consultada cityOpcional- Nombre de la ciudad donde se encuentra el alojamiento. Es un campo de texto libre que se utiliza como condición de ciudad para esta API. No es un ID de alojamiento ni un código de país.
max_priceOpcional- Límite superior para el filtro de precios de alojamientos. Envía un valor numérico que no sea inferior a
min_price. No confundas el presupuesto total del alojamiento con el coste de una única solicitud a la API. min_priceOpcional- Límite inferior para el filtro de precios de alojamientos. Envía un valor numérico y úsalo junto con
max_price. Es una condición para filtrar alojamientos, no un límite de consumo de la API.
¿Qué significan los parámetros de Airbnb reviews?
Lee las reseñas asociadas a la url del alojamiento y puede limitar idioma, fecha u orden. Conserva autor, valoración, estancia y respuesta por separado; el lote no representa necesariamente todo el historial.
urlObligatorio- El destino varía según la
action: paraproperty_detail,reviewsocalendar, usa un enlace/rooms/<ID_alojamiento>o el ID del alojamiento; parahost, usa un enlace/users/show/<ID_anfitrión>o el ID del anfitrión. Los identificadores de alojamiento y de anfitrión no son intercambiables.Airbnb: qué partes de una reseña son públicasAirbnb diferencia la reseña pública, la valoración general y cierta información por categorías que solo ven el anfitrión y la plataforma. Esta fuente ayuda a no mezclar la puntuación del alojamiento con la del anfitrión; no garantiza que todos esos datos aparezcan en la respuesta.Consultada langOpcional- Código compacto de idioma y región, como
enusparaen-US,zhcnparazh-CNojajpparaja-JP. Usa la lista completa de valores permitidos para esta API. No envíes directamente códigos de idioma de dos letras comoen.Valores permitidos:arxxazazbgbgbsbacaescsczdadkdeatdechdededeluelgrenaeenauencaengbengyenieeninennzensgenuses419esaresboesbzesclescoescresecesesesgteshnesmxesniespaespeespyessvesusesveeteefififrbefrcafrchfrfrfrlugaieheilhiinhrhrhuhuhyamididisisitchititjajpkagekokrltltlvlvmkmkmsmymtmtnlbenlnlnonoplplptbrptptrororuruskskslsisqalsrmesrrssvseswxxththtlphtrtrukuavivnxhzazhcnzhhkzhtwzhtwuszhuszuza localeOpcional- Idioma y región de la página de Airbnb, como
en-USozh-CN. El valor por defecto esen-US. No lo envíes junto conlang, ya quelangsobrescribe esta misma configuración de idioma. No filtra por la nacionalidad del autor de la reseña. sinceOpcional- Fecha en formato YYYY-MM-DD. Para
reviews, indica la fecha de inicio de las reseñas. Paracalendar, indica el inicio del intervalo del calendario y sobrescribe astart_dateycheck_in. El significado de la fecha varía según laaction. sortOpcional- Orden de las reseñas de los huéspedes:
newestpara las más recientes (por defecto),relevancepara las más relevantes ytop_ratedpara las de mayor puntuación. Este parámetro ordena las reseñas, no el precio de los alojamientos.Valores permitidos:newestrelevancetop_rated
¿Qué significan los parámetros de Airbnb host?
Identifica mediante url al anfitrión vinculado a un anuncio y devuelve nombre, biografía, idiomas, valoraciones y número de alojamientos cuando existen. No expone datos privados ni acredita la identidad del perfil.
urlObligatorio- El destino varía según la
action: paraproperty_detail,reviewsocalendar, usa un enlace/rooms/<ID_alojamiento>o el ID del alojamiento; parahost, usa un enlace/users/show/<ID_anfitrión>o el ID del anfitrión. Los identificadores de alojamiento y de anfitrión no son intercambiables.Airbnb: Puntuación del anfitrión y puntuación del alojamientoAirbnb explica que la puntuación de un anfitrión es un resumen de las valoraciones generales que han recibido sus alojamientos. Al consultar el perfil de un anfitrión, esta puntuación no debe tomarse como la valoración de un alojamiento específico.Consultada
¿Qué significan los parámetros de Airbnb calendar?
Consulta por url el calendario publicado de un alojamiento y admite ventanas mediante check_in, check_out, start_date, end_date, since o until. Cada día indica disponibilidad y estancia mínima; no crea una reserva.
urlObligatorio- El destino varía según la
action: paraproperty_detail,reviewsocalendar, usa un enlace/rooms/<ID_alojamiento>o el ID del alojamiento; parahost, usa un enlace/users/show/<ID_anfitrión>o el ID del anfitrión. Los identificadores de alojamiento y de anfitrión no son intercambiables. check_inOpcional- Parámetro de compatibilidad para la fecha de inicio del
calendar, en formato YYYY-MM-DD. Si también envíasstart_date, este tiene prioridad. El parámetrosincesobrescribe a ambos. La consulta del calendario no crea una reserva. check_outOpcional- Parámetro de compatibilidad para la fecha de fin del
calendar, en formato YYYY-MM-DD. Si también envíasend_date, este tiene prioridad. El parámetrountilsobrescribe a ambos. La consulta no bloquea la disponibilidad del alojamiento. end_dateOpcional- Fecha de fin del calendario para
calendar, en formato YYYY-MM-DD. Si no se especifica, se usacheck_outo, en su defecto, la fecha actual más 30 días. El valor por defecto no esstart_datemás 30 días. Si también envíasuntil, este tiene prioridad. sinceOpcional- Fecha en formato YYYY-MM-DD. Para
reviews, indica la fecha de inicio de las reseñas. Paracalendar, indica el inicio del intervalo del calendario y sobrescribe astart_dateycheck_in. El significado de la fecha varía según laaction. start_dateOpcional- Fecha de inicio del calendario para
calendar, en formato YYYY-MM-DD. Si no se especifica, se usacheck_ino, en su defecto, la fecha actual. Si también envíassince, este tiene prioridad. untilOpcional- Fin del intervalo del calendario para la acción
calendar, en formato YYYY-MM-DD. Si se envía, sobrescribe aend_dateycheck_out. No es el límite superior para la fecha de publicación de las reseñas.
Cómo usar la API de Airbnb
- 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":"airbnb","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Airbnb
¿Cómo llamo a la API de Airbnb?
Envía POST /api/v1/social con platform igual a airbnb, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Airbnb?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye title, text, property_type y person_capacity. 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 Airbnb?
Airbnb diferencia la reseña pública, la valoración general y cierta información por categorías que solo ven el anfitrión y la plataforma. Esta fuente ayuda a no mezclar la puntuación del alojamiento con la del anfitrión; no garantiza que todos esos datos aparezcan en la respuesta.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; property_detail requiere url; reviews requiere url; consulta las demás acciones en la lista de funciones.