API de Dados do Airbnb para receita STR e análise de propriedades
Use a API do BNBCalc para transformar qualquer endereço de propriedade em estimativas de receita do Airbnb, taxa de ocupação, ADR, comparáveis ativos do Airbnb, percentis, fluxo de caixa, métricas de investimento e uma URL de relatório público hospedado através de uma interface REST documentada.
Gere uma chave no seu painel. Respostas HTTPS, JSON, comparáveis ativos do Airbnb e URLs de relatórios públicos hospedados.
Exemplo rápido – Criar análise de compra
curl -X POST \
https://atlas.bnbcalc.com/v1/external/analysis/create/buy \
-H "x-bnbcalc-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"lat": 27.7676,
"lng": -82.6403,
"bedrooms": 3,
"bathrooms": 2,
"accomodates": 6,
"purchasePriceUSD": 400000
}'const response = await fetch(
'https://atlas.bnbcalc.com/v1/external/analysis/create/buy',
{
method: 'POST',
headers: {
'x-bnbcalc-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"lat": 27.7676,
"lng": -82.6403,
"bedrooms": 3,
"bathrooms": 2,
"accomodates": 6,
"purchasePriceUSD": 400000
})
}
);
const data = await response.json();import json
import requests
data = json.loads(r'''{
"lat": 27.7676,
"lng": -82.6403,
"bedrooms": 3,
"bathrooms": 2,
"accomodates": 6,
"purchasePriceUSD": 400000
}''')
response = requests.post(
'https://atlas.bnbcalc.com/v1/external/analysis/create/buy',
headers={
'x-bnbcalc-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
json=data
)
data = response.json()- 10M+
- Anúncios analisados
- 3M+
- Imóveis analisados
- 3,000+
- Mercados cobertos
- Até 50
- Comparáveis por análise
- 4
- Endpoints de análise
- JSON
- Respostas REST
O que é a API de Dados do Airbnb do BNBCalc?
A API do BNBCalc é uma API de Dados do Airbnb que retorna projeções de receita de aluguel de curto prazo (STR) e métricas de investimento para endereços nos EUA e internacionalmente. Envie uma localização mais alguns detalhes da propriedade — quartos, banheiros e hóspedes — e ela retorna um modelo completo de subscrição em JSON: taxa média diária projetada (ADR), ocupação, receita anual, despesas operacionais, fluxo de caixa, taxa de capitalização, retorno sobre o investimento, dados percentis, listagens comparáveis ativas do Airbnb e uma URL de relatório público hospedado do BNBCalc.
É uma API de dados de terceiros, não a Partner API oficial do Airbnb. A Partner API do Airbnb é limitada a gestores de propriedades e channel managers verificados e lida apenas com fluxos operacionais como sincronização de anúncios e mensagens — ela não fornece análises de receita ou ocupação. O BNBCalc preenche essa lacuna: o mesmo motor por trás do nosso calculador de short-term rental, disponível como quatro endpoints programáticos para que você possa incorporar a análise STR diretamente no seu produto, relatórios ou planilhas — sem necessidade de scraping.
Tudo funciona por meio de uma URL base autenticada: https://atlas.bnbcalc.com
Por que BNBCalc
Feito para desenvolvedores, baseado em comparáveis reais
Evite o raspador e a modelagem. Obtenha estimativas de aluguel de curto prazo defensáveis, comparáveis completas, percentis e um relatório hospedado a partir de uma única chamada REST.
Precisão baseada em comparáveis
As estimativas são derivadas de até 50 anúncios comparáveis ativos ao redor de cada endereço — refletindo o submercado real, não uma média nacional.
REST amigável para desenvolvedores
Endpoints JSON limpos e previsíveis, autenticação via um único cabeçalho e exemplos para copiar e colar em cURL, JavaScript e Python. HTTPS em todos os lugares.
Um motor, quatro estratégias
O mesmo motor de análise que alimenta o BNBCalc, exposto para compra, arbitragem de aluguel, propriedade própria e co-hosting.
Por que BNBCalc
A API de Dados do Airbnb para subscrição de receita, não raspagem bruta
A maioria das páginas de API do Airbnb vende uma projeção ou um enorme conjunto de dados. O BNBCalc é focado no fluxo de trabalho que as equipes realmente precisam: transformar um endereço em receita de STR, ocupação, percentis, dados comparáveis completos, métricas de investimento e uma URL de relatório hospedado.
API de dados do Airbnb de terceiros
A API Partner oficial do Airbnb é construída para parceiros operacionais aprovados, não para análises de mercado aberto. O BNBCalc oferece aos desenvolvedores uma API de terceiros para análise de receita e investimento.
Sem processo de aprovação da API Partner do Airbnb
Retorna ADR, ocupação, receita, fluxo de caixa e comps
Projetada para underwriting, painéis e relatórios
Diferente do AirDNA, Mashvisor e AirROI
AirDNA, Mashvisor e AirROI oferecem fluxos de trabalho úteis de dados de STR. O BNBCalc é a API de análise de propriedade amigável ao desenvolvedor para equipes que desejam underwriting completo em nível de endereço, métricas, comps e uma URL de relatório hospedado dentro do seu próprio produto.
Quatro endpoints de análise específicos por estratégia
Estimativas baseadas em comparáveis, percentis e comps ativos do Airbnb para cada endereço enviado
Respostas JSON limpas, documentação pública e URLs de relatórios hospedados otimizados para dispositivos móveis
Acesso à API baseado em uso
Comece com a API no seu painel do BNBCalc, gere uma chave e pague pelo uso bem-sucedido em vez de manter um scraper ou comprar um assento de painel para cada fluxo de trabalho.
$0/mo assinatura para acesso à API
$0.20 por relatório criado com sucesso
Cancele a qualquer momento a partir do seu painel
Pontos de extremidade
Quatro endpoints de análise, com formato consistente
Escolha o endpoint que corresponde ao negócio que você está modelando. Todos os quatro aceitam a mesma entrada de localização — lat/lng ou um endereço completo — e retornam JSON mais uma URL de relatório público hospedado do BNBCalc.
/v1/external/analysis/create/buy
Criar Análise de Compra
Criar uma nova análise de compra para um imóvel. Requer detalhes do imóvel, informações sobre a localização e preço de compra.
Retorno: ADR projetado, ocupação, receita anual, fluxo de caixa, taxa de capitalização, retorno sobre o investimento, percentis, uma URL de relatório hospedado e os comparáveis ativos do Airbnb por trás da estimativa.
Ver na documentação/v1/external/analysis/create/arb
Criar análise de arbitragem
Crie uma nova análise de arbitragem (arbitragem de aluguel) para uma propriedade. Usa os mesmos campos obrigatórios que a análise de compra.
Retorno: Receita projetada e fluxo de caixa para uma unidade de aluguel-arbitragem, líquida do seu aluguel mensal, além de percentis, uma URL de relatório hospedado e comparáveis de suporte.
Ver na documentação/v1/external/analysis/create/owned
Criar análise própria
Crie uma nova análise de imóvel próprio. Utiliza os mesmos campos obrigatórios da análise de compra.
Retorno: Métricas de retorno completas para uma propriedade que você já possui — fluxo de caixa, ROI, pagamento do principal, apreciação, percentis, comparáveis e uma URL de relatório hospedado usando os termos do seu financiamento.
Ver na documentação/v1/external/analysis/create/cohost
Criar análise Cohost
Criar histórico de coanfitriões
Retorno: Receita projetada de co-anfitrião, sua comissão, retorno líquido do anfitrião, percentis, comparáveis e uma URL de relatório hospedado.
Ver na documentaçãoSua primeira chamada em três passos
A maioria dos desenvolvedores realiza uma requisição bem-sucedida em minutos após gerar uma chave.
Crie uma conta BNBCalc e gere uma chave de API nas configurações do seu painel.
Envie sua chave no cabeçalho x-bnbcalc-api-key em cada requisição.
POST a property's location and details to any analysis endpoint and read the JSON response, including the hosted report URL.
curl -X POST \
https://atlas.bnbcalc.com/v1/external/analysis/create/buy \
-H "x-bnbcalc-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"lat": 27.7676,
"lng": -82.6403,
"bedrooms": 3,
"bathrooms": 2,
"accomodates": 6,
"purchasePriceUSD": 400000
}'const response = await fetch(
'https://atlas.bnbcalc.com/v1/external/analysis/create/buy',
{
method: 'POST',
headers: {
'x-bnbcalc-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"lat": 27.7676,
"lng": -82.6403,
"bedrooms": 3,
"bathrooms": 2,
"accomodates": 6,
"purchasePriceUSD": 400000
})
}
);
const data = await response.json();import json
import requests
data = json.loads(r'''{
"lat": 27.7676,
"lng": -82.6403,
"bedrooms": 3,
"bathrooms": 2,
"accomodates": 6,
"purchasePriceUSD": 400000
}''')
response = requests.post(
'https://atlas.bnbcalc.com/v1/external/analysis/create/buy',
headers={
'x-bnbcalc-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
json=data
)
data = response.json()Resposta de exemplo
{
"success": true,
"data": {
"_id": "000000000000000000000000",
"url": "https://www.bnbcalc.com/analysis/example-property/000000000000000000000000",
"currency": "USD",
"ratePerNightUSD": 364.73770491803276,
"occupancyRatePercentage": 48,
"bedrooms": 4,
"bathrooms": 4,
"commonSpaces": 1,
"accomodates": 12,
"fullAddress": "4935 2nd Avenue North, St. Petersburg, FL 33703",
"location": {
"type": "Point",
"coordinates": [
-82.6403,
27.7676
]
},
"revenue": {
"p25": 48210,
"p50": 58440,
"p75": 63944.76398163934,
"p90": 74280,
"avg": 60310
},
"adr": {
"p25": 214,
"p50": 288,
"p75": 364.73770491803276,
"p90": 431,
"avg": 318
},
"occupancy": {
"p25": 0.38,
"p50": 0.44,
"p75": 0.48,
"p90": 0.56,
"avg": 0.46
},
"quartiles": {
"25th_percentile": {
"average_daily_rate": 214,
"occupancy_rate": 38,
"revenue": 48210
},
"50th_percentile": {
"average_daily_rate": 288,
"occupancy_rate": 44,
"revenue": 58440
},
"75th_percentile": {
"average_daily_rate": 364.73770491803276,
"occupancy_rate": 48,
"revenue": 63944.76398163934
},
"90th_percentile": {
"average_daily_rate": 431,
"occupancy_rate": 56,
"revenue": 74280
}
},
"comparables": [
{
"airbnbId": "12345678",
"name": "Modern 4BR near downtown",
"listingUrl": "https://www.airbnb.com/rooms/12345678",
"bedrooms": 4,
"bathrooms": 3,
"accommodates": 10,
"annualRevenueUSD": 68420,
"occupancyRatePercentage": 52,
"averageDailyRateUSD": 361,
"distanceMiles": 0.4
}
],
"downPaymentPercentage": 20,
"mortgageLength": 30,
"yearsRemainingOnMortgage": 30,
"interestRatePercentage": 4,
"propertyTaxPercentage": 0.75,
"monthlyRevenueUSD": 5328.730331803278,
"monthlyExpensesUSD": 1474.1603364983607,
"monthlyTaxesUSD": 250,
"yearOneRevenueUSD": 63944.76398163934,
"yearOneOperatingIncomeUSD": 46254.83994365901,
"yearOneMorgageAndTaxesUSD": 21324,
"yearOneCashFlowUSD": 24930.83994365901,
"yearOneCashOnCashPercentage": 24.86817214984141,
"yearOneCapRatePercentage": 11.563709985914752,
"yearOneReturnOnInvestmentPercentage": 63.78402823049849,
"yearOnePrincipalPaydownUSD": 85635.31658640636,
"yearOneAppreciationUSD": 12000,
"totalCashInvestment": 100252,
"ltrPerMonthUSD": 1500,
"ltrMonthlyExpensesPercentage": 10
}
}Experiência do desenvolvedor
Tudo que um desenvolvedor precisa para implementar uma integração com a API do Airbnb
Use uma API REST autenticada para gerar análise de STR, projeções de arbitragem de aluguel, retornos de propriedades próprias, estimativas de co-hosting, comps completos e relatórios públicos hospedados.
Chaves da API do Painel
Crie, rotacione e gerencie sua chave da API do BNBCalc de forma autônoma na seção de acesso à API do seu painel. Mantenha as chaves no lado do servidor.
Exemplos de copiar-colar
Comece com exemplos funcionais de cURL, JavaScript e Python construídos a partir dos mesmos dados de endpoint que a documentação.
Documentação pública
Revise endpoints, parâmetros necessários, campos de localização opcionais, exemplos de respostas e códigos de erro antes de construir.
Cobrança de chamadas bem-sucedidas
Apenas relatórios criados com sucesso são faturáveis, portanto, erros de validação e solicitações falhadas não se tornam custos ocultos.
Casos de uso
O que você pode construir com ela
Da avaliação de aquisição a plataformas PropTech, a API elimina as partes mais difíceis de trabalhar com dados de short-term rental.
Ferramentas de avaliação e aquisição
Avalie negócios pelo retorno cash-on-cash projetado ou cap rate no momento em que um endereço é inserido.
Plataformas PropTech e de anúncios
Mostre a renda estimada do Airbnb em anúncios à venda e páginas de propriedades, em escala.
Dashboards de gestão de propriedades
Compare unidades próprias com comparáveis locais e destaque potencial de receita para clientes.
Fundos, analistas e consultores
Importe ADR, ocupação e receita para modelos de aquisição e pesquisa de mercado sem manter um scraper.
Relatórios internos e planilhas
Automatize estimativas de receita de short-term rental em seus próprios modelos, planilhas de avaliação e relatórios.
Co-hosting e operadores STR
Forneça estimativas realistas de receita e divisão de comissão aos proprietários antes de assumir um novo anúncio.
Dados em que se confia
Recursos da API
Documentação da API do Airbnb, preços, casos de uso e comparações
Explore as páginas públicas da API que respondem às perguntas comuns que desenvolvedores, investidores e equipes de PropTech fazem antes de integrar dados de STR.
Documentação da API
Referência de endpoint com autenticação, parâmetros, exemplos de código, exemplos de resposta e códigos de erro.
Preço da API
Saiba como o acesso à API do BNBCalc funciona com preços de assinatura mensal de $0 e cobrança por relatório criado com sucesso.
Casos de Uso da API
Veja como plataformas de PropTech, investidores, credores, operadores e analistas usam a API em fluxos de trabalho de produção.
Endpoints da API
Compare os quatro endpoints de análise para comprar, arbitragem de aluguel, propriedade própria e estratégias de co-hosting.
Introdução
Gere uma chave da API, envie sua primeira solicitação e leia sua primeira resposta de análise de propriedade.
Cobertura de Dados
Entenda a cobertura internacional de propriedades, estimativas baseadas em comparáveis, entradas de localização e onde a API se encaixa.
Comparação da API
Compare o BNBCalc com a API Partner oficial do Airbnb, AirDNA, Mashvisor, AirROI e abordagens baseadas em scraper.
Perguntas frequentes
Comece a construir com a API de Dados do Airbnb do BNBCalc
Gere sua chave de API, revise os documentos públicos e adicione análises de receita de STR apoiadas por comparáveis, relatórios completos e URLs de relatórios hospedados ao seu produto.