list_brands | List all 550+ Chrono24 watch brands with numeric ids (optional name filter). Feed ids into search_listings' manufacturerIds or names into find_models. |
find_models | A brand's model catalog: model name, slug and numeric model id (e.g. Rolex -> Submariner mod1, Daytona mod2). Pair with search_listings' models + manufacturerIds for precise searches. |
list_filters | All search facet filters with allowed values (case material, bracelet material, gender, watch category, country, listing age). Use with search_listings' facets param. |
search_listings | Search with query + filters (brand id, model id, reference, price range, condition, year, seller countries, facets), sort (relevance, price_asc, price_desc, newest, popularity), paging (page, plus totalPages/hasMore in the response) and an optional limit (1-60) for shortlisting. Returns cards with id, url, title, price, location, seller type, thumbnail. |
get_price_stats | Price statistics: min, p10/p25/median/p75/p90, max and sample size. Default: one request over the 60 cheapest (lower-tail biased); sample: "spread" interpolates full-range percentiles from first/middle/last price-sorted pages (up to 3 requests). coverage reports which mode applied. |
get_watch | Full detail for one listing id: reference, condition, year, movement/caliber/power reserve, case material/diameter, scope of delivery, location, description, all photo URLs, canonical URL, seller ids. Sold/removed listings return a clear not-found error instead of empty fields. |
get_watches | Batch detail for up to 10 ids. Sequential and polite (~4s per uncached id); per-id failures don't break the batch. |
get_dealer_listings | A dealer's current inventory by customerId (from get_watch's sellerIds). Same card shape as search_listings. |
get_dealer_ratings | A dealer's customer reviews by dealerId (from get_watch's sellerIds - a different id!). Per-review rating, text, dealer reply, paging totals (total/filteredTotal); filter with stars (1-5). |
get_dealer_rating_summary | Star histogram + weighted average rating for a dealer (e.g. 4.83 from 10,128 reviews), reconstructed from per-star counts. 5 lightweight requests (~8s uncached, cached 30 min) - the fast way to vet a dealer. get_dealer_rating_summaries batches up to 5 dealers in one call. |
find_deals | The one-call answer to "find me a good deal on X": full-range price stats, then listings at or below market p25 with pctBelowMedian and caution flags. benchmark: "global" ranks country-filtered listings against the worldwide market; sample: "cheapest" is the 1-request fast mode. |
search_all | Aggregate up to 5 result pages (300 listings) into one deduplicated list, with progress notifications. For exhaustive scans. |
value_collection | Appraise up to 10 watches in one call: per-item market stats plus portfolio totals (sum of medians/p25/p75). |
save_search / check_saved_searches | Save a named search scope (persisted to disk), then later report only listings that appeared since the last check - built for scheduled agents ("tell me when a Speedmaster under $4k shows up"). Manage with list_saved_searches / delete_saved_search. |
server_status | Diagnostics without network requests: browser state, request queue depth, cache/disk freshness, politeness settings. |
get_model_guide | Chrono24's editorial buying guide for a model: history, cost guidance, investment notes and the per-reference approximate price table (e.g. Submariner 6538 "James Bond" ~148,000 USD). One request, cached 24h. |
get_watch_photos | A listing's photos as inline images (Large ~28KB each) so vision-capable clients can inspect condition and authenticity cues. |
watch_listing / check_watched_listings | Track specific listings for price drops and sold/removed status (persisted; unwatch_listing to stop). The listing-level counterpart to saved searches. |
health_check | Live canary (2 requests) asserting the parsing invariants: cards parse, counts present, details complete. Run when markup drift is suspected. |
