Back

Meet the BNBCalc API: Revenue and Cash Flow In Your Builds

The BNBCalc API is live. Send an address, get back revenue, occupancy, cash flow, comps and a hosted report. No subscription, just $0.20 per successful call.

Jeremy Werden

Written by

Jeremy Werden

The BNBCalc API landing page showing a cURL example that posts an address, 3 bedrooms, 2 bathrooms and a $400,000 purchase price to the create/buy endpoint

Quick answer

The BNBCalc API is a REST API that turns any property address into a full short-term rental underwrite: projected revenue, occupancy, ADR, cash flow, cap rate, comparable Airbnb listings and a hosted report. It costs $0.20 per call, with no BNBCalc subscription required.

Free instant analysis

Reveal Airbnb revenue for any address or city

2,400

Markets

10M+

Airbnb listings

1B+

Addresses

The BNBCalc API is live. If you've ever wanted the numbers behind our calculator sitting inside your own product, spreadsheet or automation, this is how you get them.

Here's the whole thing in one breath: you send a property address, and the API tells you what it'd earn on Airbnb. You get the full picture too, projected nightly rate, occupancy, annual revenue, expenses, cash flow, cap rate, the comparable listings behind the numbers, and a link to a live BNBCalc report you can view online. It runs $0.20 a call, with no monthly fee to sit through first.

What Is the BNBCalc API?

So what sits behind that call? BNBCalc is a short-term rental analysis platform that around thousands of investors, property managers, cohosts and realtors use to underwrite deals. The API is that same engine, exposed over REST so your software can call it directly.

You give it an address plus a few basics like bedrooms and bathrooms, it runs the same comparable-based analysis the calculator does, and it hands the whole thing back as clean JSON. It'll work on addresses across the US and internationally, and every estimate is built from active Airbnb listings around the exact spot you send, so you're getting the real sub-market and not the citywide average.

What the BNBCalc API Gives You

So what's in that JSON? A complete underwrite, every time. Here's what comes back.

  • The core numbers. Projected ADR, occupancy, monthly and annual revenue, operating expenses, and cash flow for the property.
  • The investment metrics. Cap rate, cash-on-cash return, and total first-year ROI, calculated off your purchase price and financing terms.
  • Percentile ranges. Revenue, ADR and occupancy each come back at the 25th, 50th, 75th and 90th percentile, so you're seeing the full spread and not betting on one number.
  • The comparable listings. Up to 50 active Airbnb properties near the address, each with its own revenue, occupancy, nightly rate and distance, so the estimate always shows its work.
  • A hosted report. A rendered, shareable BNBCalc analysis that anyone can open with no login and no key, and it can carry your own branding as well.

And it isn't only for purchases. Four endpoints cover four deal types, and since they all take the same input and hand back the same shape, you learn one and you've learned all four.

EndpointAnswers
create/buyShould I buy this property?
create/arbShould I lease it and re-list it?
create/ownedHow's the one I already own doing?
create/cohostWhat's my cut as a co-host?

The four BNBCalc API endpoints documented on one page, create/buy and create/arb shown with their POST paths and the metrics each returns

How Much the BNBCalc API Costs

Four endpoints, and one price covering all of them. The BNBCalc API requires no BNBCalc subscription and costs $0.20 per successful call, as of July 2026, with no tiers, no credit packs and no minimum.

The nice part is you only pay for calls that work. A bad request, a wrong key, a rate-limit trip, they all come back as errors and cost you nothing, so you're free to build and test against the live API without running up a bill.

And you don't need a paid BNBCalc plan to use it, since the API stands on its own. If you're curious how the consumer plans line up next to it, though, here they are:

PlanMonthlyAnnual
API Access$0.20 per successful callNo monthly fee
Calculator$29.99/mo$199/yr
Markets$79/mo$399/yr

How to Use the BNBCalc API

Pricing out of the way, here's how you get going. It's two steps to set up, then two to make your first call.

  1. Create a free BNBCalc account, then open the API section of your dashboard settings and start API Access. It's a separate step from signing up, and it's the one people miss, so if you don't see a key yet, that's why. You'll enter card details here even if one's already on file.
  2. Generate your key on that same screen, and keep it server-side, since every successful call bills your account.
  3. Send a request. POST an address to the endpoint you want, with your key in the x-bnbcalc-api-key header:
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
  }'
  1. Read what comes back. The response carries the JSON with all your numbers plus that hosted report link, ready to wire into your product, drop in a spreadsheet, or fire from an automation. One heads-up: accomodates is spelled with a single "m" in the request, so type it exactly as shown.

A BNBCalc API buy response in the docs, showing the returned JSON with revenue, ADR and occupancy broken out at the 25th, 50th, 75th and 90th percentile

The full reference, with parameter tables and examples in cURL, JavaScript and Python, lives in the API docs.

Frequently Asked Questions

Does Airbnb Have an Official API for Revenue Data?

Airbnb runs an official Partner API, but access is limited to vetted property management systems and channel managers, and it only handles operational workflows like listing sync and messaging. It doesn't expose revenue or occupancy estimates. The BNBCalc API is a third-party Airbnb data API built for exactly that gap, returning projected revenue, occupancy and comparable listings for any address, with no partner approval to wait on.

What Markets Does the BNBCalc API Cover?

The API works on property addresses across the United States and internationally. Because each estimate is built from active Airbnb listings around the coordinates you send, coverage reflects the local sub-market around that specific address, as of July 2026, rather than a single national or citywide average.

Is There a Sandbox to Test the BNBCalc API?

No, there's no separate sandbox or test key as of July 2026. In practice it matters little, since failed requests return 4xx errors and are never billed, so you can iterate on your auth and request shape for free. Your first successful call is the first one you pay for, at $0.20.

Try the BNBCalc API

Whether you're building an acquisition tool, a listing site, a management dashboard or a research model, this is the quickest way to get real underwriting into it without standing up your own.

So grab a key and run your first address for twenty cents. Start on BNBCalc's Airbnb data API page, or open the calculator first if you'd rather see the analysis in your browser before writing a line of code.

Free Tool

Airbnb Tax Deduction Calculator

Paying too much in taxes? We have the perfect solution. Simulate an Airbnb home purchase below.

Purchase Price

$450K

Structure Value

70%

Apply Trump's Tax Cut (Bonus Depreciation)

Depreciation

$117,695

Interest

$21,600

Tax

$6,750

Year 1 Deduction

$146,045

Want to claim this deduction? Get a free cost segregation benefit analysis from CSA Partners — no obligation.

Get Full Analysis
Explore BNBCalc Markets with heatmaps, listings, comp sets, and 3,000+ markets.