API de plataforma de EveryData
API de Booking
Busca alojamientos en Booking.com y consulta ficha, reseñas o precios para una estancia mediante acciones independientes. Fechas, moneda e idioma aportan contexto a la consulta, no una reserva.
Estrellas, puntuación y etiqueta de valoración representan señales distintas. Una tarifa observada puede cambiar con habitación, ocupación o impuestos y solo queda confirmada en el proceso de reserva.
- Endpoint
- POST /api/v1/social
- Funciones
- 4
- Por 1.000
- 1,389 US$
Funciones disponibles
Compara las acciones de Booking 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 Booking.com Busca alojamientos en Booking.com con | keyword | check_in, check_out, currency, lang, min_price, property_type, sort, star_rating | Entrega síncrona | El catálogo declara `defaultLimit = 10` y `maxLimit = 30` 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 · type · url · text · stars · rating · rating_scale · rating_label · review_count · price · currency · breakfast · hotel_chain · check_in_date · check_out_date · address · city · country · latitude · longitude · image_url · platform · score |
profileConsultar la ficha de un alojamiento Abre la | url | check_in, check_out, currency, lang, min_price, sort, star_rating | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · name · type · url · text · stars · rating · rating_scale · rating_label · review_count · price · currency · breakfast · hotel_chain · check_in_date · check_out_date · address · city · country · latitude · longitude · image_url · platform · score |
reviewsLeer reseñas de huéspedes Recoge reseñas de la | url | — | 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 · title · text_positive · text_negative · rating · rating_scale · posted_at · stay_date · author_name · author_country · traveler_type · room_name · nights · language · owner_response · platform |
pricesComparar precios por estancia Consulta precios de una | url | adults, check_in, currency, days, rooms, start_date | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · hotel_name · room_name · check_in · check_out · price · original_price · discount_percent · currency · taxes_included · is_sold_out · availability_status · rooms_left · min_stay · bed_type · max_guests · room_size_sqm · room_view · meal_plan · is_breakfast_included · is_refundable · rate_options_count · platform |
¿Qué acepta cada acción de Booking?
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 Booking search?
Busca alojamientos en Booking.com con keyword y contexto de fechas, moneda, idioma, precio, tipo y estrellas. Devuelve ficha, valoración y ubicación observadas; no bloquea habitación ni garantiza el precio hasta reservar.
keywordObligatorio- Destino de alojamiento en Booking, como
Amsterdam. La acciónsearchbusca listas de alojamientos como hoteles y apartamentos; no es una búsqueda por palabra clave en vuelos, atracciones o el texto de las reseñas. check_inOpcional- Fecha de entrada, en formato YYYY-MM-DD. Las acciones
searchyprofilesolo usan la fecha si se proporcionancheck_inycheck_outa la vez. Enprices, actúa como fecha de inicio si no se proporcionastart_date, pero no crea una reserva. check_outOpcional- Fecha de salida, en formato YYYY-MM-DD. Debe proporcionarse junto con
check_iny ser posterior a la fecha de entrada. Enviar solo este parámetro no hará quesearchoprofileincluyan el intervalo completo de la estancia. currencyOpcional- Moneda para mostrar el precio del alojamiento. El valor por defecto es
USD. Las accionessearchyprofileaceptan los códigos de moneda listados en esta API. Paraprices, se recomienda usar códigos de tres letras en mayúsculas. No cambia la moneda de facturación de esta API.Valores permitidos:aedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar langOpcional- Idioma de la información de la página del alojamiento. El valor por defecto es inglés británico (
engb). Usaenuspara inglés estadounidense, yzhcnozhtwpara chino simplificado o tradicional. No uses directamenteenozh. Este parámetro no traduce el texto de las reseñas enreviews.Valores permitidos:arbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw min_priceOpcional- Este parámetro recibe una cadena con el rango de precios por noche. Por ejemplo,
100-150indica un intervalo y100+indica un importe mínimo de 100. La moneda la determina el parámetrocurrency. No debes introducir el importe total de la estancia. property_typeOpcional- Tipo de alojamiento para
search. Conserva mayúsculas, minúsculas y espacios. Algunos ejemplos sonHotels,Apartments,Hostels,Guest houses,Homestays,Bed and breakfasts,Holiday homes,Boats,Villas,Motels,Resorts,Holiday parks,CampsitesoLuxury tents. Usanonepara no limitar la búsqueda. No es el nombre de un tipo de habitación dentro del hotel. sortOpcional- Orden de los resultados de alojamiento:
distancepara la distancia relativa al lugar de búsqueda ypopularpara el orden general de las reseñas.top_ratedcorresponde actualmente al orden por estrellas del alojamiento, no a la puntuación más alta de los huéspedes.searchusapopularpor defecto. No esperes que ordene la lista de resultados en la acciónprofilede un alojamiento individual.Valores permitidos:distancepopulartop_rated star_ratingOpcional- Filtro por estrellas del alojamiento:
1_stara5_starspara un número de estrellas específico,unratedpara sin calificar yanypara cualquiera. Las estrellas del alojamiento y la puntuación de las reseñas de los huéspedes no son la misma métrica.Valores permitidos:1_star2_stars3_stars4_stars5_starsanyunratedBooking.com: estrellas, puntuación de huéspedes y nivel de calidadBooking.com presenta por separado la categoría por estrellas, la puntuación de reseñas y ciertos niveles de calidad. Sirve para interpretar los campos sin tratar una escala de cinco estrellas como una puntuación de huéspedes sobre diez.Consultada
¿Qué significan los parámetros de Booking profile?
Abre la url de un alojamiento y admite el mismo contexto de estancia para leer descripción, categoría, puntuación y servicios. Los filtros compatibles no convierten la ficha en disponibilidad contractual.
urlObligatorio- Enlace completo de la página de un alojamiento en Booking. Se recomienda usar la ruta
/hotel/. La acciónprofileobtiene los datos del alojamiento,reviewssus reseñas ypriceslos precios de los tipos de habitación. No uses la página de resultados de búsqueda de un destino como si fuera el enlace de un hotel. check_inOpcional- Fecha de entrada, en formato YYYY-MM-DD. Las acciones
searchyprofilesolo usan la fecha si se proporcionancheck_inycheck_outa la vez. Enprices, actúa como fecha de inicio si no se proporcionastart_date, pero no crea una reserva. check_outOpcional- Fecha de salida, en formato YYYY-MM-DD. Debe proporcionarse junto con
check_iny ser posterior a la fecha de entrada. Enviar solo este parámetro no hará quesearchoprofileincluyan el intervalo completo de la estancia. currencyOpcional- Moneda para mostrar el precio del alojamiento. El valor por defecto es
USD. Las accionessearchyprofileaceptan los códigos de moneda listados en esta API. Paraprices, se recomienda usar códigos de tres letras en mayúsculas. No cambia la moneda de facturación de esta API.Valores permitidos:aedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar langOpcional- Idioma de la información de la página del alojamiento. El valor por defecto es inglés británico (
engb). Usaenuspara inglés estadounidense, yzhcnozhtwpara chino simplificado o tradicional. No uses directamenteenozh. Este parámetro no traduce el texto de las reseñas enreviews.Valores permitidos:arbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw min_priceOpcional- Este parámetro recibe una cadena con el rango de precios por noche. Por ejemplo,
100-150indica un intervalo y100+indica un importe mínimo de 100. La moneda la determina el parámetrocurrency. No debes introducir el importe total de la estancia. sortOpcional- Orden de los resultados de alojamiento:
distancepara la distancia relativa al lugar de búsqueda ypopularpara el orden general de las reseñas.top_ratedcorresponde actualmente al orden por estrellas del alojamiento, no a la puntuación más alta de los huéspedes.searchusapopularpor defecto. No esperes que ordene la lista de resultados en la acciónprofilede un alojamiento individual.Valores permitidos:distancepopulartop_rated star_ratingOpcional- Filtro por estrellas del alojamiento:
1_stara5_starspara un número de estrellas específico,unratedpara sin calificar yanypara cualquiera. Las estrellas del alojamiento y la puntuación de las reseñas de los huéspedes no son la misma métrica.Valores permitidos:1_star2_stars3_stars4_stars5_starsanyunratedBooking.com: estrellas, puntuación de huéspedes y nivel de calidadBooking.com presenta por separado la categoría por estrellas, la puntuación de reseñas y ciertos niveles de calidad. Sirve para interpretar los campos sin tratar una escala de cinco estrellas como una puntuación de huéspedes sobre diez.Consultada
¿Qué significan los parámetros de Booking reviews?
Recoge reseñas de la url del alojamiento separando texto positivo y negativo, puntuación, fecha de estancia y autor. El conjunto visible no prueba que incluya todas las opiniones ni permite publicar respuestas.
urlObligatorio- Enlace completo de la página de un alojamiento en Booking. Se recomienda usar la ruta
/hotel/. La acciónprofileobtiene los datos del alojamiento,reviewssus reseñas ypriceslos precios de los tipos de habitación. No uses la página de resultados de búsqueda de un destino como si fuera el enlace de un hotel.Booking.com: Explicación sobre los comentarios de los huéspedes y las puntuaciones por categoríaBooking.com explica oficialmente que la valoración general y las puntuaciones por categorías (limpieza, personal, etc.) se envían de forma independiente. Esta referencia se ciñe a la terminología del sitio web. La escala de las puntuaciones devueltas por esta consulta debe verificarse para cada caso; este enlace no garantiza que la normalización de datos haya sido validada.Consultada
¿Qué significan los parámetros de Booking prices?
Consulta precios de una url para habitaciones, adultos y una ventana de estancia indicada. Conserva precio original, descuento y moneda de cada opción; la respuesta no reserva ni congela la tarifa.
urlObligatorio- Enlace completo de la página de un alojamiento en Booking. Se recomienda usar la ruta
/hotel/. La acciónprofileobtiene los datos del alojamiento,reviewssus reseñas ypriceslos precios de los tipos de habitación. No uses la página de resultados de búsqueda de un destino como si fuera el enlace de un hotel. adultsOpcional- Número de adultos para la consulta de precios en
prices. Es un número entero y, por defecto, 2. Se usa para las condiciones de la consulta; no es el número máximo de personas que se devuelve ni una reserva real.searchusa actualmente un valor fijo de 2 adultos; no se garantiza que este valor sea ajustable. check_inOpcional- Fecha de entrada, en formato YYYY-MM-DD. Las acciones
searchyprofilesolo usan la fecha si se proporcionancheck_inycheck_outa la vez. Enprices, actúa como fecha de inicio si no se proporcionastart_date, pero no crea una reserva. currencyOpcional- Moneda para mostrar el precio del alojamiento. El valor por defecto es
USD. Las accionessearchyprofileaceptan los códigos de moneda listados en esta API. Paraprices, se recomienda usar códigos de tres letras en mayúsculas. No cambia la moneda de facturación de esta API. daysOpcional- Número de días a consultar en el calendario para
prices. Por defecto, 7; limitado a un rango de 1 a 30. Los valores fuera del rango se ajustan al límite más cercano. Es el número de días que cubre la consulta, no el número de noches a reservar para cada tipo de habitación.Booking.com: Precios de alojamiento y condiciones de los impuestosBooking.com explica que el precio lo establece el proveedor del alojamiento y que los impuestos pueden variar según la ubicación, el tipo de alojamiento y el número de huéspedes. Es necesario comprobar si están incluidos en el precio. Esta consulta no constituye una reserva ni una garantía de precio.Consultada roomsOpcional- Número de habitaciones para la consulta de precios en
prices. Es un número entero y, por defecto, 1. No indica cuántos tipos de habitación se devolverán.searchusa actualmente un valor fijo de 1 habitación; no se garantiza que este valor sea ajustable. start_dateOpcional- Fecha de inicio para la consulta de precios por día en
prices, en formato YYYY-MM-DD. Si se envía junto concheck_in,start_datetiene prioridad. No es la fecha de publicación de una reseña ni la fecha de apertura del hotel.
Cómo usar la API de Booking
- 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":"booking","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Booking
¿Cómo llamo a la API de Booking?
Envía POST /api/v1/social con platform igual a booking, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Booking?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye name, type, text y stars. 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 Booking?
Booking.com presenta por separado la categoría por estrellas, la puntuación de reseñas y ciertos niveles de calidad. Sirve para interpretar los campos sin tratar una escala de cinco estrellas como una puntuación de huéspedes sobre diez.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; profile requiere url; reviews requiere url; consulta las demás acciones en la lista de funciones.