Overview
The Revenue Estimator API provides accurate revenue estimates for short-term rental properties.
By inputting the number of bedrooms, an address (or latitude and longitude), and the desired currency, the API returns the following metrics — Revenue, Average Daily Rate (ADR), and Occupancy for specified bedroom category.
Additionally, it provides breakdown by month and for different percentiles (25th, 50th, 75th and 90th percentile) for all three metrics.
Versions
The API is available in two versions with separate endpoints:
Rate limit
Each user accessing the API has a limit of 1000 requests per hour. Trial users will be able to make 20 requests.
Frequently Asked Questions (FAQs)
Q1. How is Annual Revenue Calculated?
Version 1 (Old Version)
Monthly data is calculated by aggregating data across all listings for each specific month. Similarly, yearly data is calculated by aggregating data across all listings for the entire year.
All metrics are generated separately for n, n-1, and n+1 bedroom categories, where n is the requested bedroom category.
Please note that this version will be deprecated soon. It is recommended to migrate to Version 2.
Version 2
We begin by calculating monthly revenue. For every month, we consider listings which are active for more than 75% of the times in the month, and are available to book for more than 50% of the times in the month (i.e. owner blocks < 50%). We then aggregate monthly data to calculate yearly metrics which leads to better estimates.
In a given month, for every listing, we know when they got booked, and what price they got booked at. We then calculate monthly revenue for these each of these listings. Once we have monthly revenue numbers for these listings, we calculate 25th, 50th, 75th, and 90th percentile revenue numbers.
These percentile numbers we get for every month of the year.
The annual revenue number is sum of 50th percentile number for every month.
The lower range of annual revenue number is sum of 25th percentile number for every month.
The upper range of annual revenue number is sum of 75th percentile number for every month.
Q2. Does the revenue calculation includes any cleaning fee, taxes etc.
No, the revenue calculation is based on nightly rates. This means that we don’t have any taxes, cleaning fee etc. except for the cases where host include their commission into nightly rates.
Q3. How fast is the API call?
It depends on how much data we pull in. Typically for 350 listings, it takes about 6-8 seconds to estimate revenue.
Q4. What is the max number of bedroom category we can pass as a parameter in the API?
There is no capping on the bedroom category. We try to pull all available nearby listings data for a given bedroom category.
Q5. Will there ever be no revenue data for an address?
It is only possible if the given address (& nearby area) doesn’t have any property listed on airbnb. In this case, we will send a zero response.
Questions? Reach out to [email protected].