API tutorials
13 step-by-step guides with code you can run against the JokerPrice API today.
Beginner
Quickstart: markets, metrics and an estimate
Make your first calls in Python or JavaScript and chain the core endpoints together.
Explore the API in Postman
Import a ready-made collection, keep your key in an environment, and page through listings without code.
Market data in Google Sheets
An Apps Script that fills a Markets sheet and a Listings sheet from the API, with a menu and a daily refresh.
Market data in Excel with Power Query
Load markets and weekday performance into Excel tables that refresh with one click.
Rank cities by occupancy
Rank tracked destinations by occupancy and revenue, then split weekend from weekday nights.
Intermediate
Estimate revenue for a property
Read every part of the estimate response, compare bedroom counts and test how the radius changes the answer.
Competitive set analysis
Build a competitive set around your listing from all collected listings and see where your rate sits.
Seasonality and weekday patterns
Use weekday, monthly and daily trend data to see when a market fills up and what it charges.
Compare markets side by side
Build a comparison table across cities in the Gulf and Egypt and save it as CSV.
Advanced filtering and paging
Know which filters the API applies and which you apply, page efficiently and cache to save requests.
Advanced
Neighbourhood grid with map rectangles
Split a city into grid cells, query each with a bounding box and export GeoJSON for a map.
Build a nightly rate plan from market data
Turn comparables, weekday ADR and booking lead times into a 30-night rate plan you can review.
Investment dashboard for a shortlist
Run estimates with financing inputs for several properties and produce a CSV and a one-page HTML dashboard.