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.

Ver documentación

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.

Ver documentación