Airbnb Data API for STR analysis

Airbnb Data API for STR revenue & property analysis

Q: Does Airbnb have an official API?

Airbnb has an official Partner API, but access is restricted to vetted property management systems, channel managers, and activity platforms, and it only handles operational workflows like listing sync, bookings, and messaging. It does not expose revenue estimates or occupancy analytics. For short-term rental data, developers use third-party APIs like the BNBCalc API.

Q: How do I get Airbnb revenue data without scraping?

Call the BNBCalc REST API. You send a property's address or coordinates plus basic details, and it returns projected ADR, occupancy, annual revenue, and cash flow as JSON — no scraping, proxies, or model-building on your end.

Q: What data does the BNBCalc API return?

Each successfully created report returns a comparable-based underwriting model: nightly rate (ADR), occupancy, monthly and annual revenue, operating expenses, cash flow, cap rate, cash-on-cash return, total ROI, percentile data, the active Airbnb comparable listings behind the numbers, and a hosted public BNBCalc report URL.

Q: Do I need an API key, and how do I get one?

Yes. Every request requires an API key sent in the x-bnbcalc-api-key header. Create a BNBCalc account and generate your key self-serve from the API access section of your dashboard settings. Keep the key server-side and do not expose it in frontend code.

Q: Which markets and countries does the API cover?

The API supports addresses in the U.S. and internationally. Because each estimate is built from active Airbnb listings around the address or coordinates you send, coverage reflects local sub-market data rather than a single national average.

Q: What is the difference between the buy, arbitrage, owned, and cohost endpoints?

Each maps to an investment strategy: buy underwrites a purchase, arb models rental arbitrage (renting then re-listing), owned analyzes a property you already hold using your mortgage terms, and cohost estimates co-hosting revenue and commission.

Q: How much does the BNBCalc Airbnb Data API cost?

BNBCalc API access has a $0/mo monthly subscription and charges $0.20 per successfully created report. Failed validation requests are not billed.

Q: How is BNBCalc different from AirDNA, Mashvisor, AirROI, and other Airbnb data APIs?

BNBCalc is focused on address-level property analysis. Instead of only returning a projection, market aggregates, or raw listing records, the API returns projected ADR, occupancy, revenue, percentiles, cash flow, ROI metrics, active Airbnb comparable listings, and a hosted public report URL for buy, arbitrage, owned, and co-hosting workflows.

Q: Can I use the API with Python, JavaScript, or no-code tools?

Yes. The API is a standard REST API that returns JSON, so any tool that can send HTTPS requests with headers can use it. The documentation includes cURL, JavaScript, and Python examples, and the request pattern works in tools like Postman or internal workflow builders.

Q: Does the API return comparable Airbnb listings?

Yes. BNBCalc estimates are built from active Airbnb listings around the submitted address. Responses include the comparable listings behind the estimate so your application can explain where the projected revenue and occupancy numbers came from.

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.

Get your API key View Documentation

Generate a key in your dashboard. HTTPS, JSON responses, active Airbnb comps, and hosted public report URLs.

Quick Example - Create Buy Analysis

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()

10M+
Listings analyzed: 3M+
Properties analyzed: 3,000+
Markets covered: Up to 50
Comparables per analysis: 4
Analysis endpoints: JSON
REST responses

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 — no scraping required.

Everything runs over one authenticated base URL: https://atlas.bnbcalc.com

Why BNBCalc

Built for developers, grounded in real comps

Skip the scraper and the modeling. Get defensible short-term rental estimates, full comps, percentiles, and a hosted report from a single REST call.

Comparable-based accuracy

Estimates are derived from up to 50 comparable active listings around each address — reflecting the real sub-market, not a national average.

Developer-friendly REST

Clean, predictable JSON endpoints, one-header authentication, and copy-paste examples in cURL, JavaScript, and Python. HTTPS everywhere.

One engine, four strategies

The same analysis engine that powers BNBCalc, exposed for buy, rental arbitrage, owned, and co-hosting underwriting.

Why BNBCalc

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, Mashvisor, and AirROI

AirDNA, Mashvisor, and AirROI 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

Cancel anytime from your dashboard

Endpoints

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 docs

POST

/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 docs

POST

/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 docs

POST

/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 docs

Your first call in three steps

Most developers make a successful request within minutes of generating a key.

Create a BNBCalc account and generate an API key in your dashboard settings.

Send your key in the x-bnbcalc-api-key header on every request.

POST a property's location and details to any analysis endpoint and read the JSON response, including the hosted report URL.

Get your API key

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()

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
      }
    ],
    "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,
    "yearOneAppreciationUSD": 12000,
    "totalCashInvestment": 100252,
    "ltrPerMonthUSD": 1500,
    "ltrMonthlyExpensesPercentage": 10
  }
}

Developer experience

Everything a developer needs to ship an Airbnb API integration

Use one authenticated REST API to generate STR analysis, rental arbitrage projections, owned-property returns, co-hosting estimates, full comps, and hosted public reports.