Ingresos de Airbnb para una lista de direcciones en Hojas de cálculo de Google
Pegue direcciones en una hoja de cálculo, seleccione las filas y cada fila recibirá ingresos, tarifa por noche, ocupación, flujo de efectivo y un enlace al informe de la API de BNBCalc.
Configurar la hoja
Ponga una propiedad por fila, con encabezados en la fila 1: la dirección en la columna A y luego dormitorios, baños, huéspedes y precio de compra en las columnas B a E. El script completa los ingresos, la tarifa por noche, la ocupación, el flujo de efectivo y el enlace al informe en las columnas F a J, y escribe cualquier error en la columna K.
Añadir el script
En la hoja, abra Extensiones y luego Apps Script, reemplace el código por el script de abajo y guárdelo. En Configuración del proyecto, añada una propiedad de script llamada BNBCALC_API_KEY con su clave de API como valor y vuelva a cargar la hoja. Cree una clave en su configuración de BNBCalc si aún no tiene 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,
"",
]]);
}
}Ejecutar el script
Seleccione las filas que quiere analizar y elija BNBCalc > Analyze selected rows. La primera vez, Google le pedirá que autorice el script. Cada informe cuesta $0.20, y las filas que ya tienen un enlace al informe se omiten. Para no superar el límite de seis minutos de Apps Script, cada ejecución se detiene a los cuatro minutos; vuelva a ejecutarlo para el resto.
¿Por qué un menú y no una fórmula?
Una fórmula personalizada como =BNBCALC(A2) parece más sencilla, pero Hojas de cálculo de Google puede volver a ejecutar las fórmulas al reabrir la hoja o al cambiar una celda, y cada nueva ejecución crearía, y facturaría, un informe nuevo. Además, las fórmulas personalizadas se cortan a los 30 segundos. Un menú solo se ejecuta cuando usted lo elige.
Documentación de la API de Airbnb, precios, casos de uso y comparaciones
Documentación de la API
Referencia de endpoints con autenticación, parámetros, ejemplos de código, ejemplos de respuestas y códigos de error.
Precios de la API
Vea lo que cuesta la API de BNBCalc: $0 al mes, $0.20 por informe y $0.10 por cada paso de IA completado.
Casos de uso de la API
Descubre cómo plataformas PropTech, inversores, prestamistas, operadores y analistas usan la API en flujos de trabajo de producción.
Cobertura de datos
Comprende la cobertura de propiedades internacionales, estimaciones basadas en comparables, entradas de ubicación y dónde encaja la API.
Comparación de APIs
Vea cómo la API de BNBCalc se compara con la API de AirDNA y otras APIs de datos de Airbnb en cuanto a acceso, modelo de precios y resultados.
Servidor MCP
Conecte Claude, Cursor o VS Code a BNBCalc y ejecute estimaciones de ingresos y análisis de acuerdos desde su asistente de IA.
Guía de configuración de MCP
Conecta Claude, ChatGPT, Claude Code, Cursor o VS Code al servidor MCP, paso a paso.
Referencia MCP
Cómo se autentica el servidor MCP, cada herramienta con su precio, la aprobación de herramientas de pago y los límites.
Registro de cambios
Qué ha cambiado en la API REST y el servidor MCP, lo más reciente primero.
Estado
Comprobaciones en vivo de la API REST y del servidor MCP.
Empieza a construir con la API de datos de Airbnb de BNBCalc
Genera tu clave de API, revisa la documentación pública y añade análisis de ingresos de STR respaldados por comparables, informes completos y URLs de informes hospedados a tu producto.