¿Tienes acceso a la Booking API? Esto es lo que hay
La Booking API existe, pero no es para cualquiera. Qué dan Demand y Connectivity, qué requisitos piden y cómo obtener los datos que sí necesitas sin escribir código.
Hay una escena que se repite en casi todos los equipos de revenue y de inteligencia de mercado. Alguien necesita saber a qué precio se está vendiendo un hotel en Barcelona esta semana. Busca “booking api”, encuentra documentación, abre un editor y lanza la primera petición. Lo que vuelve no es un JSON. Es una pantalla en blanco.
La escena tiene explicación, y no es que la API esté mal documentada. Booking.com mantiene APIs oficiales desde hace años, y algunas están bien construidas. El problema es otro: están diseñadas para que el inventario entre y salga por el mismo sitio. Para vender habitaciones. No para mirar el mercado desde fuera. Ninguna de las dos sirve para extraer datos de hoteles a escala.
Esa distancia, entre una API que sirve para operar y una API que serviría para investigar, decide si tu proyecto tarda dos semanas o dos días. Y casi nunca aparece escrita en la documentación.
Tres puertas de entrada, y solo dos son APIs:
| API | Para quién | Cómo se entra | Qué no te da |
|---|---|---|---|
| Demand API | Agencias, afiliados y distribuidores que revenden alojamiento | Registro como Managed Affiliate Partner y clave desde el Partner Centre | Datos de la competencia, series históricas |
| Connectivity APIs | Hoteles, PMS y channel managers | Integración como proveedor de alojamiento | Información de otros portales |
| Sin API | Analistas, agencias y equipos de precios | Extracción de la página pública | Nada, siempre que el dato se vea en pantalla |
Las APIs oficiales de Booking y para quién son
La diferencia entre las dos primeras no está en la documentación, que es pública en ambos casos. Está en el filtro de entrada.
Demand API: se entra por partnership, no por registro
Es la API que permite buscar alojamientos, consultar disponibilidad y cerrar reservas para revenderlas. La documentación es pública. El acceso no.
Antes de lanzar la primera petición hay que registrarse como Managed Affiliate Partner de Booking.com y tener acceso al Partner Centre. Desde ahí se genera la clave de API.
Cada petición viaja con dos cabeceras. Sin las dos, la respuesta es un 401.
El detalle está en la guía de autenticación. Una cuenta admite como máximo dos claves activas a la vez, lo que permite rotarlas sin cortar el servicio.
Hay entorno de pruebas. El sandbox trabaja con datos de test y no genera reservas ni cargos reales, así que puedes recorrer el flujo completo sin tocar producción. Cuando estás dentro, cubre búsqueda de alojamientos, disponibilidad y también alquiler de coches.
Lo que no cubre es mirar qué hace la competencia.
Connectivity APIs: la puerta del hotel, no la del analista
El segundo bloque está pensado para el otro lado del mostrador. Hoteles, PMS y channel managers lo usan para sincronizar disponibilidad, tarifas y reservas con Booking.com. La documentación vive en developers.booking.com/connectivity.
Si tu empresa vende un PMS, esta es tu integración. Si lo que quieres es leer el mercado, no.
Por qué ninguna API hotelera resuelve este problema
Las dos APIs de Booking asumen lo mismo: que aportas inventario o que vendes. No existe un endpoint del tipo “dame los precios de estos 200 hoteles para estas fechas y compáralos con los de otras tres webs”. Esa consulta no está en el catálogo porque no es el negocio de Booking.com.
Fuera de Booking pasa algo parecido. Las APIs de inventario hotelero que sí existen (Amadeus, Hotelbeds, Expedia) resuelven otro problema: son acuerdos B2B para que una agencia o un turoperador revenda habitaciones, y casi siempre se facturan por uso. Tampoco están pensadas para comparar precios entre portales ni para seguir su evolución en el tiempo.
El resultado es el mismo en los tres casos: acceso sí, datos de mercado no.
Lo que ninguna API te va a dar
Cuatro cosas se repiten en todas las conversaciones con equipos de revenue y de mercado. Ninguna se resuelve con una API oficial.
Comparación entre portales. Cada API te devuelve su propio inventario. Para saber si el mismo hotel está más barato en otro sitio hay que mirar los otros sitios.
Series históricas. Una API responde a la pregunta “¿cuánto cuesta ahora?”. La pregunta “¿cuánto costaba hace tres semanas?” no tiene endpoint.
Reseñas completas. El texto de las opiniones pertenece a la plataforma y no se entrega en bloque. Puedes analizar lo que cada huésped ve en pantalla, nada más.
Posición y visibilidad. El orden en que aparece un alojamiento es el resultado de una página renderizada, no un campo de la respuesta.
Ese hueco es el que ocupa la extracción de páginas públicas, y ahí es donde entra Octoparse. Lo vemos más abajo con los datos de una prueba real.
El obstáculo técnico que nadie menciona
Antes de escribir la primera línea de código conviene saber qué ocurre cuando pides una página de Booking desde un script.
Lo medimos antes de escribir este artículo, en dos rondas. En total hicimos seis peticiones a páginas de resultados de búsqueda, repartidas entre dos identificadores de navegador y dos rutas de red: las seis devolvieron 202 con un HTML de entre 3,9 y 8,9 KB que no contenía ningún alojamiento, solo el reto JavaScript de AWS WAF.
La portada resultó menos fiable. Tres de cuatro intentos acabaron con la conexión cerrada y sin código de estado, lo que también dice algo sobre lo que se puede esperar de un script contra este sitio.
El contraste que importa es otro. robots.txt devolvió 200 en las cuatro pruebas, con el mismo user-agent y las mismas rutas. El dominio responde. Lo que no llega es la página con datos.
Cambiar el user-agent no cambia el resultado. El reto no se supera identificándose como Chrome, se supera ejecutando el JavaScript en un navegador real.
Una advertencia honesta: esas cifras salen de una sola máquina y una sola red, y Booking ajusta sus defensas por IP y por región. Tu resultado puede ser un 200, un 403 o un 202. Lo que no cambia es la conclusión práctica: la vía “petición HTTP más parseo del HTML” no es una base sólida sobre la que montar un proyecto.
Cómo obtener los datos que sí necesitas
Cuando el dato es visible en la página, el camino es extraerlo de forma estructurada en lugar de pedirle permiso a una API que no lo va a dar. Es lo que hace Octoparse: en vez de atacar la API, toma el dato de la página que cualquier visitante ya puede ver, y lo entrega en una tabla.
Usa una plantilla cuando exista. Para alojamiento en España está https://www.octoparse.es/template/booking-hotel-listados-scraper. Devuelve 13 campos por alojamiento: nombre, URL, foto, localidad, distancia al centro, precio, precio sin descuento, puntuación, número de comentarios, valoración por estrellas, certificado, descripción y condición de la tarifa. Admite ejecución en la nube y también local.
Para completar cada ficha, la plantilla https://www.octoparse.es/template/booking-hotel-detalles-scraper entra en la página del alojamiento y añade descripción, servicios, ubicación y la puntuación por categorías.
Lo que salió en nuestra prueba. Lanzamos la plantilla de listados en la nube sobre una búsqueda real de Barcelona, con entrada el 10 de diciembre y salida el 12. Devolvió 20 alojamientos en 50 segundos. Estas son cuatro filas reales de esa ejecución:
| Alojamiento | Localidad | Precio | Puntuación | Comentarios | Distancia | Estrellas |
|---|---|---|---|---|---|---|
| Room Casa Gracia | Gràcia, Barcelona | US$17 | 7,9 | 8.907 | 1,4 km | — |
| Ikonik Anglí | Sarrià-Sant Gervasi, Barcelona | US$105 | 8,5 | 1.311 | 4,3 km | 4 |
| Upper Diagonal | Sarrià-Sant Gervasi, Barcelona | US$179 | 8,8 | 1.223 | 4 km | 4 |
| Aparthotel Atenea Calabria | Eixample, Barcelona | US$103 | 8,8 | 3.072 | 1,6 km | 3 |

