Guia de integração

Como obter acesso à API do Airbnb em 2026 (e como lançar enquanto esperas)

Não existe uma API pública do Airbnb, nem uma key de programador self-service, nem sandbox. O Airbnb só dá acesso à API aos parceiros de software que convida. Este guia explica as três autorizações de que qualquer integração funcional precisa, que nível de acesso pedir aos anfitriões e as quatro opções que tens realmente. Foi escrito para o engenheiro ou founder a quem acabaram de pedir para «ligar o Airbnb».

Existe uma API do Airbnb?

Sim, mas não uma em que te possas registar. O Airbnb tem uma API de parceiros: uma interface REST para empresas de software aprovadas, como sistemas de gestão de propriedades, channel managers e ferramentas de mensagens, para que os seus clientes possam gerir os anúncios do Airbnb fora do airbnb.com.

Com autorização total, pode ler e escrever:

O que não é: uma API de dados aberta. Não há endpoint para resultados de pesquisa, anúncios de outros anfitriões ou dados de mercado. Para saberes o que cada uma dessas áreas pode e não pode fazer depois de ligado, lê A API do Airbnb: como funciona o acesso e o que te permite fazer.

Como obtenho uma API key do Airbnb?

Não recebes uma key. Precisas de três autorizações, de três partes diferentes, antes de a tua primeira escrita funcionar.

1. O Airbnb aprova a tua empresa

O programa de parceiros do Airbnb avalia a empresa, a categoria de produto (gestão de propriedades, mensagens, pricing) e a forma como tratas a segurança e os dados. A aprovação traz um cliente OAuth limitado a essa categoria.

Em 2026 não podes iniciar isto por tua conta

À pergunta «Como posso obter acesso à API do Airbnb?», a página de parceiros do Airbnb responde: “At this time, we are not accepting new access requests for our API.” (de momento, não estamos a aceitar novos pedidos de acesso à nossa API). Os seus partner managers abordam as empresas que querem, avaliadas pela oferta que representam, pela sua tecnologia e pela capacidade de apoiar clientes em comum. Planeia como se esta porta estivesse fechada. Se se abrir para ti, será porque o Airbnb te ligou.

2. Cada anfitrião autoriza a tua app

A aprovação como parceiro só te deixa pedir. Cada anfitrião passa pelo ecrã de consentimento do Airbnb, escolhe o que a tua app pode fazer e concede tokens para a sua conta. Um anfitrião, uma autorização, revogável a qualquer momento.

3. Cada anúncio é aberto à API

Este é o passo que apanha toda a gente de surpresa. Autorizar a conta não abre os anúncios que estão nela. Cada anúncio tem a sua própria definição de sincronização:

Definições de sincronização por anúncio no Airbnb
Definição do anúncioO que funciona
Conteúdo, tarifas e disponibilidadeTudo
Só tarifas e disponibilidadeEscritas de calendário e preços; o conteúdo fica com o anfitrião
Não ligadoQualquer escrita é recusada

Por isso, «ligámos o Airbnb mas os preços não sincronizam em três dos quarenta anúncios» quase nunca é um problema de autenticação, e mandar o anfitrião outra vez pelo OAuth não muda nada. Mostra este estado por anúncio no teu produto desde o primeiro dia.

Que nível de acesso deve a tua app pedir?

Os anfitriões não concedem «o Airbnb». Concedem um de três níveis, e o que pedires decide se a ligação chega sequer a acontecer.

Níveis de acesso do Airbnb
Nível de acessoPodesUsa-o para
Acesso total (gestão de propriedades)Ler tudo; escrever anúncios, calendário e preçosUm PMS ou channel manager
Mensagens e avaliaçõesLer tudo; enviar mensagens a hóspedes; responder a avaliaçõesMensagens com IA, caixa de entrada unificada, ferramentas de avaliações
Só leituraLer anúncios, reservas, calendários, mensagens e avaliaçõesAnalytics, contabilidade, relatórios de receita

O acesso total é exclusivo: uma app por conta de anfitrião

Uma conta de anfitrião só pode dar a gestão de propriedades a uma app de cada vez. Se o anfitrião já usa Hostaway, Guesty, Lodgify ou qualquer outro PMS, um pedido de acesso total falha no ecrã de consentimento, à frente do cliente que estás a integrar.

As ligações de mensagens e só de leitura ficam ao lado desse PMS sem lhe tocar. Se o teu produto é uma IA de mensagens com hóspedes, uma ferramenta de avaliações ou um dashboard, pede o nível mais restrito: ligas-te sem atrito ao lado da configuração que o anfitrião já tem, e um ecrã de consentimento mais curto converte melhor.

As tuas quatro opções em 2026

Opção 1: esperar pelo Airbnb

Se estás a construir um PMS completo com oferta real por trás, vale a pena seres conhecido da equipa de parceiros do Airbnb. Só não ponhas o teu roadmap à espera disso: não há candidatura, nem fila, nem prazo.

Opção 2: iCal

Cada anúncio do Airbnb exporta um link iCal. É gratuito e não precisa de aprovação. E também só traz as datas bloqueadas: nada de nomes de hóspedes, preços, mensagens ou avaliações, e o Airbnb atualiza-o ao seu próprio ritmo. Serve para um calendário pessoal; não para um produto.

Opção 3: scraping ou automação do browser

