Chrono24 Listing API Documentation Get one Chrono24 listing. It returns the price as a number with currency, the negotiable flag, brand, collection, model, reference, condition, year of production, movement, case, bezel, dial and bracelet details, the scope of delivery with box and papers flags, the description, location, shipping cost and ship time, return policy, all photos in full size and the breadcrumbs with the brand slug, model id and reference slug. The dealer block has the name, type, rating, review count, trusted seller flag, years on Chrono24, watches sold, active listings and two ids: ratings_id for the dealer reviews endpoint and inventory_id for the dealer_id search filter. On chrono24.de the text fields (movement, case material, condition label, scope of delivery, description) are German. A sold or removed listing returns 404. Cost: 1 credit per request. Failed requests are not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
3 optional filters available.
string
Optional
The number after --id in a Chrono24 listing url, e.g. 33570222. Send id or url.
1234567890
string
Optional
A Chrono24 listing url ending in --id{number}.htm on chrono24.com, chrono24.co.uk or chrono24.de. The site of the url is used.
https://example.com/product
string
Optional
Chrono24 site: com (USD, default), co.uk (GBP) or de (EUR). The site sets the currency.
US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"item": {
"id": 33570222,
"box": true,
"ids": {
"model_id": 71,
"brand_slug": "omega",
"reference_slug": "31030425004001"
},
"url": "https://www.chrono24.com/omega/speedmaster-moonwatch-white-dial-2025-new-release-31030425004001--id33570222.htm",
"dial": "White",
"site": "com",
"brand": "Omega",
"model": "Speedmaster Professional Moonwatch",
"price": 10074,
"title": "Omega Speedmaster Moonwatch White Dial 2026 NEW RELEASE 310.30.42.50.04.001",
"dealer": {
"name": "Rebes Timepieces",
"slug": "erebers",
"type": "dealer",
"rating": 4.9,
"location": "Boca Raton, United States of America",
"ratings_id": 13014,
"inventory_id": 23014,
"review_count": 1739,
"watches_sold": 2761,
"trusted_seller": true,
"active_listings": 143,
"on_chrono24_since": 2019
},
"gender": "unisex",
"images": [
"https://img.chrono24.com/images/uhren/33570222-ohpm6660kxh2e3m8ikun6wya-ExtraLarge.jpg",
"https://img.chrono24.com/images/uhren/33570222-k7ns2dl198l287u6ugk830eh-ExtraLarge.jpg"
],
"papers": true,
"crystal": "Sapphire crystal",
"currency": "USD",
"location": {
"region": "Florida, Boca Raton",
"country": "United States of America",
"country_code": "US"
},
"movement": "Manual winding",
"shipping": {
"cost": null,
"currency": "USD",
"delivery_estimate": "Anticipated delivery: 11/9 - 11/23",
"ships_within_days": {
"max": 3,
"min": 1
}
},
"condition": "new",
"reference": "310.30.42.50.04.001",
"collection": "Speedmaster",
"negotiable": false,
"breadcrumbs": [
{
"url": "https://www.chrono24.com/omega/index.htm",
"name": "Omega watches"
},
{
"url": "https://www.chrono24.com/omega/speedmaster-professional-moonwatch--mod71.htm",
"name": "Speedmaster Professional Moonwatch"
},
{
"url": "https://www.chrono24.com/omega/ref-31030425004001.htm",
"name": "Omega 310.30.42.50.04.001"
}
],
"description": "This just released white dial edition model Omega Speedmaster Professional \u201cMoonwatch\u201d Sapphire ref. 310.30.42.50.04.001 has been completely revamped in order t...",
"availability": "in_stock",
"last_service": null,
"listing_code": "JZIY66",
"case_diameter": "42 mm",
"case_material": "Steel",
"return_policy": {
"days": 14,
"category": "MerchantReturnFiniteReturnWindow"
},
"bezel_material": null,
"bracelet_color": "Steel",
"clasp_material": "Steel",
"condition_label": "New",
"bracelet_material": "Steel",
"scope_of_delivery": "Original box, original papers",
"year_of_production": 2026
}
},
"meta": {
"credits": 3,
"billable": true,
"endpoint_family": "listing"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. This response is not billable.
{
"errors": {
"id": [
"Send a listing id or a listing url."
]
},
"message": "The request validation failed"
}Not Found
No active listing has this id. It may be sold or removed. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "listing"
},
"error": {
"code": "NOT_FOUND",
"message": "Chrono24 has no active listing with this id. It may be sold or removed."
},
"success": false
}Upstream Unavailable
Chrono24 did not answer after the internal retries. This response is not billable. Retry in a moment.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Chrono24 is temporarily unavailable. Please retry. This request was not charged."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.