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?
This can only happen if there are no short-term rental properties listed on Airbnb in the given address or its nearby area. In such cases, the API will return a response with zero values.
Q6. How does billing work for the Revenue Estimator API?
Billing is on a monthly cycle. Unused API requests do not roll over to the next billing period — they expire at the end of each month.
Pricing Plans
Q7. Can I get a custom annual plan?
Yes. If your usage is seasonal or follows a non-standard pattern, we can create a custom annual plan tailored to your needs. Please reach out to [email protected] to discuss further.
Q8. How is a request counted for billing?
A request is billed as soon as it hits the API, regardless of whether data is returned — for example, if there are not enough comparable listings for a 20-bedroom property in the given locality, the request is still counted.
Q9. How many nearby listings are considered for revenue estimation?
The API considers approximately 350 nearby listings with the same bedroom count (or ±1 bedroom category) to generate estimates.
Q10. Can I add more filters or get PDF reports from the Revenue Estimator API?
No. The Revenue Estimator API does not support additional filters or PDF report generation. These features are available through Revenue Estimator Pro, which is a separate product offered by PriceLabs.
Q11. How can I track my rate limit usage?
Every API response includes rate limit metadata in the response headers, so you can monitor your usage in real time:
Questions? Reach out to [email protected].