API de données Airbnb pour revenus STR et analyse immobilière
Utilisez l'API BNBCalc pour transformer n'importe quelle adresse de propriété en estimations de revenus Airbnb, taux d'occupation, ADR, comparables Airbnb actifs, percentiles, flux de trésorerie, indicateurs d'investissement et un URL de rapport public hébergé via une interface REST documentée.
- Annonces analysées
- 10M+
- Marchés couverts
- 2,300+
- Comparables par analyse
- Jusqu'à 50
curl -X POST \
'https://atlas.bnbcalc.com/v1/external/analysis/create/buy' \
-H "x-bnbcalc-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"lat": 27.7676,
"lng": -82.6403,
"bedrooms": 3,
"bathrooms": 2,
"accomodates": 6,
"purchasePriceUSD": 400000
}'const response = await fetch(
'https://atlas.bnbcalc.com/v1/external/analysis/create/buy',
{
method: 'POST',
headers: {
'x-bnbcalc-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"lat": 27.7676,
"lng": -82.6403,
"bedrooms": 3,
"bathrooms": 2,
"accomodates": 6,
"purchasePriceUSD": 400000
})
}
);
const data = await response.json();import json
import requests
data = json.loads(r'''{
"lat": 27.7676,
"lng": -82.6403,
"bedrooms": 3,
"bathrooms": 2,
"accomodates": 6,
"purchasePriceUSD": 400000
}''')
response = requests.post(
'https://atlas.bnbcalc.com/v1/external/analysis/create/buy',
headers={
'x-bnbcalc-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
json=data
)
data = response.json()Exemple rapide – Créer une analyse d'achat
Qu'est-ce que l'API de données Airbnb BNBCalc ?
L'API BNBCalc est une API de données Airbnb qui renvoie des projections de revenus de location à court terme (STR) et des métriques d'investissement pour des adresses aux États-Unis et à l'international. Envoyez un emplacement plus quelques détails sur la propriété (chambres, salles de bain et nombre d'invités), et elle renvoie un modèle de souscription complet sous forme de JSON : tarif journalier moyen (ADR) projeté, taux d'occupation, revenus annuels, dépenses d'exploitation, flux de trésorerie, taux de capitalisation, rendement du cash-on-cash, données de percentiles, annonces comparables actives sur Airbnb et une URL de rapport BNBCalc publique hébergée.
C'est une API de données Airbnb tierce, pas l'API Partenaire officielle d'Airbnb. L'API Partenaire d'Airbnb est limitée aux gestionnaires immobiliers et aux gestionnaires de canaux vérifiés et ne gère que les flux de travail opérationnels tels que la synchronisation des annonces et la messagerie. Elle n'expose pas les analyses de revenus ou d'occupation. BNBCalc comble cette lacune : le même moteur derrière notre calculateur de location à court terme, disponible en quatre points d'accès programmatiques pour que vous puissiez intégrer l'analyse STR directement dans votre produit, vos rapports ou vos feuilles de calcul, sans aucun scraping requis.
Tout fonctionne via une URL de base authentifiée : https://atlas.bnbcalc.com
L'API de données Airbnb pour la souscription de revenus, pas le scraping brut
La plupart des pages API Airbnb proposent une projection ou un énorme ensemble de données. BNBCalc se concentre sur le flux de travail dont les équipes ont réellement besoin : transformer une adresse en revenus STR, taux d’occupation, percentiles, données comparables complètes, métriques d'investissement et une URL de rapport hébergée.
API tierce de données Airbnb
L'API Partner officielle d'Airbnb est conçue pour des partenaires opérationnels approuvés, pas pour l'analyse de marché ouverte. BNBCalc offre aux développeurs une API tierce pour l'analyse des revenus et des investissements.
Pas de processus d'approbation de l'API Partner d'Airbnb
Renvoie ADR, taux d'occupation, revenus, flux de trésorerie et comparables
Conçu pour l'évaluation, les tableaux de bord et le reporting
Différent d'AirDNA et Mashvisor
AirDNA et Mashvisor servent chacun des flux de données STR utiles. BNBCalc est l'API d'analyse de propriété conviviale pour les développeurs destinée aux équipes qui souhaitent une souscription au niveau de l'adresse, des métriques, des comparables et une URL de rapport hébergée dans leur propre produit.
Quatre endpoints d'analyse spécifiques à la stratégie
Estimations soutenues par des comparables, percentiles et comparables Airbnb actifs pour chaque adresse soumise
Réponses JSON claires, documents publics et URLs de rapport hébergés compatibles avec les mobiles
Accès API basé sur l'utilisation
Commencez avec l'API depuis votre tableau de bord BNBCalc, générez une clé et payez pour les usages réussis au lieu de maintenir un scraper ou d'acheter une licence de tableau de bord pour chaque workflow.
Abonnement $0/mo pour l'accès à l'API
$0.20 par rapport créé avec succès, plus $0.10 par étape d'IA terminée
Annulez à tout moment depuis votre tableau de bord
Quatre endpoints d'analyse, un format cohérent
Choisissez le point d'accès qui correspond à l'affaire que vous modélisez. Les quatre acceptent la même saisie de localisation (lat/lng ou une adresse complète) et renvoient du JSON ainsi qu'une URL de rapport BNBCalc publique hébergée.
POST /v1/external/analysis/create/buy
Créer une analyse d'achat
Créer une nouvelle analyse d'achat pour une propriété. Nécessite des détails sur la propriété, des informations sur l'emplacement et le prix d'achat.
Renvoie: ADR projeté, occupation, revenus annuels, flux de trésorerie, taux de capitalization, retour en espèces sur espèces, percentiles, une URL de rapport hébergé et les comparables Airbnb actifs derrière l'estimation.
Voir la documentationPOST /v1/external/analysis/create/arb
Créer une analyse d'arbitrage
Créez une nouvelle analyse d'arbitrage (arbitrage locatif) pour un bien immobilier. Utilise les mêmes champs obligatoires que l'analyse d'achat.
Renvoie: Revenus projetés et flux de trésorerie pour une unité de location-arbitrage, net de votre loyer mensuel, plus percentiles, une URL de rapport hébergé, et des comparables de soutien.
Voir la documentationPOST /v1/external/analysis/create/owned
Créer une analyse personnelle
Créer une nouvelle analyse pour un bien immobilier détenu. Utilise les mêmes champs obligatoires que l'analyse d'achat.
Renvoie: Métriques de retour complètes pour une propriété que vous possédez déjà : flux de trésorerie, ROI, remboursement du principal, appréciation, percentiles, comparables et une URL de rapport hébergée utilisant vos conditions hypothécaires.
Voir la documentationPOST /v1/external/analysis/create/cohost
Créer une analyse Cohost
Créer l'historique des co-hôtes
Renvoie: Revenus projetés de co-hébergement, votre commission, retour net d'hôte, percentiles, comparables et une URL de rapport hébergé.
Voir la documentationVotre premier appel en trois étapes
La plupart des développeurs effectuent une requête réussie en quelques minutes après avoir généré une clé.
- 1
Créez un compte BNBCalc et générez une clé API dans les paramètres de votre tableau de bord.
- 2
Envoyez votre clé dans l'en-tête x-bnbcalc-api-key à chaque requête.
- 3
POST a property's location and details to any analysis endpoint and read the JSON response, including the hosted report URL.
Exemple de réponse
{
"success": true,
"data": {
"_id": "000000000000000000000000",
"url": "https://www.bnbcalc.com/analysis/example-property/000000000000000000000000",
"currency": "USD",
"ratePerNightUSD": 364.73770491803276,
"occupancyRatePercentage": 48,
"bedrooms": 4,
"bathrooms": 4,
"commonSpaces": 1,
"accomodates": 12,
"fullAddress": "4935 2nd Avenue North, St. Petersburg, FL 33703",
"location": {
"type": "Point",
"coordinates": [
-82.6403,
27.7676
]
},
"revenue": {
"p25": 48210,
"p50": 58440,
"p75": 63944.76398163934,
"p90": 74280,
"avg": 60310
},
"adr": {
"p25": 214,
"p50": 288,
"p75": 364.73770491803276,
"p90": 431,
"avg": 318
},
"occupancy": {
"p25": 0.38,
"p50": 0.44,
"p75": 0.48,
"p90": 0.56,
"avg": 0.46
},
"quartiles": {
"25th_percentile": {
"average_daily_rate": 214,
"occupancy_rate": 38,
"revenue": 48210
},
"50th_percentile": {
"average_daily_rate": 288,
"occupancy_rate": 44,
"revenue": 58440
},
"75th_percentile": {
"average_daily_rate": 364.73770491803276,
"occupancy_rate": 48,
"revenue": 63944.76398163934
},
"90th_percentile": {
"average_daily_rate": 431,
"occupancy_rate": 56,
"revenue": 74280
}
},
"comparables": [
{
"airbnbId": "12345678",
"name": "Modern 4BR near downtown",
"listingUrl": "https://www.airbnb.com/rooms/12345678",
"bedrooms": 4,
"bathrooms": 3,
"accommodates": 10,
"annualRevenueUSD": 68420,
"occupancyRatePercentage": 52,
"averageDailyRateUSD": 361,
"distanceMiles": 0.4,
"photo_urls": [
"https://a0.muscache.com/im/pictures/example/cover.jpg",
"https://a0.muscache.com/im/pictures/example/living-room.jpg",
"https://a0.muscache.com/im/pictures/example/kitchen.jpg"
]
}
],
"downPaymentPercentage": 20,
"mortgageLength": 30,
"yearsRemainingOnMortgage": 30,
"interestRatePercentage": 4,
"propertyTaxPercentage": 0.75,
"monthlyRevenueUSD": 5328.730331803278,
"monthlyExpensesUSD": 1474.1603364983607,
"monthlyTaxesUSD": 250,
"yearOneRevenueUSD": 63944.76398163934,
"yearOneOperatingIncomeUSD": 46254.83994365901,
"yearOneMorgageAndTaxesUSD": 21324,
"yearOneCashFlowUSD": 24930.83994365901,
"yearOneCashOnCashPercentage": 24.86817214984141,
"yearOneCapRatePercentage": 11.563709985914752,
"yearOneReturnOnInvestmentPercentage": 63.78402823049849,
"yearOnePrincipalPaydownUSD": 85635.31658640636,
"yearOnePrincipalPaidUSD": 5635.31658640636,
"yearOneAppreciationUSD": 12000,
"totalCashInvestment": 100252,
"ltrPerMonthUSD": 1500,
"ltrMonthlyExpensesPercentage": 10,
"revenueBasis": "full_time_potential",
"actualAnnualRevenue": {
"p25": 24180,
"p50": 36920,
"p75": 47350,
"p90": 58810,
"average": 37640
}
}
}Ce que vous pouvez créer avec
De l'analyse d'acquisition aux plateformes PropTech, l'API élimine les aspects les plus complexes liés aux données de locations de courte durée.
Outils d'analyse et d'acquisition
Évaluez les opportunités selon le rendement cash-on-cash projeté ou le taux de capitalisation dès la saisie d'une adresse.
PropTech et plateformes d'annonces
Affichez les revenus Airbnb estimés sur les annonces de biens à vendre et les pages de propriété, à grande échelle.
Tableaux de bord de gestion locative
Comparez les unités détenues aux comparables locaux et mettez en avant le potentiel de revenus pour les clients.
Fonds, analystes et consultants
Intégrez ADR, taux d'occupation et revenus dans vos modèles d'acquisition et vos études de marché sans maintenir un scraper.
Rapports internes et feuilles de calcul
Automatisez les estimations de revenus de locations de courte durée dans vos propres modèles, fiches d'analyse et rapports.
Co-hébergement et opérateurs STR
Proposez aux propriétaires des estimations réalistes de revenus et de partages de commission avant de prendre en charge une nouvelle annonce.
Utilisez BNBCalc depuis votre assistant IA
Connectez Claude, ChatGPT, Cursor ou VS Code au serveur BNBCalc MCP en vous connectant et obtenez des estimations de revenus, des comparatifs et des analyses d'offres dans le chat. Il fonctionne avec le même abonnement API basé sur l'utilisation que l'API REST.
URL du connecteur personnalisé
https://atlas.bnbcalc.com/mcpDans Claude, ouvrez Paramètres, puis Personnaliser, et ajoutez un connecteur personnalisé avec cette URL. Connectez-vous à BNBCalc lorsque vous y êtes invité.
URL du connecteur personnalisé
https://atlas.bnbcalc.com/mcpDans ChatGPT, ouvrez Paramètres, puis Plugins, cliquez sur Parcourir le répertoire et ajoutez un serveur MCP personnalisé avec cette URL et OAuth. Connectez-vous à BNBCalc lorsque vous y êtes invité.
Terminal
claude mcp add --transport http --scope user bnbcalc https://atlas.bnbcalc.com/mcpExécutez ceci dans un terminal, puis tapez /mcp dans Claude Code, sélectionnez bnbcalc et choisissez Authentifier.
~/.cursor/mcp.json
{
"mcpServers": {
"bnbcalc": {
"url": "https://atlas.bnbcalc.com/mcp"
}
}
}Cliquez sur Ajouter à Cursor, ou enregistrez ce fichier. Connectez ensuite bnbcalc dans les paramètres MCP de Cursor et connectez-vous à BNBCalc.
.vscode/mcp.json
{
"servers": {
"bnbcalc": {
"type": "http",
"url": "https://atlas.bnbcalc.com/mcp"
}
}
}Cliquez sur Installer dans VS Code, ou enregistrez ce fichier. Démarrez ensuite le serveur bnbcalc et autorisez la connexion BNBCalc lorsque VS Code le demande.
Pour vérifier que cela fonctionne, demandez « Quelle est mon utilisation de BNBCalc MCP ce mois-ci ? ». C'est gratuit. Guide de configuration
Des données auxquelles on fait confiance
Questions fréquentes
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.