# Chrono24 Listing API Documentation

<p><strong>Chrono24 Listing API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/chrono24-api/chrono24_listing](https://scrappa.co/docs/chrono24-api/chrono24_listing)
- **API group:** Chrono24 API
- **Endpoint:** `GET https://scrappa.co/api/chrono24/listing`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | No | The number after --id in a Chrono24 listing url, e.g. 33570222. Send id or url. |
| `url` | string | No | 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. |
| `country` | string | No | Chrono24 site: com (USD, default), co.uk (GBP) or de (EUR). The site sets the currency. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | No active listing has this id. It may be sold or removed. This response is not billable. |
| 503 | Upstream Unavailable | Chrono24 did not answer after the internal retries. This response is not billable. Retry in a moment. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)