Airbnb-Umsatz für eine Liste von Adressen in Google Tabellen

Fügen Sie Adressen in eine Tabelle ein, wählen Sie die Zeilen aus, und jede Zeile erhält Umsatz, Übernachtungspreis, Auslastung, Cashflow und einen Berichtslink von der BNBCalc-API.

Dokumentation anzeigen

Tabelle einrichten

Tragen Sie eine Immobilie pro Zeile ein, mit Überschriften in Zeile 1: die Adresse in Spalte A, dann Schlafzimmer, Badezimmer, Gäste und Kaufpreis in den Spalten B bis E. Das Skript trägt Umsatz, Übernachtungspreis, Auslastung, Cashflow und den Berichtslink in die Spalten F bis J ein und schreibt Fehler in Spalte K.

Skript hinzufügen

Öffnen Sie in der Tabelle Erweiterungen und dann Apps Script, ersetzen Sie den Code durch das Skript unten und speichern Sie. Fügen Sie unter Projekteinstellungen eine Skripteigenschaft namens BNBCALC_API_KEY mit Ihrem API-Schlüssel als Wert hinzu und laden Sie die Tabelle neu. Erstellen Sie einen Schlüssel in Ihren BNBCalc-Einstellungen, falls Sie noch keinen haben.

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

Ausführen

Wählen Sie die zu analysierenden Zeilen aus und klicken Sie auf BNBCalc > Analyze selected rows. Beim ersten Mal bittet Google Sie, das Skript zu autorisieren. Jeder Bericht kostet $0.20, und Zeilen, die schon einen Berichtslink haben, werden übersprungen. Damit das Sechs-Minuten-Limit von Apps Script nicht greift, stoppt ein Lauf nach vier Minuten; starten Sie ihn dann erneut für die restlichen Zeilen.

Warum ein Menü und keine Formel

Eine benutzerdefinierte Formel wie =BNBCALC(A2) wirkt einfacher, aber Google Tabellen kann Formeln beim erneuten Öffnen oder bei einer Zelländerung neu berechnen, und jede Neuberechnung würde einen neuen Bericht erstellen und abrechnen. Benutzerdefinierte Formeln werden außerdem nach 30 Sekunden abgebrochen. Ein Menü läuft nur, wenn Sie es auswählen.

Airbnb API-Dokumentation, Preise, Anwendungsfälle und Vergleiche

API-Dokumentation

Endpunkt-Referenz mit Authentifizierung, Parametern, Codebeispielen, Antwortbeispielen und Fehlercodes.

API-Preise

Sehen Sie, was die BNBCalc API kostet: $0 im Monat, $0.20 pro Bericht und $0.10 pro abgeschlossenem KI-Schritt.

API-Anwendungsfälle

Sehen Sie, wie PropTech-Plattformen, Investoren, Kreditgeber, Betreiber und Analysten die API in Produktions-Workflows nutzen.

Datenabdeckung

Verstehen Sie den internationalen Immobilienbereich, vergleichsbasierte Schätzungen, Standortangaben und wo die API passt.

API-Vergleich

Sehen Sie, wie die BNBCalc API im Vergleich zur AirDNA API und anderen Airbnb Daten APIs in Bezug auf Zugriff, Preismodell und Ausgabe abschneidet.

MCP-Server

Verbinden Sie Claude, Cursor oder VS Code mit BNBCalc und führen Sie Umsatzschätzungen und Deal-Analysen von Ihrem KI-Assistenten aus.

Anleitungen zur MCP-Einrichtung

Verbinden Sie Claude, ChatGPT, Claude Code, Cursor oder VS Code Schritt für Schritt mit dem MCP-Server.

MCP-Referenz

Wie der MCP-Server authentifiziert, jedes Werkzeug mit seinem Preis, die Genehmigung von kostenpflichtigen Werkzeugen und Grenzen.

Änderungsprotokoll

Was hat sich in der REST API und dem MCP-Server geändert, neueste zuerst.

Status

Live-Prüfungen der REST-API und des MCP-Servers.

Beginnen Sie mit der Entwicklung mit der BNBCalc Airbnb-Daten-API

Generieren Sie Ihren API-Schlüssel, überprüfen Sie die öffentlichen Dokumente und fügen Sie vergleichsbasierte STR-Einnahmenanalysen, vollständige Berichte und gehostete Bericht-URLs zu Ihrem Produkt hinzu.

Dokumentation anzeigen