Przychody Airbnb dla listy adresów w Arkuszach Google

Wklej adresy do arkusza, zaznacz wiersze, a każdy wiersz otrzyma przychody, stawkę za noc, obłożenie, przepływy pieniężne i link do raportu z API BNBCalc.

Zobacz dokumentację

Skonfiguruj arkusz

Umieść jedną nieruchomość na wiersz, z nagłówkami w pierwszym wierszu: adres w kolumnie A, następnie liczbę sypialni, łazienek, gości i cenę zakupu w kolumnach B do E. Skrypt uzupełni przychody, stawkę za noc, obłożenie, przepływy pieniężne i link do raportu w kolumnach F do J oraz zapisze wszelkie błędy w kolumnie K.

Dodaj skrypt

W arkuszu otwórz Rozszerzenia, a następnie Apps Script, zastąp kod poniższym skryptem i zapisz go. W Ustawieniach projektu dodaj właściwość skryptu o nazwie BNBCALC_API_KEY z kluczem API jako wartością, a następnie przeładuj arkusz. Utwórz klucz w ustawieniach BNBCalc, jeśli go nie masz.

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

Uruchom skrypt

Zaznacz wiersze do analizy i wybierz BNBCalc > Analyze selected rows. Za pierwszym razem Google poprosi o autoryzację skryptu. Każdy raport kosztuje $0.20, a wiersze, które mają już link do raportu, są pomijane. Aby zmieścić się w sześciominutowym limicie Apps Script, uruchomienie zatrzymuje się po czterech minutach; uruchom skrypt ponownie dla pozostałych wierszy.

Dlaczego menu, a nie formuła

Niestandardowa formuła, taka jak =BNBCALC(A2), wygląda prościej, ale Arkusze Google mogą ponownie przeliczać formuły po ponownym otwarciu arkusza lub zmianie komórki, a każde przeliczenie utworzyłoby nowy raport i naliczyło za niego opłatę. Formuły niestandardowe są też przerywane po 30 sekundach. Menu uruchamia się tylko wtedy, gdy je wybierzesz.

Dokumentacja API Airbnb, ceny, przypadki użycia i porównania

Dokumentacja API

Referencja punktów końcowych z uwierzytelnieniem, parametrami, przykładami kodu, przykładami odpowiedzi i kodami błędów.

Cennik API

Zobacz, ile kosztuje API BNBCalc: $0 miesięcznie, $0.20 za raport i $0.10 za każdy ukończony krok AI.

Przykłady użycia API

Zobacz, jak platformy PropTech, inwestorzy, pożyczkodawcy, operatorzy i analitycy używają API w produkcyjnych przepływach pracy.

Pokrycie danych

Zrozum międzynarodowe pokrycie nieruchomości, oszacowania oparte na porównaniach, dane lokalizacyjne i to, gdzie API pasuje.

Porównanie API

Zobacz, jak API BNBCalc wypada w porównaniu z API AirDNA i innymi API danych Airbnb pod względem dostępu, modelu cenowego i wyników.

Serwer MCP

Połącz Claude, Cursor lub VS Code z BNBCalc i przeprowadzaj szacunki przychodów oraz analizy transakcji ze swojego asystenta AI.

Przewodnik konfiguracji MCP

Połącz Claude, ChatGPT, Claude Code, Cursor lub VS Code z serwerem MCP, krok po kroku.

Referencja MCP

Jak serwer MCP uwierzytelnia, każde narzędzie z ceną, zatwierdzanie płatnych narzędzi i limity.

Dziennik zmian

Co się zmieniło w API REST i serwerze MCP, od najnowszych.

Status

Sprawdzenia na żywo interfejsu API REST i serwera MCP.

Rozpocznij budowanie z API danych Airbnb BNBCalc

Wygeneruj swój klucz API, zapoznaj się z dokumentacją publiczną i dodaj analizę przychodów STR opartą na porównaniach, pełne raporty oraz publiczne adresy URL raportów do swojego produktu.

Zobacz dokumentację