Chrono24

Search Chrono24 watch listings

Searches Chrono24's luxury-watch marketplace by free-text keyword, or browses one brand's (optionally narrowed to one model's) current listings, returning result cards: title, price with currency, seller type, seller country, promotional badge, image, and the listing URL to pass to chrono24-listing. At least one of query or brand is required. Optional advanced-search filters (condition, used_or_new, case_material, dial_color, bracelet_material, movement_type, gender, watch_type, stock_info) narrow results further; each filter's accepted values are discoverable from chrono24-facets and echoed back in the response's filters field.

get/chrono24/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/chrono24/search
  • Auth: API key in header x-api-key

Query parameters

querystring

Free-text keyword search, e.g. \

brandstring

Brand slug from chrono24-brands. At least one of query or brand is required

modelstring

Model slug from chrono24-models (requires brand)

sort'relevance' | 'price_asc' | 'price_desc' | 'newest' | 'popularity'

Result order. One of: relevance, price_asc, price_desc, newest, popularity

pageinteger

One-based result page

page_sizeinteger

Results per page. Chrono24's own UI offers 30, 60 or 120; defaults to Chrono24's own default

condition'new' | 'like_new_unworn' | 'very_good' | 'good' | 'fair' | 'incomplete' | 'no_details'

Advanced-search filter, values from chrono24-facets group=condition

used_or_new'new' | 'used' | 'no_details'

Advanced-search filter, values from chrono24-facets group=usedOrNew

case_material'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'

Advanced-search filter, values from chrono24-facets group=caseMaterial

dial_color'black' | 'blue' | 'bordeaux' | 'bronze' | 'brown' | 'champagne' | 'gold' | 'green' | 'grey' | 'meteorite' | 'mother_of_pearl' | 'orange' | 'pink' | 'purple' | 'red' | 'silver' | 'skeletonized' | 'turquoise' | 'white' | 'yellow' | 'no_details'

Advanced-search filter, values from chrono24-facets group=dialColor

bracelet_material'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'

Advanced-search filter, values from chrono24-facets group=braceletMaterial

movement_type'automatic' | 'manual_winding' | 'quartz' | 'solar' | 'smartwatch' | 'no_details'

Advanced-search filter, values from chrono24-facets group=movementType

gender'mens_unisex' | 'womens'

Advanced-search filter, values from chrono24-facets group=gender

watch_type'watches' | 'parts_accessories'

Advanced-search filter, values from chrono24-facets group=watchType

stock_info'in_stock' | 'on_order' | 'on_request'

Advanced-search filter, values from chrono24-facets group=stockInfo

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.