Short-term rental data as an API
Pull the same market reports, calendar-tracked occupancy, listings and revenue estimates that power JokerPrice into your scripts, spreadsheets, dashboards and AI assistants. 8 read-only JSON endpoints, one API key.
What you can query
Markets
Supply, asking-rate quartiles, bedroom price bands, property mix and ratings for every destination with at least 20 collected listings.
Performance
Occupancy, ADR, RevPAR, revenue per listing and on-the-books share from daily calendar checks, for a city or a map rectangle.
Trends
One stored snapshot per destination per day, returned as a time series for occupancy, ADR, RevPAR, asking rate or supply.
Listings
Collected Airbnb, Gathern and Agoda listings with location, bedrooms, type, asking rate, rating and link, page by page.
Revenue estimates
Projected nightly rate, occupancy and revenue for any coordinates, with the comparables behind it and optional investment returns.
AI assistants
The same data in Claude, Codex, Cursor and other MCP clients through the JokerPrice MCP server.
One request
Every endpoint is a plain HTTPS request with your key in the Authorization header.
curl -H "Authorization: Bearer $JOKERPRICE_API_KEY" \
"https://jokerprice.com/api/v1/markets/riyadh"{
"market": {
"slug": "riyadh",
"name": "Riyadh",
"listings": 9412,
"nightly": {
"median": 420,
"p25": 300,
"p75": 650
},
"tracker": {
"maturity": "estimating",
"occupancy": 0.47,
"adr": 512.4,
"monthlyRevenuePerListing": 7225
}
}
}Endpoints
| Endpoint | Returns |
|---|---|
| GET/api/v1/markets | List markets |
| GET/api/v1/markets/{slug} | Get a market report |
| GET/api/v1/metrics | Get performance metrics |
| GET/api/v1/trends | Get daily trends |
| GET/api/v1/pace | Get market pace |
| GET/api/v1/events | List events and holidays |
| GET/api/v1/listings | List listings |
| POST/api/v1/estimate | Estimate revenue |
Included in the free trial
Every new account gets the API in its 30-day free trial, no card needed: 120 requests per minute and 25,000 per UTC day for the account during the free trial, and up to 300 a minute and 100,000 a day on paid plans. API keys during the trial: 5. After the trial the API needs a plan, and requests return 402 PLAN_REQUIRED until you choose one. API pricing lists the plans.
Where to go next
- Getting started: create a key and make your first call.
- Tutorials: step-by-step guides for spreadsheets, Python and JavaScript.
- Data coverage: countries, cities, sources and fields, with live counts.
- Documentation: authentication, limits, errors and the full reference.