Não o faças. Viola os termos do Airbnb, quem corre o risco é a conta do anfitrião, e deixa de funcionar sem aviso quando o site muda. Um anfitrião que perde a conta por causa da tua integração não volta.

Opção 4: integrar através de um parceiro aprovado

As empresas com acesso de parceiro do Airbnb disponibilizam-no a outras equipas de software através da sua própria API. Tu chamas a API delas, os anfitriões ligam-se no ecrã de consentimento do Airbnb através da integração do parceiro, e tu constróis o teu produto em vez de esperar.

O que verificar antes de escolher um parceiro

Comparamos as principais opções lado a lado, com fontes, em A Repull comparada: Channex, Rentals United e NextPax.

Como funciona com a Repull

A Repull é a opção 4: uma única API para Airbnb, Booking.com, Vrbo e mais canais, além de 14 sistemas de gestão de propriedades. Ligas-te através da integração de parceiro do Airbnb que a Repull já tem, por isso não há nada a pedir. Cria uma sessão Connect, envia o anfitrião para lá e recebe uma ligação de volta:

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 é full_access, messaging ou read_only. Se o omitires, é o anfitrião que escolhe o nível na página de consentimento. O anfitrião aprova no Airbnb e volta ao teu redirectUrl. A partir daí:

# 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." }'

Subscreve reservation.message.received e as novas mensagens de hóspedes chegam ao teu servidor como webhooks assinados, reenviados com backoff se o teu endpoint estiver em baixo. A Repull também te diz, anúncio a anúncio, se o Airbnb aceita escritas, e recusa uma escrita que sabe que o Airbnb vai rejeitar antes de enviar o que quer que seja:

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"

Ao lado do PMS do anfitrião

O Booking.com e o Vrbo ligam-se pela mesma sessão Connect, seja ao lado do PMS que o anfitrião já tem, seja como channel manager. Consulta Usar a Repull ao lado de um PMS e Ligar uma conta Airbnb.

Queres que o Claude ou o ChatGPT trabalhem diretamente com uma conta Airbnb? O servidor MCP do Airbnb liga-os através da mesma integração, e este tutorial constrói em cima dele um agente de mensagens com hóspedes.

Experimenta num anúncio real. O plano Free é uma key live. Liga um dos teus próprios anúncios em modo de mensagens ou só leitura (nada muda no anúncio) e vê os teus próprios dados em poucos minutos. Cria uma conta gratuita, ou compara planos na página de preços.

Perguntas frequentes

Posso candidatar-me a parceiro de software do Airbnb?

De momento, não. A página de parceiros do Airbnb diz que não está a aceitar novos pedidos de acesso à sua API, e que os seus partner managers contactam potenciais parceiros com base na oferta que a empresa representa, na solidez da sua tecnologia e na capacidade de apoiar clientes em comum. Não há formulário para preencher nem fila de espera.

Existe uma API do Airbnb gratuita?

Não. O Airbnb não vende nem oferece API keys, e não há um plano público para programadores. A única exportação gratuita e sem autorização é o link iCal de cada anúncio, que só traz as datas bloqueadas.

Existe uma sandbox da API do Airbnb?

Não. O Airbnb não disponibiliza anúncios de teste nem uma sandbox aos programadores. As integrações são testadas em anúncios reais, e uma ligação de mensagens ou só de leitura é a forma segura de o fazer, porque nenhuma das duas consegue alterar um anúncio, o seu calendário ou os seus preços.

Posso obter dados do Airbnb sem autorização do anfitrião?

Não através de nenhuma API legítima. Cada ligação é autorizada pelo anfitrião no ecrã de consentimento do próprio Airbnb, uma conta de cada vez, e o anfitrião pode revogá-la. Fazer scraping de páginas públicas viola os termos do Airbnb e, de qualquer forma, não vê reservas, mensagens nem pagamentos.

A minha app pode ligar-se se o anfitrião já usar um PMS?

Sim, com acesso de mensagens ou só de leitura. O Airbnb só deixa uma app ter a gestão de propriedades (acesso total) numa conta de anfitrião, por isso um pedido de acesso total falha quando o anfitrião já sincroniza com um PMS ou um channel manager. Os pedidos de mensagens e só de leitura pedem permissões mais restritas e ligam-se ao lado dele.

Porque é que um anúncio do Airbnb ligado continua a recusar escritas?

O Airbnb autoriza a sincronização por API anúncio a anúncio. Um anúncio configurado para sincronizar só tarifas e disponibilidade aceita escritas de calendário e preços, mas não de conteúdo, e um anúncio que não está ligado recusa qualquer escrita. Mandar o anfitrião outra vez pelo OAuth não muda nada; é o anfitrião que ativa o anúncio no Airbnb.

Um anúncio no Airbnb e no Booking.com conta duas vezes na Repull?

Não. Um anúncio conta uma vez, independentemente dos canais em que está. Os planos e o que incluem estão na página de preços da Repull.

Onde é que a API do Airbnb fica aquém?

Não tem dados de pesquisa, nem dados de mercado, nem acesso aos anúncios de outros anfitriões. Só chega às contas cujos anfitriões autorizaram a tua app, e as escritas em anúncios só funcionam nos anúncios que o anfitrião abriu à API.

Vais construir sobre o Airbnb em grande escala?

Diz-nos o que estás a construir, quantos anúncios esperas e de que canais precisas além do Airbnb. Dizemos-te como fica a integração e quanto custa.

Escreve-nos sobre acesso e preçosLê o guia de início rápido

Continua a ler