Short Term Rental Data API - Airbnb Revenue, Occupancy

Find out what any short term rental market earns, what every listing in it actually books, and what a specific address would make as an Airbnb, from one actor.

What this actor does

• Revenue estimate for any address. Paste addresses, get projected revenue for the next twelve months with a lower and upper bound, projected occupancy and projected average daily rate. Turn on full detail for the month by month forward curve, the history, and every comparable rental behind the estimate.
• Listing level performance. Search the individual rentals inside a market, submarket, country or a radius around an address. Every row carries revenue and revenue potential over the last twelve months, occupancy rate, average daily rate, nights available, blocked and reserved, reservation count, cleaning fee, and the Airbnb, Vrbo and Booking.com identifiers.
• Market and submarket scores. Market score, average revenue, occupancy, average daily rate and RevPAR for the last twelve months, plus the market type and active listing count.
• Monthly market metrics. Seven series - occupancy, average revenue, average daily rate, RevPAR, booking lead time, average length of stay and active listing count - one row per month, with the month on month and year on year change and an optional percentile spread so you see the range across the market rather than only its average.
• Forward pricing. What listings in a market are priced at for dates that have not happened yet.
• Filter on 20+ real attributes. Guest capacity, bedrooms, bathrooms, occupancy, nights available, rating, review count, price tier, listing type, property type, booking channel, 16 amenities, superhost, instant book, professional management, and the provider's own investability, demand, revenue growth, seasonality and regulation scores.
• Pay per result. You are charged for rows that carry a real record. Addresses the provider cannot place are free.

Bring your own key

This actor calls the provider with your own API key. Paste it into the API key field, or set it as the DATA_API_KEY secret. Nothing runs on anyone else's credentials, and a run without a key ends cleanly with an explanation rather than failing.

The provider sells its data in four packages - market data, listings and comparables, address level estimates, and dynamic rate recommendations - and a key is entitled to the ones you bought. A key that is valid but not entitled to a package returns a 403, and this actor reports that as an entitlement problem rather than a bad key, so you are not left changing a key that was never wrong.

Start here

Every mode except market search and the address modes needs a market ID, and market search is how you get one. Run it first with a place name, read the regionId column, then feed that into market details, market metrics or a listings search.

Example output

{
  "recordType": "listing",
  "requested": "market airdna-163",
  "found": true,
  "propertyId": "airbnb-31977147",
  "title": "Sunny loft in LoHi with mountain views",
  "marketName": "Denver",
  "cityName": "Denver",
  "stateName": "Colorado",
  "zipCode": "80211",
  "latitude": 39.762,
  "longitude": -105.014,
  "exactLocation": false,
  "listingType": "entire_place",
  "propertyType": "loft",
  "bedrooms": 2,
  "bathrooms": 1,
  "accommodates": 4,
  "revenueLtm": 48120,
  "revenuePotentialLtm": 61340,
  "occupancyRateLtm": 0.72,
  "averageDailyRateLtm": 218.4,
  "daysAvailableLtm": 302,
  "daysReservedLtm": 218,
  "numReservationsLtm": 74,
  "rating": 4.91,
  "reviews": 186,
  "superhost": true,
  "professionallyManaged": false,
  "hostSize": "2-5",
  "currency": "usd"
}

FAQ

How do I estimate what an address would earn as a short term rental?

Use rental estimate mode and paste the address. The actor returns projected revenue for the next twelve months with a lower and upper bound, projected occupancy and projected average daily rate. Leave the subject bedrooms, bathrooms and guest capacity empty and the provider fills them in from its own records, which is what you want when working from a list of addresses. Turn on full detail to also get the month by month curve and the comparable rentals the estimate was built from.

What is the difference between revenue and revenue potential?

Revenue is what the listing actually earned over the last twelve months. Revenue potential is what it would have earned had it been available for booking every night of that year. A listing that was only open for three months shows a low revenue and a high potential, so comparing the two tells you whether a weak number means weak demand or simply a closed calendar.

Why is occupancy a decimal rather than a percentage?

The provider expresses occupancy as a share of availability between 0 and 1, so 0.72 means seventy two percent of the nights the listing was open were booked. The filters use the same scale, which is why the occupancy filter takes >=0.6 rather than >=60.

Are the listing coordinates exact?

Not always, and the row tells you which you have. The exactLocation flag is true when the latitude and longitude are the listing's real position and false when the provider has scrambled them within about 500 metres, which it does for listings whose exact address it will not publish. Treating a scrambled pin as exact is the usual mistake when mapping this data.

How do I compare two markets side by side?

Run market search on both names to get their IDs, then market details with both IDs in one run. That returns one row each with the market score, average revenue, occupancy, average daily rate and RevPAR on the same basis. For the trend rather than the level, run market metrics with both IDs and twelve months, which gives one row per month per series.

What do the percentiles add?

An average hides the spread. Asking for 0.25, 0.5 and 0.75 on the occupancy, revenue or daily rate series returns those percentiles alongside the mean, so you can see whether a market's average revenue comes from a broad middle or from a handful of high performers. Only those three series accept percentiles; the actor attaches them per series rather than to everything, because sending them to a series that does not take them is a rejected request.

Can I find every rental within a mile of a property?

Yes. Area comparables mode takes an address or a latitude and longitude plus a radius in metres, and returns the listings inside it with their full performance figures. Sort by proximity for a true comparables set, or by revenue to see the top performers nearby.

Which booking platforms does this cover?

Airbnb, Vrbo and Booking.com. Each listing row carries the identifier and URL it has on each platform, so a blank Vrbo ID means the listing is not advertised there. The booking channel filter narrows by platform, and the match setting controls whether you want listings on any of the chosen platforms, only on those, or on exactly those and no others.

Why are there only 25 rows per request?

That is the provider's ceiling on every paged endpoint, not a setting in this actor. It means a run over a whole market is many requests rather than a few, so if your plan is metered per request, set the maximum rows and requests per minute with that in mind. The actor pages automatically and stops at your row cap.

What does it cost?

Pricing is pay per result: 0.012 USD per listing, 0.008 USD per market or submarket record, 0.006 USD per month of market metrics or day of forward pricing, and 0.02 USD per revenue estimate, with Apify platform usage included. Rows the provider found nothing for are not charged. You also need your own account with the data provider, which bills on its own plans.

Does the actor fail if my key is wrong?

No. A missing key, a rejected key, a key not entitled to the package you asked for, an exhausted plan allowance or an empty input all end the run cleanly with a message saying what to change. Only a real outage or a bug fails the run.

Keyword map

short term rental data API, Airbnb data API, Airbnb revenue estimate, Vrbo data, STR market data, vacation rental analytics, Airbnb occupancy rate, average daily rate ADR, RevPAR short term rental, rentalizer, Airbnb comps, short term rental market research, vacation rental revenue projection, STR investment analysis, Airbnb listing scraper alternative, short term rental regulation score, booking lead time, seasonality score