smart_rates
Fetch Smart Rates for an Airbnb Listing.
Given a Listing ID, this endpoint provides up to 12 months of recommended daily rates based on the requested pricing strategy.
- Supports Currency Conversion for non-USD currencies.
- By default, all currency data is in USD.
- Airbnb only. Requests with vrbo_* or bkng_* Listing IDs are rejected with the envelope "Smart Rates does not yet model Booking.com / Vrbo listings.".
post/listing/{listingId}/smart_rates
Path parameters
listingIdstring required
AirDNA ID for the Listing. This can often be found as property_id. The ID is prefixed with the channel the Listing belongs to:
- abnb_ for Airbnb
- vrbo_ for Vrbo
- bkng_ for Booking.com
Smart Rates endpoints currently only model Airbnb Listings; requests with vrbo_* or bkng_* IDs are rejected with a "Smart Rates does not yet model Booking.com / Vrbo listings." envelope.
Example:abnb_XXXXXXXX
Request body
Example request
{
"base_rate": 120,
"min_rate": 110,
"max_rate": 150,
"num_months": 6,
"currency": "usd",
"orphan_1_day_modifier": -0.3,
"orphan_2_day_modifier": -0.2
}Response
Successful Smart Rates Response
Example response
{
"payload": {
"rates": [
{
"date": "2024-01-01",
"rate": 120,
"attribution": {
"demand_score": 0.01623246757374205,
"holiday_or_event": 0.03669,
"lead_time": 0.318518519,
"seasonality": 0.04943,
"day_of_week": -0.0461
}
}
]
},
"status": {
"type": "success",
"response_id": "API-S-XXX",
"message": "A successful request was made."
}
}