{ "openapi": "3.0.1", "info": { "title": "Chrono24 Scraper ยท 60 Fields ยท Details Included ยท From $1.00/1k", "description": "Scrape Chrono24 luxury watch listings with up to 56 fields each: reference number, year, caliber, jewels, power reserve, case material & diameter, water resistance, box & papers, price, shipping cost, dealer city/country and returns. All 560+ brands by name, plus incremental price monitoring.", "version": "0.1", "x-build-id": "JXDiScTZyWm9g3KjN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/corvuslab~chrono24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-corvuslab-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/corvuslab~chrono24-scraper/runs": { "post": { "operationId": "runs-sync-corvuslab-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/corvuslab~chrono24-scraper/run-sync": { "post": { "operationId": "run-sync-corvuslab-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": { "query": { "title": "๐Ÿ”‘ Search keywords", "type": "string", "description": "What to search for โ€” a brand, model, reference number or free text, e.g. \"Rolex Submariner\" or \"126610LN\". Comma-separate several searches." }, "startUrls": { "title": "๐Ÿ“‹ Start URLs", "type": "array", "description": "Paste Chrono24 URLs to scrape directly. Search URLs, brand pages (/rolex/index.htm), model pages, reference pages and individual listing pages all work โ€” each is detected automatically.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "๐Ÿ”ข Max results", "minimum": 0, "type": "integer", "description": "Maximum number of listings to return. Set 0 for unlimited (bounded by how many the search has).", "default": 25 }, "ignoreUrlFailures": { "title": "โญ๏ธ Ignore URL failures", "type": "boolean", "description": "Skip URLs that cannot be interpreted instead of failing the whole run.", "default": true }, "brands": { "title": "โŒš Brands", "type": "array", "description": "Limit to these watch brands. This list covers the 60 most traded โ€” for any of the other 500+ brands Chrono24 carries, use \"More brands\" below.", "items": { "type": "string", "enum": [ "Rolex", "Omega", "Patek Philippe", "Audemars Piguet", "Cartier", "Breitling", "IWC", "Jaeger-LeCoultre", "Panerai", "TAG Heuer", "Tudor", "Hublot", "Vacheron Constantin", "A. Lange & Sรถhne", "Grand Seiko", "Seiko", "Zenith", "Longines", "Chopard", "Breguet", "Richard Mille", "Blancpain", "Glashรผtte Original", "Oris", "Tissot", "Montblanc", "Bell & Ross", "Ulysse Nardin", "Chanel", "Hermรจs", "Bulgari", "Girard Perregaux", "Sinn", "NOMOS", "Franck Muller", "Baume & Mercier", "Rado", "Frederique Constant", "Maurice Lacroix", "Junghans", "Hamilton", "Certina", "Mido", "Citizen", "Casio", "Apple", "Garmin", "Swatch", "Fossil", "Raymond Weil", "Alpina", "Doxa", "Squale", "Christopher Ward", "MeisterSinger", "Stowa", "Laco", "Ball", "Bremont", "Zodiac" ] } }, "otherBrands": { "title": "โž• More brands", "type": "array", "description": "Any other Chrono24 brand, by name โ€” all 565 are recognised, e.g. \"A. Lange & Sรถhne\", \"Glashรผtte Original\", \"Czapek\", \"F.P. Journe\". Spelling is matched case-insensitively; names Chrono24 does not carry are ignored rather than failing the run.", "items": { "type": "string" } }, "condition": { "title": "โœจ Condition", "enum": [ "", "new", "used" ], "type": "string", "description": "Restrict to new/unworn or pre-owned watches.", "default": "" }, "priceFrom": { "title": "๐Ÿ’ฐ Minimum price", "minimum": 0, "type": "integer", "description": "Lowest asking price to include, in the currency Chrono24 shows for your region." }, "priceTo": { "title": "๐Ÿ’ธ Maximum price", "minimum": 0, "type": "integer", "description": "Highest asking price to include." }, "movements": { "title": "โš™๏ธ Movement", "type": "array", "description": "Restrict to these movement types.", "items": { "type": "string", "enum": [ "automatic", "manual winding", "quartz", "solar", "smartwatch" ], "enumTitles": [ "Automatic", "Manual winding", "Quartz", "Solar", "Smartwatch" ] } }, "caseMaterials": { "title": "๐Ÿ”ฉ Case material", "type": "array", "description": "Restrict to these case materials.", "items": { "type": "string", "enum": [ "steel", "yellow gold", "rose gold", "white gold", "platinum", "titanium", "ceramic", "carbon", "bronze", "silver", "gold/steel", "gold-plated", "aluminum", "brass", "palladium", "plastic", "tantalum", "tungsten" ], "enumTitles": [ "Steel", "Yellow gold", "Rose gold", "White gold", "Platinum", "Titanium", "Ceramic", "Carbon", "Bronze", "Silver", "Gold/Steel", "Gold-plated", "Aluminum", "Brass", "Palladium", "Plastic", "Tantalum", "Tungsten" ] } }, "braceletMaterial": { "title": "โ›“๏ธ Bracelet / strap material", "enum": [ "", "steel", "leather", "rubber", "textile", "ceramic", "titanium", "yellow gold", "rose gold", "white gold", "platinum", "gold/steel", "alligator skin", "crocodile skin", "calf skin", "silicon" ], "type": "string", "description": "Restrict to one bracelet or strap material.", "default": "" }, "gender": { "title": "๐Ÿ‘ค Gender", "enum": [ "", "men", "women" ], "type": "string", "description": "Restrict to men's/unisex or women's watches.", "default": "" }, "includedAccessories": { "title": "๐Ÿ“ฆ Box & papers", "type": "array", "description": "Only listings that include the original box and/or papers โ€” the biggest single driver of resale value.", "items": { "type": "string", "enum": [ "box", "papers" ], "enumTitles": [ "๐Ÿ“ฆ Original box", "๐Ÿ“œ Original papers" ] } }, "dealerCountries": { "title": "๐ŸŒ Dealer country", "type": "array", "description": "Only listings from dealers in these countries (ISO codes).", "items": { "type": "string", "enum": [ "US", "UK", "DE", "IT", "CH", "FR", "ES", "NL", "AT", "BE", "SE", "PL", "CZ", "RO", "CA", "AU", "ZA", "JP", "HK", "SG", "AE" ], "enumTitles": [ "United States", "United Kingdom", "Germany", "Italy", "Switzerland", "France", "Spain", "Netherlands", "Austria", "Belgium", "Sweden", "Poland", "Czech Republic", "Romania", "Canada", "Australia", "South Africa", "Japan", "Hong Kong", "Singapore", "UAE" ] } }, "dealersOnly": { "title": "๐Ÿฌ Professional dealers only", "type": "boolean", "description": "Exclude private sellers and keep only commercial dealers.", "default": false }, "listedSince": { "title": "๐Ÿ†• Listed within", "enum": [ "", "1", "3", "7", "28" ], "type": "string", "description": "Only listings published recently โ€” the fastest way to catch new stock.", "default": "" }, "sortBy": { "title": "โ†•๏ธ Sort by", "enum": [ "relevance", "newest", "price_asc" ], "type": "string", "description": "Order the results Chrono24 returns.", "default": "relevance" }, "includeDetails": { "title": "๐Ÿ”ฌ Fetch full details", "type": "boolean", "description": "Fetch each listing's page for reference number, year, movement, caliber, jewels, power reserve, materials, water resistance, condition and return policy. Turn off for the fastest, cheapest runs.", "default": true }, "compact": { "title": "๐Ÿ“ฆ Compact records", "type": "boolean", "description": "Emit only the core fields (brand, model, reference, year, condition, price, dealer, URL). Ideal for AI agents and MCP clients.", "default": false }, "excludeEmptyFields": { "title": "๐Ÿงน Drop empty fields", "type": "boolean", "description": "Remove null, empty-string and empty-array fields from each record.", "default": false }, "detailConcurrency": { "title": "โšก Detail concurrency", "minimum": 1, "maximum": 12, "type": "integer", "description": "How many listing pages to fetch at once. Lower this if the site starts refusing requests.", "default": 6 }, "incrementalMode": { "title": "โ™ป๏ธ Incremental mode", "type": "boolean", "description": "Track state between runs and tag every listing with a changeType (NEW / UPDATED / UNCHANGED / EXPIRED). A price change marks a listing UPDATED.", "default": false }, "stateKey": { "title": "๐Ÿ—๏ธ State key", "type": "string", "description": "Stable name for the tracked search. Leave empty to derive one automatically from your search settings." }, "emitUnchanged": { "title": "๐Ÿ” Include unchanged listings", "type": "boolean", "description": "Also emit listings that have not changed since the previous run.", "default": false }, "emitExpired": { "title": "๐Ÿ—‘๏ธ Include sold / removed listings", "type": "boolean", "description": "Emit records for listings present last run but gone now โ€” i.e. sold or withdrawn.", "default": false }, "telegramToken": { "title": "๐Ÿ’ฌ Telegram bot token", "type": "string", "description": "Bot token from @BotFather." }, "telegramChatId": { "title": "๐Ÿ†” Telegram chat ID", "type": "string", "description": "Chat or channel ID, e.g. \"-100123456789\" or \"@yourchannel\"." }, "slackWebhookUrl": { "title": "๐Ÿ’ผ Slack webhook URL", "type": "string", "description": "Slack incoming-webhook URL." }, "discordWebhookUrl": { "title": "๐ŸŽฎ Discord webhook URL", "type": "string", "description": "Discord incoming-webhook URL." }, "webhookUrl": { "title": "๐Ÿช Webhook URL", "type": "string", "description": "Any HTTPS endpoint. Receives a JSON POST with the matched listings โ€” works with n8n, Make and Zapier." }, "webhookHeaders": { "title": "๐Ÿงพ Webhook headers", "type": "object", "description": "Extra headers for the webhook request, e.g. {\"Authorization\": \"Bearer xyz\"}." }, "notificationLimit": { "title": "๐Ÿ”ข Listings per notification", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many listings to include in each notification message.", "default": 5 }, "proxyConfiguration": { "title": "๐ŸŒ Proxy configuration", "type": "object", "description": "Leave this on. Chrono24 refuses requests from unproxied cloud IPs, so runs need Apify Proxy; the default datacenter group is the cheapest that works. Switch to RESIDENTIAL only if runs start being refused.", "default": { "useApifyProxy": true } }, "maxRequestRetries": { "title": "๐Ÿ”„ Max request retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many times to retry a refused request before giving up. Each retry moves to a fresh proxy IP, so a higher number rides out a bad IP.", "default": 6 } } }, "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 } } } } } } } } } }