Get time-series market metrics.
GET/market_report/:market_id/time_series
Returns daily time-series data for one or more market-level metrics over a date range. RM API users can only access markets in which they have at least one Pro tier listing.
Available metrics: asking_rate_w_fees, occupancy, occupancy_adjusted, adr_w_fees, lead_time, revpar_adjusted_w_fees, revpar_w_fees, revenue_w_fees, nights_bookable.
Same time last year. Pass basis=stly to get each stay date's values as they stood around the same time last year: the market's figures for the stay date 52 weeks earlier, returned under this year's stay_date with the same fields, so the rows of both bases can be joined on stay_date. updated_at is then when last year's figures were generated. A value is null where last year has no data for that stay date, and a bedroom group last year's market was not broken down by returns 204. Last year's figures are refreshed weekly, so the last few days of the one-year horizon can be missing from the response, and a range that lies entirely within them returns 204. basis=stly is in early access: accounts without early access get a 403, and a market whose last year figures are not available yet returns a 404.
Request
Responses
- 200
- 204
- 400
- 401
- 403
- 404
- 429
Time-series market data.
Not enough data for the requested parameters.
Invalid parameter value (e.g. invalid date range, or a bedrooms group this market is not broken down by).
API key authorization failed.
basis=stly was requested by an account without early access to it.
Market not found or not accessible, or, with basis=stly, last year's figures for this market are not available yet.
Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the Rate Limits section in the overview for the recommended exponential backoff strategy.