Receita do Airbnb para uma lista de endereços no Planilhas Google
Cole endereços em uma planilha, selecione as linhas e cada linha recebe receita, diária, ocupação, fluxo de caixa e um link do relatório da API do BNBCalc.
Configurar a planilha
Coloque um imóvel por linha, com cabeçalhos na linha 1: o endereço na coluna A, depois quartos, banheiros, hóspedes e preço de compra nas colunas B a E. O script preenche receita, diária, ocupação, fluxo de caixa e o link do relatório nas colunas F a J, e escreve qualquer erro na coluna K.
Adicionar o script
Na planilha, abra Extensões e depois Apps Script, substitua o código pelo script abaixo e salve-o. Em Configurações do projeto, adicione uma propriedade de script chamada BNBCALC_API_KEY com sua chave de API como valor, e então recarregue a planilha. Crie uma chave nas suas configurações do BNBCalc se não tiver uma.
Code.gs
const TIMED_OUT = "Timed out: check BNBCalc, then clear this to retry";
function onOpen() {
SpreadsheetApp.getUi()
.createMenu("BNBCalc")
.addItem("Analyze selected rows", "analyzeSelectedRows")
.addToUi();
}
function analyzeSelectedRows() {
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getActiveRange();
const key = PropertiesService.getScriptProperties()
.getProperty("BNBCALC_API_KEY");
const started = Date.now();
for (let row = range.getRow(); row < range.getRow() + range.getNumRows(); row++) {
// Apps Script ends a run at six minutes: stop between rows, not mid-request.
if (Date.now() - started > 4 * 60 * 1000) {
SpreadsheetApp.getActive().toast("Stopped after four minutes. Run it again for the rest.");
return;
}
const [address, bedrooms, bathrooms, guests, price, , , , , report, note] =
sheet.getRange(row, 1, 1, 11).getValues()[0];
// Each report is billed: skip rows that have one or may have one.
if (!address || report || note === TIMED_OUT) continue;
let response = null;
try {
response = UrlFetchApp.fetch("https://atlas.bnbcalc.com/v1/external/analysis/create/buy", {
method: "post",
contentType: "application/json",
headers: { "x-bnbcalc-api-key": key },
payload: JSON.stringify({
fullAddress: address,
bedrooms: bedrooms,
bathrooms: bathrooms,
accomodates: guests,
purchasePriceUSD: price,
}),
muteHttpExceptions: true,
});
} catch (error) {} // No answer: handled below.
const status = response ? response.getResponseCode() : 0;
// No answer or an ambiguous gateway error (502/503/504/524): the request
// may have reached the API and the report may have been created and billed.
if (status === 0 || status === 502 || status === 503 || status === 504 || status === 524) {
sheet.getRange(row, 11).setValue(TIMED_OUT);
continue;
}
let body = {};
try {
body = JSON.parse(response.getContentText());
} catch (error) {} // Not JSON, such as a proxy error page.
if (status >= 400) {
sheet.getRange(row, 11).setValue(status + ": " + String(body.message || "Request failed"));
continue;
}
const a = body.data;
sheet.getRange(row, 6, 1, 6).setValues([[
Math.round(a.yearOneRevenueUSD),
Math.round(a.ratePerNightUSD),
a.occupancyRatePercentage,
Math.round(a.yearOneCashFlowUSD),
a.url,
"",
]]);
}
}Executar o script
Selecione as linhas a serem analisadas e escolha BNBCalc > Analyze selected rows. O Google pedirá para você autorizar o script na primeira vez. Cada relatório custa $0.20, e linhas que já possuem um link de relatório são ignoradas. Para permanecer dentro do limite de seis minutos do Apps Script, uma execução para após quatro minutos; execute-a novamente para o restante.
Por que um menu e não uma fórmula
Uma fórmula personalizada como =BNBCALC(A2) parece mais simples, mas o Planilhas Google pode reexecutar fórmulas quando a planilha é reaberta ou uma célula muda, e cada reexecução criaria, e cobraria, um novo relatório. Fórmulas personalizadas também são interrompidas após 30 segundos. Um menu é executado apenas quando você o escolhe.
Documentação da API do Airbnb, preços, casos de uso e comparações
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
Veja o que a API BNBCalc custa: $0 por mês, $0.20 por relatório e $0.10 por etapa de IA concluída.
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.
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
Veja como a API BNBCalc se compara com a API AirDNA e outras APIs de dados do Airbnb em acesso, modelo de precificação e saída.
Servidor MCP
Conecte Claude, Cursor ou VS Code ao BNBCalc e execute estimativas de receita e análises de negócios do seu assistente de IA.
Guia de configuração MCP
Conecte Claude, ChatGPT, Claude Code, Cursor ou VS Code ao servidor MCP, passo a passo.
Referência MCP
Como o servidor MCP autentica, cada ferramenta com seu preço, aprovação de ferramentas pagas e limites.
Registro de alterações
O que mudou na API REST e no servidor MCP, do mais recente para o mais antigo.
Status
Verificações em tempo real da API REST e do servidor MCP.
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.