22 API endpoints
Pay-as-you-go
Public documentation
Real API requests and JSON responses for the most common Airbnb analytics workflows — market screening, seasonal occupancy analysis, and property revenue estimation across 190+ countries.
Before buying or building in a market, you need to know what's actually earning — not the median, but the top of the range. This endpoint returns filterable, sortable listings with trailing-twelve-month (TTM) revenue, occupancy, and ADR. The 847-result total for Maui whole-homes above $40K shows deep coverage. Sort by ttm_revenue descending to immediately see the ceiling of what a property can earn.
POST /listings/search/marketHost: api.airroi.comx-api-key: YOUR_KEYContent-Type: application/json{ "country_code": "us", "state": "hawaii", "city": "maui", "filter": { "room_type": { "eq": "entire_home" }, "bedrooms": { "gte": 2 }, "ttm_revenue": { "gte": 40000 } }, "sort": { "ttm_revenue": "desc" }, "page_size": 3}
{ "total": 847, "page": 1, "listings": [ { "listing_id": "52847391", "name": "Oceanfront Villa · Ka'anapali", "bedrooms": 3, "bathrooms": 2, "rating": 4.97, "ttm_revenue": 98400, "ttm_occupancy": 0.832, "ttm_adr": 647 }, { "listing_id": "38291047", "name": "Luxury Condo · Wailea Resort", "bedrooms": 2, "bathrooms": 2, "rating": 4.94, "ttm_revenue": 82700, "ttm_occupancy": 0.784, "ttm_adr": 595 } // ... 1 more result ]}
Seasonal swings can make or break STR cash flow models. Gatlinburg's July occupancy (81.3%) is 56% higher than January (52.1%) — knowing this before acquiring changes minimum-stay rules, pricing strategy, and debt-service calculations. This endpoint returns up to 60 months of monthly occupancy data per market, covering 190+ countries.
POST /markets/metrics/occupancyHost: api.airroi.comx-api-key: YOUR_KEYContent-Type: application/json{ "country_code": "us", "state": "tennessee", "city": "gatlinburg", "months": 12}
{ "market": "Gatlinburg, Tennessee", "active_listings": 4040, "avg_occupancy": 0.705, "peak_month": "2025-07", "low_month": "2026-01", "data": [ { "month": "2025-03", "occupancy": 0.784 }, { "month": "2025-07", "occupancy": 0.813 }, { "month": "2025-10", "occupancy": 0.779 }, { "month": "2026-01", "occupancy": 0.521 } // ... 8 more months ]}
Most revenue estimators are black boxes — you get a number with no explanation. AirROI's estimate endpoint returns the comparable listings used in the projection, so you can verify the data driving each forecast. The Joshua Tree desert cabin below projects $52,800/year with 24 comparables and "high" confidence. April ($6,100) peaks nearly 2× January ($3,100) — a clear signal to require 3-night minimums in spring.
GET /calculator/estimate ?latitude=34.1341 &longitude=-116.3115 &bedrooms=2 &bathrooms=1 &accommodates=4 ¤cy=usdHost: api.airroi.comx-api-key: YOUR_KEY
{ "location": "Joshua Tree, CA 92252", "annual_revenue": 52800, "occupancy": 0.683, "adr": 211, "revpar": 144, "comparables": 24, "confidence": "high", "peak_month": "April", "low_month": "January", "monthly_revenue": { "jan": 3100, "apr": 6100, "oct": 5800, "dec": 4900 // ... 8 more months }}
For a detailed comparison of all providers, see our best Airbnb API providers analysis.
Explore the APIDon't want to write code? Connect your AI to AirROI's MCP Server and query the same 22 endpoints using natural language. AirROI is the only Airbnb data provider with MCP integration — no competitor offers AI-native data access.
AirROI's MCP Server uses Anthropic's Model Context Protocol to let AI assistants like Claude, Cursor, and Gemini CLI access STR data through 20 tools. Ask questions in plain English and get structured analytics back instantly.
Both the REST API and MCP Server share the same pay-as-you-go credits — one API key works for both.
Learn more about the MCP Server> What's the average occupancy in Miami Beach for 2BR listings? Called market_occupancy("Miami Beach") Average Occupancy: 46.2% Peak (Dec-Mar): 57.4% Low (Aug-Oct): 39.8% Active Listings: 4,847
Airbnb's official API is restricted to approved property management software. There is no public developer API or self-service signup for market data access. This creates massive unmet demand from developers building PropTech tools, investment platforms, and data products.
Developers who need Airbnb data programmatically face three options: enterprise APIs like AirDNA that require custom contracts, raw scraping services like Bright Data at $2.50 per 1,000 records with no analytics, or AirROI — the only pay-as-you-go option with public documentation and analytics-enriched responses.
Scraping publicly visible data is generally legal under US law (hiQ v. LinkedIn, Meta v. Bright Data), but violates Airbnb's Terms of Service and is technically fragile. Third-party APIs like AirROI provide a compliant, reliable alternative. For a detailed analysis, see our guide on the legality of scraping Airbnb data.
Until recently, programmatic access to Airbnb market data meant either signing an enterprise contract (AirDNA has no public signup) or building brittle web scrapers that violate Airbnb's ToS and break without warning. AirROI's 22-endpoint API is a third option: activate instantly, ship on day one.
Enterprise contracts only. No public API, no self-service signup. You're on a sales call before you write a line of code.
You get scraped HTML at $2.50/1K records — no analytics, no occupancy, no revenue. You build the entire pipeline yourself.
Market analytics, revenue estimates, occupancy timeseries — enriched JSON responses. No contract, no minimum commitment.
No. Airbnb’s official API is restricted to approved channel management partners — property management software that syncs calendars and manages reservations. There is no public developer API or self-service signup for market data access. For programmatic access to Airbnb listing data, market analytics, and revenue estimates, third-party APIs like AirROI provide the solution with 22 endpoints and true pay-as-you-go pricing.
Pricing varies dramatically. AirROI offers pay-as-you-go pricing with no contracts or monthly minimums. AirDNA requires enterprise contracts. Bright Data charges $2.50 per 1,000 records for raw data without analytics. Mashvisor and Rabbu have no API at all. AirROI is the only provider with true pay-as-you-go pricing and public documentation.
Scraping publicly visible data is generally legal under US law following the hiQ v. LinkedIn and Meta v. Bright Data precedents. However, it violates Airbnb’s Terms of Service and can result in IP blocking or legal action. The more practical concern is that building a reliable scraping pipeline is costly, fragile, and time-consuming. Third-party data APIs like AirROI provide a compliant alternative with structured, enriched data and no engineering overhead.
22 endpoints covering market search, listing details, revenue estimates, geospatial queries (radius and polygon), historical metrics (up to 60 months), future rates (365 days), and market analytics including occupancy, ADR, RevPAR, revenue, supply growth, booking pacing, length of stay, and seasonality. Full documentation with code examples in JavaScript, Python, and cURL is available at airroi.com/api.
Airbnb’s restricted API is for channel management — syncing calendars, managing reservations, and handling guest communications. It does not provide market analytics or competitive intelligence. Data APIs like AirROI are built for analytics: occupancy rates, revenue estimates, market trends, pricing data, and competitive benchmarking across 20M+ listings in 190+ countries.
MCP (Model Context Protocol) is an open standard created by Anthropic that lets AI assistants access external data sources. AirROI’s MCP Server exposes the same data as the REST API through 20 tools that AI clients like Claude, Cursor, and Gemini CLI can query in plain English. It’s API access without writing code — ask “What’s the average occupancy in Miami Beach?” and get structured analytics back instantly. AirROI is the only Airbnb data provider with MCP integration.
Explore more Airbnb data topics — from analytics tool comparisons to revenue benchmarks and city-level reports.
Stay ahead of the curve
Join our newsletter for exclusive insights and updates. No spam ever.