{ "openapi": "3.0.1", "info": { "title": "Chrono24 Scraper – Incremental ⌚", "description": "[⭐$2/1k] Scrape watch listings from Chrono24 with prices, images, shipping costs & seller details. 50+ Filters. Allows incremental scraping to save costs. Returns structured JSON/CSV for price tracking, market analysis & research.", "version": "0.0", "x-build-id": "q1QZjAAzgNKqZthxu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/epicscrapers~chrono24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-epicscrapers-chrono24-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/epicscrapers~chrono24-scraper/runs": { "post": { "operationId": "runs-sync-epicscrapers-chrono24-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/epicscrapers~chrono24-scraper/run-sync": { "post": { "operationId": "run-sync-epicscrapers-chrono24-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", "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Enter a free-text search term — brand name, model, reference number, or any keyword you'd type into Chrono24's search bar.

Examples: Rolex Daytona, Omega Seamaster 300, 126610LN.

Leave blank to browse by filters alone." }, "maxResults": { "title": "Max Listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many listings to collect. Results are fetched 30 at a time (one page = one request).

Start low (10–50) to verify output before running a large job.", "default": 10 }, "enrichDetails": { "title": "Enrich Details (slower & costs more)", "type": "boolean", "description": "When enabled, the scraper opens each listing's detail page to collect extended data: reference number, full seller profile, all images, and description text.

⚠️ This makes the run significantly slower and increases compute usage — one extra page request per listing. Enable only when you need the extra fields.", "default": false }, "currency": { "title": "Currency", "enum": [ "USD", "EUR", "GBP", "JPY", "CHF", "CAD", "AUD", "HKD", "SGD", "CNY", "KRW", "INR", "RUB", "BRL", "MXN", "NOK", "SEK", "DKK", "PLN", "TRY", "ZAR", "AED", "TWD", "MYR", "THB", "PHP", "IDR", "VND", "ILS", "CLP", "COP", "PEN", "NGN", "EGP", "KES" ], "type": "string", "description": "Choose the currency for all listing prices in the output.", "default": "USD" }, "sortOrder": { "title": "Sort Order", "enum": [ "0", "1", "5", "11", "15", "42" ], "type": "string", "description": "Choose how Chrono24 sorts results before scraping. Newest first is useful for monitoring new listings; Relevance is best for open-ended searches.", "default": "5" }, "manufacturerIds": { "title": "Brand IDs", "type": "string", "description": "Enter one or more Chrono24 brand IDs, separated by commas.

Common IDs:
221 = Rolex
187 = Omega
43 = Cartier
32 = Breitling
115 = IWC
194 = Patek Philippe
18 = Audemars Piguet
245 = Tudor

To find other brand IDs, search Chrono24 and check the URL for manufacturerId." }, "models": { "title": "Model IDs", "type": "string", "description": "Enter one or more Chrono24 model IDs, separated by commas.

How to find model IDs: run a text search first (e.g. Rolex Datejust 36) with Enrich Details enabled, then check the detail.modelId field in the output." }, "catalogCollectionId": { "title": "Collection ID", "type": "string", "description": "Filter by a Chrono24 catalog collection (e.g. 314 = Datejust collection). More specific than brand — use when you want all variants of a named collection." }, "catalogModelId": { "title": "Catalog Model ID", "type": "string", "description": "Filter by a specific catalog model variant. More granular than Collection ID. Find it in Chrono24's URL when browsing a specific model page." }, "priceFrom": { "title": "Min Price", "minimum": 0, "type": "integer", "description": "Minimum listing price in your chosen currency. Leave blank for no lower bound." }, "priceTo": { "title": "Max Price", "minimum": 0, "type": "integer", "description": "Maximum listing price in your chosen currency. Leave blank for no upper bound." }, "watchTypes": { "title": "New or Used", "enum": [ "", "U", "N" ], "type": "string", "description": "Include new watches, used watches, or both.", "default": "" }, "condition": { "title": "Condition Grade", "enum": [ "", "101", "1301", "1302", "1306", "1303", "1305" ], "type": "string", "description": "Filter by the seller's stated condition grade — more granular than New/Used. For example, filter used watches to Very good or above. Leave blank to include all grades.", "default": "" }, "certified": { "title": "Certified listings only", "type": "boolean", "description": "Returns only listings covered by Chrono24 Certification — authenticity is guaranteed and returns are accepted. Significantly reduces result count.", "default": false }, "specials": { "title": "Delivery Contents", "type": "array", "description": "Filter by what's included with the watch. Leave empty to include all listings regardless of box/papers.", "items": { "type": "string", "enum": [ "102", "103", "104" ], "enumTitles": [ "Box and papers", "Box only", "Papers only" ] }, "default": [] }, "movementTypes": { "title": "Movement", "enum": [ "", "1", "2", "3", "4", "5" ], "type": "string", "description": "Filter by movement type. Choose Automatic to exclude quartz; choose Manual winding for traditional hand-wound calibres.", "default": "" }, "gender": { "title": "Gender", "enum": [ "", "1401", "1402" ], "type": "string", "description": "Filter by the watch's intended gender category as listed on Chrono24.", "default": "" }, "caseDiameter": { "title": "Case Diameter (mm)", "type": "string", "description": "Filter by case size in millimeters. Enter a single value like 40 or a range like 36,42 to set min and max." }, "year": { "title": "Year of Production", "type": "string", "description": "Filter by production year. Enter a single year like 2020, or a range like 2018,2023." }, "waterproof": { "title": "Water Resistance", "enum": [ "", "901", "902", "903", "1350", "904", "905", "906", "907", "908", "909", "910", "911", "1351", "912", "913", "914", "915", "916", "917", "918", "919", "920", "921", "922", "923" ], "type": "string", "description": "Filter by water resistance rating in ATM.", "default": "" }, "functions": { "title": "Complications / Functions", "type": "array", "description": "Filter by watch complications. Select one or more. Leave empty to include all.", "items": { "type": "string", "enum": [ "1000", "1010", "1011", "1012", "1013", "1014", "1015", "1016", "1017", "1018", "1019", "1020", "1021", "1022", "1023", "1024", "1026", "1027", "1028", "1360" ], "enumTitles": [ "Chronograph", "Double chronograph", "Flyback", "Panorama date", "Repeater", "Tourbillon", "Annual calendar", "4-year calendar", "Perpetual calendar", "Alarm", "Chiming clock", "Moon phase", "Minute repeater", "Date", "Weekday", "Month", "Tachymeter", "Jumping hour", "Equation of time", "GMT" ] }, "default": [] }, "styles": { "title": "Watch Style", "type": "array", "description": "Filter by style category — useful for broad searches like Diving watches or Vintage watches without needing a specific brand.", "items": { "type": "string", "enum": [ "1801", "1802", "1803", "1804", "1805", "1807", "1809", "1811", "1812", "1813", "1815", "1816", "1817", "1818", "1819", "1820", "1821", "1822", "1823", "1824", "1825", "1826", "1827", "1830", "1839", "1841" ], "enumTitles": [ "Sports watches", "Vintage watches", "Pilot's watches", "Diving watches", "Dress watches", "Military watches", "Business watches", "Automatic watches", "Chronographs", "Chronometer", "One-hand watches", "Perpetual calendar watches", "Skeleton watches", "Flyback chronographs", "Large / XXL watches", "World time watches", "Calendar watches", "Limited edition watches", "Left-handed watches", "Mechanical watches", "Minute repeater", "Moon phase watches", "Quartz watches", "Swiss watches", "Tourbillon watches", "Manually-wound watches" ] }, "default": [] }, "caseMaterials": { "title": "Case Material", "type": "array", "description": "Filter by the watch case material. Select one or more.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21" ], "enumTitles": [ "Rose gold", "Red gold", "Yellow gold", "Steel", "Titanium", "Aluminum", "Platinum", "White gold", "Gold/Steel", "Silver", "Plastic", "Ceramic", "Palladium", "Tungsten", "Tantalum", "Carbon", "Bronze", "Brass", "Gold-plated", "Sapphire crystal" ] }, "default": [] }, "dialColor": { "title": "Dial Color", "type": "array", "description": "Filter by dial color. Select one or more.", "items": { "type": "string", "enum": [ "701", "702", "703", "704", "705", "706", "707", "708", "709", "710", "711", "712", "714", "715", "716", "719", "720", "721", "722", "723", "724", "725", "726" ], "enumTitles": [ "White", "Black", "Turquoise", "Skeletonized", "Gold (solid)", "Silver (solid)", "Mother of pearl", "Silver", "Champagne", "Blue", "Bordeaux", "Bronze", "Gold", "Grey", "Green", "Orange", "Red", "Purple", "Pink", "Brown", "Yellow", "Meteorite", "Skeletonized" ] }, "default": [] }, "braceletMaterial": { "title": "Band Material", "type": "array", "description": "Filter by the bracelet or strap material. Select one or more.", "items": { "type": "string", "enum": [ "401", "402", "403", "404", "406", "407", "408", "409", "410", "411", "412", "413", "414", "415", "416", "417", "418", "419", "420", "421", "422", "423", "424", "425", "426" ], "enumTitles": [ "Calf skin", "Ostrich skin", "Crocodile skin", "Leather", "Plastic", "Steel", "Titanium", "White gold", "Gold/Steel", "Rose gold", "Red gold", "Yellow gold", "Aluminium", "Platinum", "Textile", "Silver", "Rubber", "Shark skin", "Satin", "Ceramic", "Lizard skin", "Silicon", "Alligator skin", "Brass", "Gold-plated" ] }, "default": [] }, "braceletColor": { "title": "Band Color", "type": "array", "description": "Filter by bracelet or strap color. Select one or more.", "items": { "type": "string", "enum": [ "601", "602", "603", "604", "605", "606", "607", "608", "609", "610", "611", "612", "615", "616", "617", "618", "619", "620" ], "enumTitles": [ "Black", "Brown", "Silver", "Gold", "Steel", "Beige", "Blue", "Bordeaux", "Bronze", "Yellow", "Grey", "Green", "Orange", "Red", "Purple", "White", "Pink", "Gold/Steel" ] }, "default": [] }, "sellerType": { "title": "Seller Type", "enum": [ "", "Dealer", "PrivateSeller", "C24Direct" ], "type": "string", "description": "Professional dealers typically have more photos and return policies. Private sellers may offer lower prices. Chrono24 Direct ships from Chrono24's own warehouse.", "default": "" }, "stockInfo": { "title": "Availability", "enum": [ "", "InStock", "OnOrder", "OnRequest" ], "type": "string", "description": "Filter by stock status. Choose In stock for immediately available watches.", "default": "" }, "countryIds": { "title": "Seller Country", "type": "string", "description": "Filter by seller location using two-letter ISO country codes. Separate multiple countries with commas.

Examples: US, CH (Switzerland), DE (Germany), JP (Japan)." }, "trackingId": { "title": "Tracking ID", "type": "string", "description": "An arbitrary string (e.g. a run ID, campaign name, or correlation key) that will be attached to every scraped listing in the output dataset. Use it to identify which job produced which results when running many scraping jobs in parallel.

Leave blank to omit the field from output (faster, less data)." } } }, "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 } } } } } } } } } }