Airbnb and Vrbo Market Data API - Occupancy, ADR, RevPAR

Turn a list of vacation rental markets or listings into a dataset of occupancy, ADR, RevPAR, revenue, nightly rates and competing listings, straight from a short-term rental market data API with your own key.

What it collects

• Market KPIs, weekly or monthly: listing count, ADR, ADR on unbooked nights, RevPAR and adjusted RevPAR, guest and calendar occupancy, rental revenue, average stay length, average booking window, guest check-ins and check-outs, and property, available, open, guest and hold nights. Airbnb and Vrbo combined, or one platform at a time.
• Listings in a market: every Airbnb and Vrbo listing the provider tracks in a market, with title, URL, property type, bedrooms, beds, bathrooms, max guests, minimum stay, location, amenities, reviews, professional management flags, and trailing 12 month revenue, occupancy, ADR and RevPAR with percentile ranks, plus a 6 month forward forecast. Filter by platform, property type, bedroom, bed, bathroom and review ranges, amenities, Superhost status, professional management, property manager domain and performance or ADR tier.
• One listing: the full profile of a single Airbnb or Vrbo listing, including cross-platform matching and the markets it belongs to.
• Listing KPIs, weekly or monthly: the same KPI set as the market series, for one listing.
• Listing availability and nightly rates: one row per night with availability, quoted nightly rate, rate type, check-in availability, guest night, check-in and check-out flags, hold nights and the booking timestamp.
• Benchmarking by arrival date: market performance grouped by guest arrival, including owner nights, cancellations and non-rental revenue, bucketed by day, week, month, quarter or year, optionally split by bedrooms, sleeps, property type, booking source, length of stay or booking window, with a point-in-time as-of snapshot and a rollup row.
• Available markets: the UUID, name and level of every market your account covers, which is where every market query starts.

Input

• What to read: one service per run.
• Market UUIDs or Listing ids or URLs: one per line. Listing ids look like airbnb_17024610 or vrbo_3700771; an Airbnb /rooms/ URL or a Vrbo listing URL is converted for you.
• Start date and End date: the range for KPI, availability and benchmarking services. Left blank, the last twelve months.
• Currency: any ISO code; the provider converts every money value.
• Platform and the listing filters: apply to market KPIs and market listings as described on each field.
• Maximum results: the cap that bounds the cost of a run.
• API key: your own key, or the DATA_API_KEY environment secret.

Example output

{
  "service": "marketKpisWeekly",
  "serviceLabel": "Market KPIs - weekly",
  "endpoint": "/api/v1/ota/market/kpis/week",
  "requested": "745b0198-3202-4679-83a1-faf3ccd8406c",
  "found": true,
  "recordType": "kpi",
  "listingId": null,
  "marketId": "745b0198-3202-4679-83a1-faf3ccd8406c",
  "date": "2024-01-01",
  "retrievedAt": "2026-09-25T09:14:52.118Z",
  "record": {
    "market_uuid": "745b0198-3202-4679-83a1-faf3ccd8406c",
    "market_name": "30A",
    "market_type": "Vacation Area",
    "ota_source": "airbnb",
    "time_scale": "weekly",
    "date": "2024-01-01",
    "listing_count": 5507,
    "adr": 324.32,
    "adr_unbooked": 322.9,
    "revpar": 55.19,
    "revpar_adj": 68.14,
    "avg_stay_length": 9.73,
    "...": "every other field the provider returned, unchanged"
  },
  "note": null
}

FAQ

What is a short-term rental market data API used for?

Sizing and pricing vacation rentals with real numbers. An investor compares monthly occupancy, ADR and RevPAR across beach, mountain and lake markets before buying. A property manager benchmarks a portfolio against the top Airbnb and Vrbo earners in the same market and bedroom count. A revenue manager feeds nightly competitor rates and availability into a pricing model. A lender or municipality tracks listing supply and professional management share over time.

Do I need an API key?

Yes. This actor is bring-your-own-key: it calls the short-term rental market data provider's API with your own subscription key and never ships a key of its own. Paste the key into the API key field, or set it once as the DATA_API_KEY environment secret. It travels as the x-api-key header. Your provider plan decides which markets you can read; a market or listing outside it comes back as a row marked found: false with the provider's reason, and is not charged.

How do I find a market UUID?

Run the Available markets service. It lists every market your account covers with its UUID, name and level. Paste the UUIDs you want into the market field of any market service.

What is the difference between guest occupancy and calendar occupancy?

Guest occupancy is guest nights divided by available nights: how full the bookable calendar was. Calendar occupancy is the share of all nights that were unavailable, including owner holds and blocks. A market with heavy owner use can show high calendar occupancy and modest guest occupancy.

Does it return host names or guest details?

No. The host's personal display name is removed from every listing record, because many hosts are private individuals and the name adds nothing a market analysis needs; the professionally managed flag, property manager company and domain, and host id are kept. The provider's property manager routes that read a subscriber's own guest reservations are not wired at all.

Can this actor change anything on my account?

No. Every route it reaches reads data. The listing and KPI searches are sent as POST bodies because that is how the provider takes search criteria, not because they write anything.

Why is a market or listing row marked found false?

The provider answered that request without data: the market or listing is outside your plan's coverage, the id is unknown, the date range could not be processed, or the filters matched nothing. The row's note carries the provider's own wording. These rows are never charged, so a run over fifty markets returns fifty answers rather than leaving you to work out which were empty.

What does it cost?

Pay per result. A full listing profile costs the most, a weekly or monthly KPI period costs less, and a single calendar night or a market reference row costs the least, since a year of one listing's calendar is 365 rows. Rows that carry no record are free.

Keyword map

Airbnb data API, Vrbo data API, short-term rental data API, vacation rental market data, STR market analytics, Airbnb occupancy rate data, ADR data by market, RevPAR data, vacation rental revenue data, Airbnb comps API, short-term rental comparables, vacation rental benchmarking, STR pricing data, nightly rate data, Airbnb calendar availability data, vacation rental investment analysis, short-term rental market research, professional property manager benchmarking.