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