Guía de integración

Cómo conseguir acceso a la API de Airbnb en 2026 (y cómo lanzar mientras esperas)

No hay una API pública de Airbnb, ni una key de desarrollador self-serve, ni sandbox. Airbnb solo da acceso a su API a los partners de software que invita. Esta guía explica los tres permisos que necesita toda integración que funcione, qué nivel de acceso pedir a los anfitriones y las cuatro opciones que tienes de verdad. Está escrita para el ingeniero o el founder al que le acaban de pedir que «conecte Airbnb».

¿Existe una API de Airbnb?

Sí, pero no una en la que puedas registrarte. Airbnb tiene una API de partners: una interfaz REST para empresas de software aprobadas, como sistemas de gestión de propiedades, channel managers y herramientas de mensajería, para que sus clientes gestionen sus anuncios de Airbnb desde fuera de airbnb.com.

Con autorización completa puede leer y escribir:

• anuncios, contenido, fotos, habitaciones y servicios
• el calendario: precios por noche, disponibilidad, estancia mínima y máxima, reglas de check-in y check-out
• reservas, consultas, solicitudes de reserva y modificaciones
• mensajes de huéspedes, incluidos los adjuntos
• reseñas y respuestas a reseñas
• transacciones de pagos

Lo que no es: una API de datos abierta. No hay endpoint para resultados de búsqueda, anuncios de otros anfitriones ni datos de mercado. Para ver qué puede y qué no puede hacer cada una de esas áreas una vez conectado, lee La API de Airbnb: cómo funciona el acceso y qué te permite hacer.

¿Cómo consigo una API key de Airbnb?

No te dan una key. Necesitas tres permisos, de tres partes distintas, antes de que funcione tu primera escritura.

1. Airbnb aprueba tu empresa

El programa de partners de Airbnb evalúa la empresa, la categoría de producto (gestión de propiedades, mensajería, pricing) y cómo gestionas la seguridad y los datos. La aprobación trae un cliente OAuth limitado a esa categoría.

2. Cada anfitrión autoriza tu app

La aprobación como partner solo te permite pedir. Cada anfitrión pasa por la pantalla de consentimiento de Airbnb, elige qué puede hacer tu app y concede tokens para su cuenta. Un anfitrión, una autorización, revocable en cualquier momento.

3. Cada anuncio se abre a la API

Este es el paso que pilla a la gente por sorpresa. Autorizar la cuenta no abre los anuncios que hay en ella. Cada anuncio tiene su propia configuración de sincronización:

Así que «hemos conectado Airbnb pero los precios no se sincronizan en tres de cuarenta anuncios» casi nunca es un problema de autenticación, y mandar de nuevo al anfitrión por OAuth no cambia nada. Muestra este estado por anuncio en tu producto desde el primer día.

¿Qué nivel de acceso debe pedir tu app?

Los anfitriones no conceden «Airbnb». Conceden uno de tres niveles, y el que pidas decide si la conexión puede llegar a producirse.

Tus cuatro opciones en 2026

Opción 1: esperar a Airbnb

Si estás construyendo un PMS completo con oferta real detrás, merece la pena que el equipo de partners de Airbnb te conozca. Pero no dejes tu roadmap pendiente de ello: no hay solicitud, ni cola, ni plazos.

Opción 2: iCal

Cada anuncio de Airbnb exporta un enlace iCal. Es gratis y no necesita aprobación. Y solo lleva las fechas bloqueadas: ni nombres de huéspedes, ni precios, ni mensajes, ni reseñas, y Airbnb lo actualiza cuando le parece. Vale para un calendario personal; no para un producto.

Opción 3: scraping o automatización del navegador

No lo hagas. Incumple los términos de Airbnb, el riesgo lo asume la cuenta del anfitrión y deja de funcionar sin avisar cuando cambia la web. Un anfitrión que pierde su cuenta por tu integración no vuelve.

