/chrono24/watches/search

POST /api/chrono24/watches/search

Price: 20 credits

Search Chrono24 watch listings by keyword and a rich set of filters (brand, model, price, year, condition, materials, dial, movement, functions, location, seller and more). Returns id, name, subtitle, price/currency, location, image and badges.

How to use it

Search Chrono24 luxury watch listings. Optional free-text keyword plus filters: price_from/price_to, year_from/year_to, diameter/thickness/lug_width ranges, brand_ids/model_ids/collection_ids/reference_ids (numeric catalog IDs; resolve brands via chrono24/brands), merchant_id (single dealer's inventory), country_ids (ISO location codes), and named facets: condition, new_used, case_material, bezel_material, band_material, band_color, clasp_material, clasp, dial_color, dial_style, crystal, movement, functions, watch_style, other_attributes, gender, watch_category, watch_types, water_resistance, delivery_contents, availability, seller_type, certified. Use domain for the regional market and currency for a price-currency override.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• domain string — Marketplace domain (controls language, currency and regional market). (default: "chrono24.com"; one of: "chrono24.com", "chrono24.co.uk", "chrono24.com.au", "chrono24.ca", "chrono24.in", "chrono24.co.id", "chrono24.my", "chrono24.co.nz", "chrono24.ph", "chrono24.sg", "chrono24.co.za", "chrono24.fi", "chrono24.co.th", "chrono24.ae", "chrono24.de", "chrono24.fr", "chrono24.it", "chrono24.es", "chrono24.nl", "chrono24.at", "chrono24.ch", "chrono24.se", "chrono24.pl", "chrono24.com.br", "chrono24.hk", "chrono24.jp", "chrono24.cn")
• keyword string nullable — Free-text search (brand, model, reference) (examples: "daytona", "116610LN")
• count integer required — Max number of results to return (min: 1)
• currency string nullable — Price currency override (defaults to the domain's currency) (one of: "USD", "EUR", "GBP", "CHF", "AUD", "CAD", "JPY", "HKD", "SGD", "CNY", "INR", "AED", "SEK", "PLN", "BRL", "ZAR", "NZD", "THB", "MYR", "IDR", "PHP")
• sort string nullable — Result ordering. Default: relevance (one of: "relevance", "price_asc", "price_desc", "newest", "popularity")
• price_from number nullable — Minimum price (in the selected currency) (min: 0)
• price_to number nullable — Maximum price (in the selected currency) (min: 0)
• year_from integer nullable — Earliest year of production (min: 1500; max: 2100)
• year_to integer nullable — Latest year of production (min: 1500; max: 2100)
• diameter_from integer nullable — Minimum case diameter in mm (min: 1; max: 200)
• diameter_to integer nullable — Maximum case diameter in mm (min: 1; max: 200)
• thickness_from integer nullable — Minimum case thickness in mm (min: 1; max: 100)
• thickness_to integer nullable — Maximum case thickness in mm (min: 1; max: 100)
• lug_width_from integer nullable — Minimum lug width in mm (min: 1; max: 100)
• lug_width_to integer nullable — Maximum lug width in mm (min: 1; max: 100)
• brand_ids array nullable — Brand (manufacturer) IDs; see chrono24/brands
• model_ids array nullable — Model (catalog) IDs
• collection_ids array nullable — Collection (catalog) IDs
• reference_ids array nullable — Reference-number catalog IDs
• merchant_id integer nullable — Dealer ID: only this dealer's listings
• country_ids array nullable — Listing location ISO country codes (examples: ["US","DE"])
• condition array nullable — Condition (one of: "new", "like_new_and_unworn", "very_good", "good", "fair", "incomplete", "no_details")
• new_used array nullable — New / used (one of: "new_unworn", "used", "no_details")
• case_material array nullable — Case material (one of: "aluminum", "brass", "bronze", "carbon", "ceramic", "gold_steel", "gold_plated", "palladium", "plastic", "platinum", "rose_gold", "sapphire_crystal", "silver", "steel", "tantalum", "titanium", "tungsten", "white_gold", "yellow_gold", "no_details")
• bezel_material array nullable — Bezel material (one of: "aluminum", "brass", "bronze", "carbon", "ceramic", "gem_set", "gold_steel", "gold_plated", "palladium", "plastic", "platinum", "red_gold", "rose_gold", "rubber", "silver", "steel", "tantalum", "titanium", "tungsten", "white_gold", "yellow_gold", "no_details")
• band_material array nullable — Band / bracelet material (one of: "alligator_skin", "aluminium", "brass", "calf_skin", "ceramic", "crocodile_skin", "gold_steel", "gold_plated", "leather", "lizard_skin", "ostrich_skin", "plastic", "platinum", "red_gold", "rose_gold", "rubber", "satin", "shark_skin", "silicon", "silver", "snake_skin", "steel", "textile", "titanium", "white_gold", "yellow_gold", "no_details")
• band_color array nullable — Band / bracelet color (one of: "beige", "black", "blue", "bordeaux", "bronze", "brown", "gold", "gold_steel", "green", "grey", "orange", "pink", "purple", "red", "silver", "steel", "white", "yellow", "no_details")
• clasp_material array nullable — Clasp material (one of: "aluminum", "bronze", "gold_steel", "plastic", "platinum", "red_gold", "rose_gold", "silver", "steel", "titanium", "white_gold", "yellow_gold", "no_details")
• clasp array nullable — Clasp type (one of: "buckle", "double_fold_clasp", "fold_clasp", "fold_clasp_hidden", "jewelry_clasp", "no_clasp", "no_details")
• dial_color array nullable — Dial color (one of: "black", "blue", "bordeaux", "bronze", "brown", "champagne", "gold", "gold_solid", "green", "grey", "meteorite", "mother_of_pearl", "orange", "pink", "purple", "red", "silver", "silver_solid", "skeletonized", "skeletonized_2", "turquoise", "white", "yellow", "no_details")
• dial_style array nullable — Dial style / numerals (one of: "arabic_numerals", "gemstones", "lines", "no_numerals", "roman_numerals", "no_details")
• crystal array nullable — Crystal type (one of: "glass", "mineral_glass", "plastic", "plexiglass", "sapphire_crystal", "no_details")
• movement array nullable — Movement type (one of: "automatic", "manual_winding", "quartz", "smartwatch", "solar", "no_details")
• functions array nullable — Complications / functions (one of: "v4_year_calendar", "alarm", "annual_calendar", "chiming_clock", "chronograph", "date", "double_chronograph", "equation_of_time", "flyback", "gmt", "jumping_hour", "minute_repeater", "month", "moon_phase", "panorama_date", "perpetual_calendar", "repeater", "tachymeter", "tourbillon", "weekday", "year")
• watch_style array nullable — Watch style / category (one of: "automatic_watches", "business_watches", "calendar_watches", "chronographs", "chronometer", "diving_watches", "dress_watches", "flyback_chronographs", "large_xxl_watches", "left_handed_watches", "limited_edition_watches", "manually_wound_watches", "mechanical_watches", "military_watches", "minute_repeater", "moon_phase_watches", "one_hand_watches", "perpetual_calendar_watches", "pilot_s_watches", "quartz_watches", "racing_watches", "rectangular_watches", "russian_watches", "sailing_watches", "sapphire_glass_watches", "skeleton_watches", "smartwatches", "solar_watches", "sports_watches", "swiss_watches", "tachymeter_watches", "thin_watches", "tonneau_watches", "tourbillon_watches", "vintage_watches", "watches_from_german_manufacturers", "watches_with_a_geneva_seal", "watches_with_a_see_through_case_back", "world_time_watches")
• other_attributes array nullable — Other attributes (one of: "central_seconds", "chronometer", "crown_left", "display_back", "gemstones_and_or_diamonds", "genevian_seal", "guilloch_dial", "guilloch_dial_handwork", "helium_valve", "limited_edition", "luminous_hands", "luminous_indices", "luminous_numerals", "master_chronometer", "one_hand_watches", "only_original_parts", "power_reserve_display", "pvd_dlc_coating", "quick_set", "rotating_bezel", "screw_down_crown", "screw_down_push_buttons", "skeletonized", "small_seconds", "smartwatch", "solar_watch", "special_edition", "tempered_blue_hands", "vintage", "world_time_watch")
• gender array nullable — Gender (one of: "men_s_watch_unisex", "women_s_watch")
• watch_category array nullable — Style of watch (one of: "wristwatch", "pocket_watch", "other_watch_clock")
• watch_types array nullable — Watch type: complete watches vs parts / accessories (one of: "watches", "parts_accessories")
• water_resistance array nullable — Water resistance (one of: "not_water_resistant", "v1_atm", "v2_atm", "v2_5_atm", "v3_atm", "v4_atm", "v5_atm", "v6_atm", "v7_atm", "v8_atm", "v9_atm", "v10_atm", "v15_atm", "v20_atm", "v30_atm", "v40_atm", "v50_atm", "v60_atm", "v70_atm", "v90_atm", "v100_atm", "v110_atm", "v120_atm", "over_120_atm", "no_details")
• delivery_contents array nullable — Box / papers delivery contents (one of: "watch_with_original_box_and_original_papers", "watch_with_original_papers", "watch_with_original_box")
• availability array nullable — Stock availability (one of: "item_is_in_stock", "item_needs_to_be_procured", "item_available_on_request")
• seller_type array nullable — Seller type (one of: "chrono24_direct", "private_sellers", "professional_dealer")
• certified boolean nullable — Only Chrono24-certified listings

Response

• @type string (default: "Chrono24SearchWatch")
• id string required
• url string required
• name string nullable
• subtitle string nullable
• price number nullable
• currency string nullable
• shipping_info string nullable
• location string nullable
• certified_status string nullable
• badges array (default: [])
• image string nullable

Errors

• 422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — The entity was not found, or a precondition failed Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.