API Reference
Use Crawlora's Chrono24 API endpoints to extract supported public Chrono24 data as structured JSON. This documentation covers 8 active endpoints including Get Chrono24 search-box suggestions, List Chrono24 watch brands, Get a Chrono24 dealer's storefront, Get a Chrono24 dealer's buyer reviews, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as query, slug, group, path, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/chrono24/search?query=coffee&sort=relevance&page=1&condition=new&used_or_new=new&case_material=aluminum&dial_color=black&bracelet_material=alligator_skin&movement_type=automatic&gender=mens_unisex&watch_type=watches&stock_info=in_stock" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/chrono24/autocompleteapiKey5 credits/requestFetches Chrono24's own search-box typeahead suggestions for a partial query: each suggested phrase with its own live result count, plus the Chrono24 search URL it resolves to. Useful for building a search box against chrono24-search without guessing a full query.
Required params: query:query
/chrono24/brandsapiKey3 credits/requestReturns Chrono24's full watch-brand index: every brand name and the slug identifying it, usable as the brand parameter on chrono24-models and chrono24-search. This is the discovery endpoint for that parameter, so every accepted value is obtainable from this API rather than by reading the website.
Required params: None
/chrono24/dealerapiKey5 credits/requestFetches one Chrono24 dealer/seller's public storefront page: business description, trust badge, average buyer rating and review count, lifetime watches-sold count, and their current listed inventory in the same shape chrono24-search returns. slug is found in a chrono24-search or chrono24-listing result's seller link; there is no separate dealer-discovery endpoint since dealer slugs are not a closed set Chrono24 publishes an index of.
Required params: slug:query
/chrono24/dealer/reviewsapiKey8 credits/requestFetches one page of a Chrono24 dealer/seller's buyer reviews: reviewer name and country, review date, star-rating breakdown (shipping/description/communication), whether the buyer recommends the seller, their free-text comment, and the dealer's own reply when present. slug is the same dealer slug chrono24-dealer takes.
Required params: slug:query
/chrono24/facetsapiKey3 credits/requestFetches every value Chrono24 accepts for one of chrono24-search's advanced-search filter params, each with its own live listing count: the discovery endpoint for condition, used_or_new, case_material, dial_color, bracelet_material, movement_type, gender, watch_type and stock_info.
Required params: group:query
/chrono24/listingapiKey5 credits/requestFetches one Chrono24 listing's full detail page: brand, model, reference number, price with currency and negotiability, condition, year of production, movement, case material and diameter, bracelet material, location, availability, seller type, photos, and the complete raw spec table Chrono24 itself shows (grouped by section: Basic Info, Caliber, Case, Bracelet/strap, Functions). path is the listing URL from a chrono24-search result's url field; Chrono24 has no lookup by numeric id alone.
Required params: path:query
/chrono24/modelsapiKey4 credits/requestReturns every model/collection Chrono24 lists for one watch brand (e.g. Rolex Submariner, Rolex Datejust), each with the slug identifying it, usable as the model parameter on chrono24-search. This is the discovery endpoint for that parameter, so every accepted value for a brand is obtainable from this API rather than by reading the website.
Required params: brand:query
/chrono24/searchapiKey5 credits/requestSearches Chrono24's luxury-watch marketplace by free-text keyword, or browses one brand's (optionally narrowed to one model's) current listings, returning normalized 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.
Required params: None
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Get Chrono24 search-box suggestions | /chrono24/autocomplete | GET | 5 credits/request | query:query | View docs | Try endpoint |
| List Chrono24 watch brands | /chrono24/brands | GET | 3 credits/request | None | View docs | Try endpoint |
| Get a Chrono24 dealer's storefront | /chrono24/dealer | GET | 5 credits/request | slug:query | View docs | Try endpoint |
| Get a Chrono24 dealer's buyer reviews | /chrono24/dealer/reviews | GET | 8 credits/request | slug:query | View docs | Try endpoint |
| Get a Chrono24 search filter's accepted values | /chrono24/facets | GET | 3 credits/request | group:query | View docs | Try endpoint |
| Get a Chrono24 watch listing's detail | /chrono24/listing | GET | 5 credits/request | path:query | View docs | Try endpoint |
| List Chrono24 models for a brand | /chrono24/models | GET | 4 credits/request | brand:query | View docs | Try endpoint |
| Search Chrono24 watch listings | /chrono24/search | GET | 5 credits/request | None | View docs | Try endpoint |