Revenus Airbnb pour une liste d'adresses dans Google Sheets

Collez des adresses dans une feuille de calcul, sélectionnez les lignes et chaque ligne recevra les revenus, le tarif de la nuit, l'occupation, le flux de trésorerie et un lien de rapport de l'API BNBCalc.

Voir la documentation

Configurer la feuille

Mettez une propriété par ligne, avec des en-têtes en ligne 1 : l'adresse dans la colonne A, puis les chambres, salles de bains, voyageurs et le prix d'achat dans les colonnes B à E. Le script remplit les revenus, le tarif par nuit, l'occupation, le flux de trésorerie et le lien du rapport dans les colonnes F à J, et écrit toute erreur dans la colonne K.

Ajouter le script

Dans la feuille, ouvrez Extensions, puis Apps Script, remplacez le code par le script ci-dessous et enregistrez-le. Dans les paramètres du projet, ajoutez une propriété de script nommée BNBCALC_API_KEY avec votre clé API comme valeur, puis rechargez la feuille. Créez une clé dans vos paramètres BNBCalc si vous n'en avez pas.

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

Lancer le script

Sélectionnez les lignes à analyser et choisissez BNBCalc > Analyze selected rows. Google vous demandera d'autoriser le script la première fois. Chaque rapport coûte $0.20, et les lignes qui ont déjà un lien de rapport sont ignorées. Pour rester dans la limite de six minutes d'Apps Script, une exécution s'arrête après quatre minutes ; exécutez-la à nouveau pour le reste.

Pourquoi un menu et pas une formule

Une formule personnalisée telle que =BNBCALC(A2) semble plus simple, mais Google Sheets peut réexécuter les formules lorsque la feuille est rouverte ou qu'une cellule change, et chaque réexécution créerait, et facturerait, un nouveau rapport. Les formules personnalisées sont également coupées après 30 secondes. Un menu ne s'exécute que lorsque vous le choisissez.

Documentation API Airbnb, tarification, cas d'utilisation et comparaisons

Documentation API

Référence des endpoints avec authentification, paramètres, exemples de code, exemples de réponses et codes d'erreur.

Tarification API

Découvrez le coût de l'API BNBCalc : $0 par mois, $0.20 par rapportation et $0.10 par étape d'IA complétée.

Cas d'utilisation API

Découvrez comment les plateformes PropTech, investisseurs, prêteurs, opérateurs et analystes utilisent l'API dans des workflows de production.

Couverture des données

Comprenez la couverture internationale des propriétés, les estimations basées sur des comparables, les entrées de localisation et où l'API s'intègre.

Comparaison d'API

Découvrez comment l'API BNBCalc se compare à l'API d'AirDNA et à d'autres API de données Airbnb en matière d'accès, de modèle de tarification et de résultats.

Serveur MCP

Connectez Claude, Cursor ou VS Code à BNBCalc et exécutez des estimations de revenus et des analyses d'accords à partir de votre assistant IA.

Guide de configuration MCP

Connectez Claude, ChatGPT, Claude Code, Cursor ou VS Code au serveur MCP, étape par étape.

Référence MCP

Comment le serveur MCP s'authentifie, chaque outil avec son prix, l'approbation des outils payants et les limites.

Journal des modifications

Ce qui a changé dans l'API REST et le serveur MCP, du plus récent au plus ancien.

État

Vérifications en direct de l'API REST et du serveur MCP.

Commencez à construire avec l'API de données Airbnb BNBCalc

Générez votre clé API, consultez la documentation publique et ajoutez l'analyse des revenus STR basée sur des comparables, des rapports complets et des URL de rapport hébergées à votre produit.

Voir la documentation