> For AI agents: BNBCalc's MCP server is at https://atlas.bnbcalc.com/mcp (setup: https://www.bnbcalc.com/developers/mcp). Index of every BNBCalc page: https://www.bnbcalc.com/llms.txt

# 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.

- 10M+ Listings analyzed
- 2,300+ Markets covered
- Up to 50 Comparables per analysis

- Base URL: `https://atlas.bnbcalc.com`
- API key header: `x-bnbcalc-api-key`
- Get your API key: https://www.bnbcalc.com/dashboard/settings/api-access
- View Documentation: https://www.bnbcalc.com/developers/rest-api/docs (Markdown: https://www.bnbcalc.com/developers/rest-api/docs.md)
- Updated: 2026-11-12

---

## 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.

- **Create Buy Analysis** `POST /v1/external/analysis/create/buy`: 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.
- **Create Arbitrage Analysis** `POST /v1/external/analysis/create/arb`: 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.
- **Create Owned Analysis** `POST /v1/external/analysis/create/owned`: 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.
- **Create Cohost Analysis** `POST /v1/external/analysis/create/cohost`: Create a co-hosting analysis for an owner lead or operator workflow. Return projected STR revenue, co-host commission, host return, and comparable listings.

---

## Your 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.

```bash
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
}'
```

---

## 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.

- Set up the MCP server: https://www.bnbcalc.com/developers/mcp
- BNBCalc MCP server: No monthly fee. Paid tools show their price and run only after you approve it. Calls that fail or return no data are free.

---

## Airbnb API documentation, pricing, use cases, and comparisons

Explore the public API pages that answer the common questions developers, investors, and PropTech teams ask before integrating STR data.

- [API Documentation](https://www.bnbcalc.com/developers/rest-api/docs): Endpoint reference with authentication, parameters, code examples, response examples, and error codes.
- [API Pricing](https://www.bnbcalc.com/developers/rest-api/pricing): See what the BNBCalc API costs: $0 a month, $0.20 per report and $0.10 per AI step that completes.
- [API Use Cases](https://www.bnbcalc.com/developers/rest-api/use-cases): See how PropTech platforms, investors, lenders, operators, and analysts use the API in production workflows.
- [Data Coverage](https://www.bnbcalc.com/developers/rest-api/data-coverage): Understand international property coverage, comparable-based estimates, location inputs, and where the API fits.
- [API Comparison](https://www.bnbcalc.com/developers/rest-api/comparison): See how the BNBCalc API compares with AirDNA's API and other Airbnb data APIs on access, pricing model and output.
- [Google Sheets](https://www.bnbcalc.com/developers/rest-api/google-sheets): Analyze a list of addresses in Google Sheets with one short Apps Script.
- [MCP server](https://www.bnbcalc.com/developers/mcp): Connect Claude, Cursor or VS Code to BNBCalc and run revenue estimates and deal analyses from your AI assistant.
- [MCP setup guide](https://www.bnbcalc.com/developers/mcp/setup): Connect Claude, ChatGPT, Claude Code, Cursor or VS Code to the MCP server, step by step.
- [MCP reference](https://www.bnbcalc.com/developers/mcp/docs): How the MCP server authenticates, every tool with its price, paid-tool approval and limits.
- [Changelog](https://www.bnbcalc.com/developers/changelog): What changed in the REST API and the MCP server, newest first.
- [Status](https://www.bnbcalc.com/developers/status): Live checks of the REST API and the MCP server.

---

## Frequently asked questions

### 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.

### 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, with no scraping, proxies, or model-building on your end.

### 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.

### 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.

### 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.

### 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.

### 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. Each AI step that completes, AI comps or AI expense estimates, adds $0.10. Failed validation requests and AI steps that fail or time out are not billed. Data lookups, such as revenue estimates, comparables and listing or property lookups, cost $0.10 and rent estimates $0.20 when they return data, while reads and calculators are free.

### How is BNBCalc different from AirDNA, Mashvisor, 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.

### 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.

### 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.

### Is the BNBCalc API a raw listing search API?

No. BNBCalc is an analysis API, not a broad raw listing search feed. It is best when your product starts with a property address or coordinates and needs revenue, occupancy, comps, and investment metrics returned as JSON.

### Can the API support rental arbitrage and co-hosting analysis?

Yes. The API includes separate endpoints for rental arbitrage and co-hosting analysis, so you can model monthly rent, co-host commission, projected revenue, and expected cash flow for those STR strategies.

### Can I use the BNBCalc API from Claude, Cursor or another AI assistant?

Yes. The BNBCalc MCP server connects Claude, ChatGPT, Claude Code, Cursor, VS Code and other MCP clients: they sign in with your BNBCalc account, or send your API key. It uses the same API subscription, and a paid tool shows its price and runs only after you approve it.
