---

⌚ Chrono24 Scraper

A fast and reliable web scraper for extracting luxury watch listings from Chrono24. It supports pagination, anti-bot handling, and flexible input modes (brand or custom URLs).

---

🚀 Features

• Fetches listings through Chrono24's signed mobile JSON API (fast, no browser)
• Supports brand-based or custom URL scraping
• Pagination support (multi-page crawling)
• Deduplication of items
• Stealth-browser fallback pipeline if the API is unavailable
• Free / paid usage limits
• Structured JSON output

---

📥 Input

The scraper accepts the following input parameters:

Example input

{
  "brand": "rolex",
  "maxItems": 100,
  "startUrls": [
    {
      "url": "https://www.chrono24.com/search/index.htm?dosearch=true&query=siemens"
    }
  ]
}

---

Input fields

brand (optional)

• Type: string
• Default: "rolex"
• Watch brand used to generate search pages

---

startUrls (optional)

• Type: array
• Custom URLs to scrape instead of brand search
• If provided, overrides brand
• Search filters in the URLs (query, priceFrom, priceTo, condition, …) are mapped to equivalent API parameters

Example:

"startUrls": [
  {
    "url": "https://www.chrono24.com/search/index.htm?query=omega"
  }
]

---

maxItems (optional)

• Type: integer
• Default: 100
• Maximum number of items to scrape

---

maxPages (optional)

• Type: integer
• Default: 0
• Stop after this many listing pages per start URL (0 = no limit)

---

sortOrder (optional)

• Type: integer
• Default: 0
• Result ordering: 0 relevance, 1 price ascending, 11 price descending, 5 newest, 15 popularity

---

📤 Output

The scraper outputs structured JSON data for each watch listing.

---

Example output

{
  "id": "47341084",
  "url": "https://www.chrono24.com/rolex/submariner-date-116610ln-40mm-black-ceramic-bezel-stainless-steel--id47341084.htm",
  "title": "Rolex Submariner Date",
  "description": "",
  "price": "11495.00 USD",
  "shipping_cost": "99.00 USD",
  "location": "United States of America",
  "image_url": "https://img.chrono24.com/images/uhren/47341084-cekfmwhjyn3daoa1oei5pflg-Square420.jpg",
  "is_popular": true,
  "scraped_at": "2026-08-23T12:54:06.274Z",
  "listing_status": "Available",
  "seller_type": "Dealer",
  "stock_info": "InStock"
}

Every item also contains the complete raw payload returned by the Chrono24 mobile API, including badge, subtitle, listingId, listingUrl, the full gallery in imageUrls, wishlist flags (isOnWishlist, isWishlistEnabled), and the raw objects under price_details, shipping_details and location_details (which include seller city). Any field Chrono24 adds to the API in the future is saved automatically.

The dataset ships with an output schema (.actor/dataset_schema.json), so results render as a table view with linked listings and product images in Apify Console.

---

Output fields

id

Unique listing identifier

url

Direct link to the watch listing

title

Watch title / model name

description

Short listing description (if available)

price

Listed price of the watch

shipping_cost

Shipping cost information (if available)

location

Seller location

image_url

Main product image URL

is_popular

Indicates promoted or highlighted listings (derived from the API badge field)

scraped_at

Timestamp of extraction

listing_status

Listing availability status from the API (e.g. Available)

seller_type

Seller type (Dealer or PrivateSeller)

stock_info

Stock information (e.g. InStock, New)

---

⚙️ How it works

1. Mobile API phase (default) – the actor replicates the request protocol of the official Chrono24 Android app: every request to https://chrono24.app/api/*.json carries an HMAC-SHA256 app-tag signature plus per-request nonce/time headers. These signed requests are validated at the edge and served JSON directly, with no browser and no Cloudflare challenge. Brand slugs are resolved to manufacturer IDs via the API, results are paginated (pageSize=100), and items are pushed as they arrive.
2. Stealth-browser fallback – if the API phase fails or yields nothing, the actor solves the Cloudflare challenge once in a Camoufox browser, harvests the cookies, then fetches remaining pages over fast HTTP; a full stealth-browser crawl is the last resort.
3. Stops when reaching:
   • maxItems limit
   • maxPages limit
   • last page of results

---

🧠 Use cases

• Market research for luxury watches
• Price tracking and comparison
• Data aggregation for ecommerce tools
• Investment analysis of watch models

---

⚠️ Notes

• Large datasets may require residential proxies for best performance
• Some listings may be missing optional fields (description, shipping, etc.)
• Pagination automatically stops when no more results are available