Opción 4: integrarte a través de un partner aprobado

Las empresas con acceso de partner de Airbnb lo ofrecen a otros equipos de software a través de su propia API. Tú llamas a su API, los anfitriones se conectan en la pantalla de consentimiento de Airbnb a través de la integración del partner, y tú construyes tu producto en lugar de esperar.

Qué revisar antes de elegir un partner

• Qué niveles de acceso puedes solicitar. Mensajería y solo lectura importan en cuanto tus clientes ya tienen un PMS.
• Si funciona junto al PMS del anfitrión. La mayoría de los channel managers no pueden, porque ellos mismos necesitan acceso completo.
• Webhooks. Los mensajes nuevos, las reservas y los cambios deberían llegarte en segundos, firmados y con reintentos, no en tu siguiente polling.
• Otros canales. Tus clientes también están en Booking.com y Vrbo, y en más canales después.
• Acceso self-serve. ¿Puedes conseguir una key en producción y conectar un anuncio real hoy, sin llamada comercial ni sesión de certificación?
• Escritura por anuncio. ¿Te dice en qué anuncios aceptará Airbnb escrituras antes de que las envíes?

Comparamos las principales opciones lado a lado, con fuentes, en Repull comparado: Channex, Rentals United y NextPax.

Cómo funciona con Repull

Repull es la opción 4: una sola API para Airbnb, Booking.com, Vrbo y más canales, además de 14 sistemas de gestión de propiedades. Te conectas a través de la integración de partner de Airbnb que Repull ya tiene, así que no hay nada que solicitar. Crea una sesión de Connect, manda al anfitrión a ella y recibe una conexión de vuelta:

curl -X POST 'https://api.repull.dev/v1/connect/airbnb' \
  -H 'Authorization: Bearer sk_live_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "redirectUrl": "https://yourapp.com/connected",
    "accessType": "messaging"
  }'

accessType es full_access, messaging o read_only. Si lo omites, el anfitrión elige el nivel en la página de consentimiento. El anfitrión aprueba en Airbnb y vuelve a tu redirectUrl. A partir de ahí:

# Guest conversations across every connected account
curl 'https://api.repull.dev/v1/conversations?limit=20' \
  -H 'Authorization: Bearer sk_live_YOUR_KEY'

# Reply to a guest. The Idempotency-Key makes a retry safe.
curl -X POST 'https://api.repull.dev/v1/conversations/532457/messages' \
  -H 'Authorization: Bearer sk_live_YOUR_KEY' \
  -H 'Idempotency-Key: reply-532457-1' \
  -H 'Content-Type: application/json' \
  -d '{ "message": "Hi Sam, check-in is from 4pm. The door code arrives on the day." }'

Suscríbete a reservation.message.received y los mensajes nuevos de huéspedes llegan a tu servidor como webhooks firmados, con reintentos y backoff si tu endpoint está caído. Repull también te dice, por anuncio, si Airbnb acepta escrituras, y rechaza una escritura que sabe que Airbnb va a rechazar antes de enviar nada:

curl 'https://api.repull.dev/v1/channels/airbnb/listings' \
  -H 'Authorization: Bearer sk_live_YOUR_KEY'

# Each listing carries Airbnb's own per-listing decision:
#   "syncCategory": "sync_all" | "sync_rates_and_availability" | "none"
#   "writable": false when syncCategory is "none"

¿Quieres que Claude o ChatGPT trabajen directamente con una cuenta de Airbnb? El servidor MCP de Airbnb los conecta a través de la misma integración, y este tutorial construye encima un agente de mensajería con huéspedes.

Pruébalo con un anuncio real. El plan Free es una key en producción. Conecta uno de tus propios anuncios en modo mensajería o solo lectura (nada cambia en el anuncio) y verás tus propios datos en pocos minutos. Crea una cuenta gratis o compara planes en precios.

Preguntas frecuentes