Airbnb Data API for STR revenue & property analysis
Use the BNBCalc API to turn any property address into Airbnb revenue estimates, occupancy, ADR, active Airbnb comparables, percentiles, cash flow, investment metrics, and a hosted public report URL through a documented REST interface.
- Listings analyzed
- 10M+
- Markets covered
- 2,300+
- Comparables per analysis
- Up to 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()Quick Example - Create Buy Analysis
What is the BNBCalc Airbnb Data API?
The BNBCalc API is an Airbnb Data API that returns short-term rental (STR) revenue projections and investment metrics for addresses in the U.S. and internationally. Send a location plus a few property details (bedrooms, bathrooms, and guests), and it returns a full underwriting model as JSON: projected average daily rate (ADR), occupancy, annual revenue, operating expenses, cash flow, cap rate, cash-on-cash return, percentile data, active Airbnb comparable listings, and a hosted public BNBCalc report URL.
It is a third-party Airbnb data API, not Airbnb's official Partner API. Airbnb's Partner API is limited to vetted property managers and channel managers and only handles operational workflows like listing sync and messaging. It does not expose revenue or occupancy analytics. BNBCalc fills that gap: the same engine behind our short-term rental calculator, available as four programmatic endpoints so you can embed STR analysis directly in your product, reports, or spreadsheets, with no scraping required.
Everything runs over one authenticated base URL: https://atlas.bnbcalc.com
The Airbnb Data API for revenue underwriting, not raw scraping
Most Airbnb API pages sell a projection or a giant dataset. BNBCalc is focused on the workflow teams actually need: turning an address into STR revenue, occupancy, percentiles, full comparable data, investment metrics, and a hosted report URL.
Third-party Airbnb data API
Airbnb's official Partner API is built for approved operational partners, not open market analytics. BNBCalc gives developers a third-party API for revenue and investment analysis.
No Airbnb Partner API approval process
Returns ADR, occupancy, revenue, cash flow, and comps
Designed for underwriting, dashboards, and reporting
Different from AirDNA and Mashvisor
AirDNA and Mashvisor each serve useful STR data workflows. BNBCalc is the developer-friendly property analysis API for teams that want full address-level underwriting, metrics, comps, and a hosted report URL inside their own product.
Four strategy-specific analysis endpoints
Comparable-backed estimates, percentiles, and active Airbnb comps for each submitted address
Clean JSON responses, public docs, and mobile-friendly hosted report URLs
Usage-based API access
Start with the API in your BNBCalc dashboard, generate a key, and pay for successful usage instead of maintaining a scraper or buying a dashboard seat for every workflow.
$0/mo subscription for API access
$0.20 per successfully created report, plus $0.10 per AI step that completes
Cancel anytime from your dashboard
Four analysis endpoints, one consistent shape
Pick the endpoint that matches the deal you're modeling. All four take the same location input (lat/lng or a full address) and return JSON plus a hosted public BNBCalc report URL.
POST /v1/external/analysis/create/buy
Create Buy Analysis
Create a buy analysis for a short-term rental acquisition. Send location, property details, and purchase price to return projected revenue, occupancy, comps, cash flow, and ROI metrics.
Returns: Projected ADR, occupancy, annual revenue, cash flow, cap rate, cash-on-cash return, percentiles, a hosted report URL, and the active Airbnb comparables behind the estimate.
View in docsPOST /v1/external/analysis/create/arb
Create Arbitrage Analysis
Create a rental arbitrage analysis for a leased property. Send monthly rent, location, and property details to return projected Airbnb revenue, cash flow, and comparable listings.
Returns: Projected revenue and cash flow for a rental-arbitrage unit, net of your monthly rent, plus percentiles, a hosted report URL, and supporting comparables.
View in docsPOST /v1/external/analysis/create/owned
Create Owned Analysis
Create an owned-property analysis for a property already in your portfolio. Include mortgage terms to return STR revenue, cash flow, principal paydown, appreciation, and ROI metrics.
Returns: Full return metrics for a property you already own: cash flow, ROI, principal paydown, appreciation, percentiles, comparables, and a hosted report URL using your mortgage terms.
View in docsPOST /v1/external/analysis/create/cohost
Create Cohost Analysis
Create a co-hosting analysis for an owner lead or operator workflow. Return projected STR revenue, co-host commission, host return, and comparable listings.
Returns: Projected co-hosting revenue, your commission, net host return, percentiles, comparables, and a hosted report URL.
View in docsYour first call in three steps
Most developers make a successful request within minutes of generating a key.
- 1
Create a BNBCalc account and generate an API key in your dashboard settings.
- 2
Send your key in the x-bnbcalc-api-key header on every request.
- 3
POST a property's location and details to any analysis endpoint and read the JSON response, including the hosted report URL.
Example response
{
"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
}
}
}What you can build with it
From acquisition underwriting to PropTech platforms, the API removes the hardest parts of working with short-term rental data.
Underwriting & acquisition tools
Score deals by projected cash-on-cash return or cap rate the moment an address is entered.
PropTech & listing platforms
Show estimated Airbnb income on for-sale listings and property pages, at scale.
Property management dashboards
Benchmark owned units against local comparables and surface revenue upside to clients.
Funds, analysts & consultants
Pull ADR, occupancy, and revenue into acquisition models and market research without maintaining a scraper.
Internal reports & spreadsheets
Automate short-term rental revenue estimates into your own models, underwriting sheets, and reporting.
Co-hosting & STR operators
Quote realistic revenue and commission splits to owners before you take on a new listing.
Use BNBCalc from your AI assistant
Connect Claude, ChatGPT, Cursor or VS Code to the BNBCalc MCP server by signing in, and get revenue estimates, comps and deal analyses in the chat. It runs on the same usage-based API subscription as the REST API.
Custom connector URL
https://atlas.bnbcalc.com/mcpIn Claude, open Settings, then Customize, and add a custom connector with this URL. Sign in to BNBCalc when asked.
Custom connector URL
https://atlas.bnbcalc.com/mcpIn ChatGPT, open Settings, then Plugins, click Browse directory and add a custom MCP server with this URL and OAuth. Sign in to BNBCalc when asked.
Terminal
claude mcp add --transport http --scope user bnbcalc https://atlas.bnbcalc.com/mcpRun this in a terminal, then type /mcp in Claude Code, pick bnbcalc and choose Authenticate.
~/.cursor/mcp.json
{
"mcpServers": {
"bnbcalc": {
"url": "https://atlas.bnbcalc.com/mcp"
}
}
}Click Add to Cursor, or save this file. Then connect bnbcalc in Cursor's MCP settings and sign in to BNBCalc.
.vscode/mcp.json
{
"servers": {
"bnbcalc": {
"type": "http",
"url": "https://atlas.bnbcalc.com/mcp"
}
}
}Click Install in VS Code, or save this file. Then start the bnbcalc server and allow the BNBCalc sign-in when VS Code asks.
To check it works, ask “What's my BNBCalc MCP usage this month?” It's free. Setup guide
Data Trusted By
Frequently asked questions
Start building with the BNBCalc Airbnb Data API
Generate your API key, review the public docs, and add comparable-backed STR revenue analysis, full reports, and hosted report URLs to your product.