Ricavi Airbnb per un elenco di indirizzi in Fogli Google

Incolla gli indirizzi in un foglio, seleziona le righe e ogni riga riceve ricavi, tariffa per notte, occupazione, flusso di cassa e un link al report dall'API di BNBCalc.

Visualizza la documentazione

Imposta il foglio

Inserisci una proprietà per riga, con le intestazioni nella riga 1: l'indirizzo nella colonna A, poi camere da letto, bagni, ospiti e prezzo di acquisto nelle colonne da B a E. Lo script compila ricavi, tariffa per notte, occupazione, flusso di cassa e il link al report nelle colonne da F a J, e scrive eventuali errori nella colonna K.

Aggiungi lo script

Nel foglio, apri Estensioni, quindi Apps Script, sostituisci il codice con lo script sottostante e salvalo. In Impostazioni progetto, aggiungi una proprietà script denominata BNBCALC_API_KEY con la tua chiave API come valore, quindi ricarica il foglio. Crea una chiave nelle tue impostazioni BNBCalc se non ne hai una.

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,
      "",
    ]]);
  }
}

Esegui lo script

Seleziona le righe da analizzare e scegli BNBCalc > Analyze selected rows. Google ti chiederà di autorizzare lo script la prima volta. Ogni report costa $0.20 e le righe che hanno già un link al report vengono saltate. Per rimanere entro il limite di sei minuti di Apps Script, un'esecuzione si ferma dopo quattro minuti; eseguila di nuovo per il resto.

Perché un menu e non una formula

Una formula personalizzata come =BNBCALC(A2) sembra più semplice, ma Fogli Google può rieseguire le formule quando il foglio viene riaperto o una cella cambia, e ogni riesecuzione creerebbe, e addebiterebbe, un nuovo report. Le formule personalizzate vengono anche interrotte dopo 30 secondi. Un menu viene eseguito solo quando lo scegli.

Documentazione API di Airbnb, prezzi, casi d'uso e confronti

Documentazione API

Riferimento degli endpoint con autenticazione, parametri, esempi di codice, esempi di risposta e codici di errore.

Prezzi API

Scopri quanto costa l'API di BNBCalc: $0 al mese, $0.20 per report e $0.10 per ogni passaggio di IA completato.

Casi d'uso API

Vedi come le piattaforme PropTech, gli investitori, i finanziatori, gli operatori e gli analisti utilizzano l'API nei flussi di lavoro di produzione.

Copertura dei dati

Comprendi la copertura delle proprietà internazionali, le stime basate su comparabili, gli input di localizzazione e dove si inserisce l'API.

Confronto API

Vedi come l'API BNBCalc si confronta con l'API di AirDNA e altre API di dati di Airbnb per accesso, modello di prezzo e output.

Server MCP

Collega Claude, Cursor o VS Code a BNBCalc ed esegui stime sui ricavi e analisi delle operazioni dal tuo assistente AI.

Guida alla configurazione MCP

Collega Claude, ChatGPT, Claude Code, Cursor o VS Code al server MCP, passo dopo passo.

Riferimento MCP

Come il server MCP esegue l'autenticazione, ogni strumento con il suo prezzo, l'approvazione degli strumenti a pagamento e i limiti.

Registro delle modifiche

Cosa è cambiato nell'API REST e nel server MCP, in ordine cronologico.

Stato

Controlli live dell'API REST e del server MCP.

Inizia a costruire con l'API dei dati di Airbnb BNBCalc

Genera la tua chiave API, rivedi la documentazione pubblica e aggiungi analisi di reddito STR basate su comparabili, report completi e URL di report ospitati al tuo prodotto.

Visualizza la documentazione