# Chrono24 Listings Scraper (`piotrv1001/chrono24-listings-scraper`) Actor The Chrono24 Listings Scraper extracts luxury-watch listings and enriched detail records from Chrono24.com, capturing brand, model, reference number, price, condition, year, specs, seller info, descriptions, and images — ideal for price tracking, market research, and watch valuation. - **URL**: https://apify.com/piotrv1001/chrono24-listings-scraper.md - **Developed by:** [FalconScrape](https://apify.com/piotrv1001) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 product listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### 🚀 Chrono24 Listings Scraper Easily extract luxury-watch data from **[Chrono24](https://www.chrono24.com)**, the world's largest marketplace for pre-owned and new watches. The **Chrono24 Listings Scraper** turns brand, model, or watch URLs into clean, structured data — **prices, reference numbers, full specs, seller info, descriptions, and images** — ready for price tracking, market analysis, and valuation. Chrono24 is heavily protected against bots, so ordinary scrapers get blocked. This Actor **handles the anti-bot protection for you automatically** — no browser setup, no CAPTCHAs, no configuration. You just provide URLs. ### ✨ Features - 🏷️ **Two depths of data**: fast, high-volume listing data (name, price, image, URL, availability), or full detail records with a 20+ field spec table, seller info, full description, and every photo. - 🔗 **Flexible inputs**: brand index pages, model listing pages, or individual watch pages — the Actor auto-detects each URL type. - 🌍 **Localized pricing**: choose a country to control the currency of returned prices (USD, EUR, GBP, …). - 🎯 **Cost control**: cap the run with **Max items**; it stops automatically once the limit is reached. - 🛡️ **Reliable**: runs on a maintained anti-bot backend, so it keeps working where other Chrono24 scrapers break. ### 🛠️ How It Works 1. **Enter Start URLs** – Provide a list of Chrono24 brand, model, or watch page URLs. 2. **Choose your depth** – Toggle **Scrape full watch details** for full spec/seller/description/image records, or leave it off for fast listing data. 3. **Run the Scraper** – Start the process and download structured data from the dataset as JSON, CSV, Excel, or HTML. #### Example start URLs | Page type | Example URL | | ---------------------------------- | -------------------------------------------------------------- | | Brand index (enqueues every model) | `https://www.chrono24.com/rolex/index.htm` | | Model listings | `https://www.chrono24.com/rolex/gmt-master--mod3.htm` | | Single watch (detail) | `https://www.chrono24.com/rolex/gmt-master-ii--id46165833.htm` | ### ⚙️ Input Configure the run from the **Input** tab or via the API. | Field | Key | Type | Default | Description | | ----------------------------- | --------------- | ------- | ------- | ------------------------------------------------------------------------------------------------------------ | | **Start URLs** | `startUrls` | array | — | Chrono24 brand, model, or watch URLs to scrape (required). Page type is detected automatically. | | **Scrape full watch details** | `scrapeDetails` | boolean | `false` | Follow each listing to its detail page for the full spec table, seller, description, and images. | | **Max items** | `maxItems` | integer | `50` | Maximum number of watches to collect. The run stops once it's reached. Set to `0` for no limit. | | **Country (pricing locale)** | `country` | string | `us` | Country used for the rendered locale — controls the currency of returned prices (`us`, `de`, `gb`, `fr`, …). | #### Example input ```json { "startUrls": [{ "url": "https://www.chrono24.com/rolex/gmt-master--mod3.htm" }], "scrapeDetails": true, "maxItems": 50, "country": "us" } ```` ### 📊 Sample Output Data Each watch is stored as one dataset item. With **Scrape full watch details** enabled you get the complete record: ```json { "listingId": "46109984", "url": "https://www.chrono24.com/rolex/gmt-master-ii--id46109984.htm", "title": "Rolex GMT-Master II and card with coffin case", "brand": "Rolex", "model": "GMT-Master II", "referenceNumber": "126710GRNR", "price": 20400, "priceCurrency": "USD", "priceNegotiable": false, "condition": "Used (Good) — visible and tangible signs of wear...", "yearOfProduction": "2024", "scopeOfDelivery": "Original papers, no original box", "movement": "Automatic", "caseMaterial": "Steel", "caseDiameter": "40 mm", "dial": "Black", "waterResistance": "10 ATM", "location": "United States of America, North Carolina, Cary", "sellerName": "Carolina Watches", "isProfessionalDealer": true, "description": "This is dated 2024 as seen on card...", "images": ["https://img.chrono24.com/images/uhren/...-ExtraLarge.jpg"], "scrapedAt": "2026-06-02T12:16:26.143Z" } ``` With details **off**, each item is a lightweight listing record: ```json { "listingId": "46109984", "url": "https://www.chrono24.com/rolex/gmt-master-ii--id46109984.htm", "name": "Rolex GMT-Master II Watch and card with coffin case", "price": 20400, "availability": "http://schema.org/InStock", "image": "https://img.chrono24.com/images/uhren/...-ExtraLarge.jpg", "scrapedAt": "2026-06-02T12:39:06.884Z" } ``` ### 💰 Pricing This Actor uses a **pay-per-event** model — you pay only for the data you actually receive. Two event types let you balance cost against depth: | Event | When it's charged | Price | | ------------------- | -------------------------------------------------------------------------------------------- | ------------------ | | **Product listing** | Per shallow listing collected (name, price, image, URL, availability) — details **off** | **$1.00 / 1,000** | | **Item detail** | Per fully-enriched watch (full spec table, seller, description, all images) — details **on** | **$12.00 / 1,000** | > 💡 **Tip:** Start with a small **Max items** value to estimate cost before scaling up. Use listings-only mode for cheap, high-volume price tracking, and enable details only when you need the full record. Track prices, spot under-valued listings, and build luxury-watch datasets with the **Chrono24 Listings Scraper** today! 🚀 # Actor input Schema ## `startUrls` (type: `array`): Chrono24 URLs to scrape. Supports brand index pages (e.g. https://www.chrono24.com/rolex/index.htm), model listing pages (e.g. https://www.chrono24.com/rolex/gmt-master--mod3.htm), and individual watch detail pages (e.g. .../...--id46165833.htm). The scraper detects the page type automatically. ## `scrapeDetails` (type: `boolean`): When enabled, each listing is followed to its detail page to extract the full 20+ field spec table, seller info, description, and all images (one request per watch). When disabled, only the lightweight listing data (name, price, image, URL) from model pages is collected (60 listings per request). ## `maxItems` (type: `integer`): Maximum number of watches to scrape. The run stops once this many items have been collected. Set to 0 for no limit. ## `country` (type: `string`): Country used for the rendered locale. Determines the currency of returned prices. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.chrono24.com/rolex/gmt-master--mod3.htm" } ], "scrapeDetails": false, "maxItems": 50, "country": "us" } ``` # Actor output Schema ## `watches` (type: `string`): No description ## `runStats` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.chrono24.com/rolex/gmt-master--mod3.htm" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("piotrv1001/chrono24-listings-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.chrono24.com/rolex/gmt-master--mod3.htm" }] } # Run the Actor and wait for it to finish run = client.actor("piotrv1001/chrono24-listings-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.chrono24.com/rolex/gmt-master--mod3.htm" } ] }' | apify call piotrv1001/chrono24-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=piotrv1001/chrono24-listings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Chrono24 Listings Scraper", "description": "The Chrono24 Listings Scraper extracts luxury-watch listings and enriched detail records from Chrono24.com, capturing brand, model, reference number, price, condition, year, specs, seller info, descriptions, and images — ideal for price tracking, market research, and watch valuation.", "version": "0.0", "x-build-id": "EuGq22cyfdX86rG7D" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~chrono24-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-chrono24-listings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/piotrv1001~chrono24-listings-scraper/runs": { "post": { "operationId": "runs-sync-piotrv1001-chrono24-listings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/piotrv1001~chrono24-listings-scraper/run-sync": { "post": { "operationId": "run-sync-piotrv1001-chrono24-listings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Chrono24 URLs to scrape. Supports brand index pages (e.g. https://www.chrono24.com/rolex/index.htm), model listing pages (e.g. https://www.chrono24.com/rolex/gmt-master--mod3.htm), and individual watch detail pages (e.g. .../...--id46165833.htm). The scraper detects the page type automatically.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "scrapeDetails": { "title": "Scrape full watch details", "type": "boolean", "description": "When enabled, each listing is followed to its detail page to extract the full 20+ field spec table, seller info, description, and all images (one request per watch). When disabled, only the lightweight listing data (name, price, image, URL) from model pages is collected (60 listings per request).", "default": false }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of watches to scrape. The run stops once this many items have been collected. Set to 0 for no limit.", "default": 50 }, "country": { "title": "Country (pricing locale)", "enum": [ "us", "gb", "de", "fr", "it", "es", "ch", "jp", "au", "ca" ], "type": "string", "description": "Country used for the rendered locale. Determines the currency of returned prices.", "default": "us" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```