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.
- Anúncios analisados
- 10M+
- Mercados cobertos
- 2,300+
- Comparáveis por análise
- Até 50
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()Exemplo rápido – Criar análise de compra
O que é a API de Dados do Airbnb do BNBCalc?
A API 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 como JSON: tarifa diária média (ADR) projetada, ocupação, receita anual, despesas operacionais, fluxo de caixa, taxa de capitalização, retorno cash-on-cash, dados de percentis, listagens comparáveis ativas do Airbnb e um URL de relatório público hospedado do BNBCalc.
É uma API de dados Airbnb de terceiros, não a API Parceira oficial do Airbnb. A API Parceira do Airbnb é limitada a gerentes de propriedades e gerentes de canais aprovados e lida apenas com fluxos de trabalho operacionais, como sincronização de listagens e mensagens. Ela não expõe análises de receita ou ocupação. O BNBCalc preenche essa lacuna: o mesmo mecanismo por trás do nosso calculador de aluguel de curto prazo, disponível em quatro endpoints programáticos para que você possa incorporar análises STR diretamente em seu produto, relatórios ou planilhas, sem necessidade de web scraping.
Tudo funciona por meio de uma URL base autenticada: https://atlas.bnbcalc.com
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 e Mashvisor
AirDNA e Mashvisor 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, mais $0.10 por etapa de IA concluída
Cancele a qualquer momento a partir do seu painel
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 local (lat/lng ou um endereço completo) e retornam JSON mais uma URL de relatório BNBCalc pública hospedada.
POST /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çãoPOST /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çãoPOST /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, amortização de principal, valorização, percentis, comparáveis e um URL de relatório hospedado usando os termos do seu empréstimo.
Ver na documentaçãoPOST /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.
- 1
Crie uma conta BNBCalc e gere uma chave de API nas configurações do seu painel.
- 2
Envie sua chave no cabeçalho x-bnbcalc-api-key em cada requisição.
- 3
POST a property's location and details to any analysis endpoint and read the JSON response, including the hosted report URL.
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,
"photo_urls": [
"https://a0.muscache.com/im/pictures/example/cover.jpg",
"https://a0.muscache.com/im/pictures/example/living-room.jpg",
"https://a0.muscache.com/im/pictures/example/kitchen.jpg"
]
}
],
"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,
"yearOnePrincipalPaidUSD": 5635.31658640636,
"yearOneAppreciationUSD": 12000,
"totalCashInvestment": 100252,
"ltrPerMonthUSD": 1500,
"ltrMonthlyExpensesPercentage": 10,
"revenueBasis": "full_time_potential",
"actualAnnualRevenue": {
"p25": 24180,
"p50": 36920,
"p75": 47350,
"p90": 58810,
"average": 37640
}
}
}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.
Use o BNBCalc do seu assistente de IA
Conecte Claude, ChatGPT, Cursor ou VS Code ao servidor BNBCalc MCP fazendo login e obtenha estimativas de receita, comparáveis e análises de negócios no chat. Ele utiliza a mesma assinatura de API paga por uso da API REST.
URL do conector personalizado
https://atlas.bnbcalc.com/mcpNo Claude, abra Configurações, depois Personalizar e adicione um conector personalizado com esta URL. Faça login no BNBCalc quando solicitado.
URL do conector personalizado
https://atlas.bnbcalc.com/mcpNo ChatGPT, abra Configurações, depois Plugins, clique em Procurar diretório e adicione um servidor MCP personalizado com esta URL e OAuth. Faça login no BNBCalc quando solicitado.
Terminal
claude mcp add --transport http --scope user bnbcalc https://atlas.bnbcalc.com/mcpExecute isto em um terminal, depois digite /mcp no Claude Code, escolha bnbcalc e selecione Autenticar.
~/.cursor/mcp.json
{
"mcpServers": {
"bnbcalc": {
"url": "https://atlas.bnbcalc.com/mcp"
}
}
}Clique em Adicionar ao Cursor, ou salve este arquivo. Em seguida, conecte o bnbcalc nas configurações de MCP do Cursor e faça login no BNBCalc.
.vscode/mcp.json
{
"servers": {
"bnbcalc": {
"type": "http",
"url": "https://atlas.bnbcalc.com/mcp"
}
}
}Clique em Instalar no VS Code, ou salve este arquivo. Em seguida, inicie o servidor bnbcalc e permita o login do BNBCalc quando o VS Code solicitar.
Para verificar se funciona, pergunte “Qual é o meu uso do BNBCalc MCP este mês?”. É grátis. Guia de configuração
Dados em que se confia
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.