docs / chrono24

Chrono24 API

base /chrono24/v13 endpoints

post/chrono24/v1/search1 credit

Search Chrono24 by free-text keyword (brand + model + reference, e.g. 'rolex submariner', 'omega speedmaster 3861'). Optional filters: price_min/price_max, condition (new/used), movement, year, sort. Paginated (~60/page). Returns listing cards with title, price, currency, condition availability, image and url.

Parameter		Allowed / range	Description
query	required	—	What to search for — brand, model and/or reference number ('rolex submariner', 'patek nautilus 5711', 'omega 3861').
page = 1	optional	1–100	Result page (~60 listings per page). Page until meta.pagination.has_more is false.
price_min	optional	0–	Minimum price filter (in the listing currency, USD).
price_max	optional	0–	Maximum price filter (in the listing currency, USD).
condition	optional	new · used · incomplete	Filter by watch condition.
movement	optional	automatic · manual · quartz	Filter by movement type.
year	optional	1900–2030	Filter to watches produced in this year.
sort = relevance	optional	relevance · price_asc · price_desc · newest	Result ordering.

Try in playground →

post/chrono24/v1/browse1 credit

Browse all listings for a brand (e.g. brand='rolex') or a brand+model (brand='omega', model='speedmaster'). Same filters and paginated card shape as search — the catalog-discovery surface for a whole brand or model family.

Parameter		Allowed / range	Description
brand	required	—	Watch brand to browse (rolex, omega, patek-philippe, audemars-piguet, tudor, cartier, ...).
model	optional	—	Optional model/family within the brand (submariner, speedmaster, nautilus, ...).
page = 1	optional	1–100	Result page (~60 listings per page). Page until meta.pagination.has_more is false.
price_min	optional	0–	Minimum price filter (in the listing currency, USD).
price_max	optional	0–	Maximum price filter (in the listing currency, USD).
condition	optional	new · used · incomplete	Filter by watch condition.
movement	optional	automatic · manual · quartz	Filter by movement type.
year	optional	1900–2030	Filter to watches produced in this year.
sort = relevance	optional	relevance · price_asc · price_desc · newest	Result ordering.

Try in playground →

post/chrono24/v1/detail1 credit

Full watch listing by `url` OR `listing_id`: brand, model, reference number, price, currency, condition (+ condition text), year, movement, case material, case diameter, crystal, strap material, dial, gender, jewels, power reserve, scope of delivery, seller location, delivery estimate, description and all images.

Parameter		Allowed / range	Description
url	optional	—	Full Chrono24 listing URL (from a search/browse result).
listing_id	optional	—	Chrono24 listing id (the number in --id<N>.htm). Provide url OR listing_id.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/chrono24/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"rolex submariner"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}