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.

Visualizar documentação

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.

Visualizar documentação