API

/

Getting Started

Getting started

Get an Airbnb API key and make your first BNBCalc request

Generate an API key from your dashboard, send it in the x-bnbcalc-api-key header from your server, and post a property location to receive STR analysis JSON and a hosted report URL.

Get your API keyView Documentation
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.

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

First request checklist

You only need a BNBCalc account, an API key, and a property location to make your first request. The fastest path is to copy the cURL example, replace the key, and send a buy analysis request with a test property.

Create or sign in to your BNBCalc account

Generate an API key in dashboard settings

Send the key server-side in the x-bnbcalc-api-key request header

What to validate before production

Before launching, validate location input quality, error handling, and response storage. Your app should handle missing or invalid location fields, status codes, and the possibility that a property has limited nearby comparable data.

If you are enriching property pages or running batch analysis, store the hosted BNBCalc analysis URL and key output fields so your team can audit results later.

Airbnb API documentation, pricing, use cases, and comparisons

API Documentation

Endpoint reference with authentication, parameters, code examples, response examples, and error codes.

API Pricing

Learn how BNBCalc API access works with $0 monthly subscription pricing and pay-per-successful-created-report billing.

API Use Cases

See how PropTech platforms, investors, lenders, operators, and analysts use the API in production workflows.

API Endpoints

Compare the four analysis endpoints for buy, rental arbitrage, owned, and co-hosting strategies.

Data Coverage

Understand international property coverage, comparable-based estimates, location inputs, and where the API fits.

API Comparison

Compare BNBCalc with Airbnb's official Partner API, AirDNA, Mashvisor, AirROI, and scraper-based approaches.

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.

Get your API keyView Documentation