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.
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.