Cada fila trae 13 campos: el nombre del alojamiento, su URL, la foto, la localidad, la distancia al centro, el precio actual y el precio sin descuento, la puntuación y el número de comentarios, la valoración por estrellas, el certificado, la descripción y la condición de la tarifa. Con eso puedes comparar una ciudad entera por precio, calidad y ubicación sin entrar hotel por hotel.
Puedes repetir la misma prueba con tu ciudad en unos minutos. La plantilla no tiene coste por línea y la prueba es gratuita.
Si prefieres no configurar nada, el Asistente de IA de la página de inicio crea la tarea a partir de una descripción en lenguaje natural, en cualquier idioma, y busca una plantilla antes de construir nada. Y cuando necesitas que esto viva dentro de otro sistema, Octoparse expone las mismas tareas por MCP Server, que permite buscarlas y ejecutarlas desde Claude, ChatGPT o Cursor, y por la API de Octoparse, para integraciones propias. Con más de 600 plantillas y 4,5 millones de usuarios, la mayoría de los portales de viaje tienen ya un punto de partida.
API o extracción: cómo decidir
La decisión no es binaria, y casi nadie la toma una sola vez. Hay empresas que acaban usando las dos cosas a la vez, para datos distintos.
| Tu situación | Camino |
|---|---|
| Quieres revender inventario y puedes firmar un acuerdo | Demand API |
| Eres un hotel o un PMS y necesitas sincronizar tarifas | Connectivity APIs |
| Necesitas comparar precios entre portales o seguir su evolución | Extracción de la página pública |
| Quieres una lista de alojamientos por ciudad para un análisis puntual | Extracción y exportación a hoja de cálculo |
| Necesitas tus propias tarifas y también las del mercado | Connectivity API para lo tuyo, extracción para lo demás |
Y hay un error que se repite: pedir la API por prestigio. “Si tiene API es más serio” suena razonable en una reunión y acaba en tres meses de integración para unos datos que ya estaban visibles en una hoja de cálculo.
Si el objetivo es decidir precios, la pregunta no es qué tecnología queda mejor, sino cuánto tarda el dato en llegar a la persona que decide. La API gana en automatización y en fiabilidad a largo plazo. La extracción gana en tiempo hasta el primer resultado. Casi nunca compiten, se reparten el trabajo.
Regla mental: si la pregunta empieza por “¿cuánto cuesta ahora mismo en mi propio inventario?”, probablemente hay API. Si empieza por “¿qué está haciendo el mercado?”, no la hay.
Empieza por una ciudad, no por una integración
Si tu caso es “necesito precios y disponibilidad de hoteles para comparar y decidir”, la API oficial no va a resolverlo, y saberlo te ahorra semanas.
El siguiente paso razonable es pequeño: elige una ciudad, lanza la plantilla de listados en Octoparse y mira si los 13 campos cubren lo que necesitas. Si cubren, exportas a Excel o a Google Sheets y ya tienes la primera foto del mercado. Si no cubren, al menos sabrás qué falta antes de invertir en una integración.
Puedes comprobar tus propios resultados hoy mismo con la prueba gratuita de Octoparse.
Preguntas frecuentes
¿Booking tiene una API pública gratuita para mi proyecto? No en el sentido que suele buscar la gente. Hay APIs oficiales documentadas en abierto, pero el acceso exige ser partner o proveedor de alojamiento: la clave se genera desde el Partner Centre de una cuenta de afiliado aprobada, y cada petición necesita además el identificador de afiliado. No existe un registro libre para uso personal.
¿Por qué mi script recibe un 202 en lugar de la página? Porque Booking responde con un reto JavaScript de AWS WAF antes de servir el contenido. El HTML que llega no tiene datos. Cambiar el user-agent no lo resuelve, hace falta ejecutar el JavaScript en un navegador.
¿Cuántos datos puedo extraer sin que me bloqueen? No hay un número publicado y la cifra cambia. Lo que sí se puede controlar es la forma: usar una herramienta que gestione la ejecución en la nube, espaciar las consultas y no pedir más de lo que el proyecto justifica.
¿Es legal extraer datos de Booking? Depende de qué extraigas, cuánto y para qué. Las condiciones de Booking.com limitan el uso automatizado de su contenido, y en cuanto aparece un dato personal entra el RGPD. La práctica razonable: solo datos visibles públicamente, sin cuentas de terceros y sin degradar el servicio. Si el proyecto es comercial, consulta con un abogado.



