# Catawiki Scraper (`solidcode/catawiki-scraper`) Actor \[💰 $2.50 / 1K] Extract Catawiki auction lots — titles, current bids and currencies, bidding start/end times, reserve and buy-now status, seller, and images. Search by keyword and category or paste Catawiki search URLs. Built for collectors, dealers, and auction market research. - **URL**: https://apify.com/solidcode/catawiki-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** Automation, E-commerce, Developer tools - **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## Catawiki Scraper Pull live auction lots from Catawiki at scale — titles, multi-currency bids, bidding windows, reserve and buy-now status, verified seller details, full-resolution image galleries, and category data for art, watches, jewelry, classic cars, wine, coins, and every other Catawiki specialty. Built for collectors, resellers, and auction-market researchers who need structured Catawiki lot data without clicking through endless result pages by hand. ### Why This Scraper? - **Multi-currency live bids in one row** — every lot's `currentBid` is returned simultaneously in EUR, USD, and GBP, so you can compare across markets without converting anything yourself. - **~35 structured fields per lot** — including verified seller details (shop name, username, country) and the full-resolution image gallery, not just a single thumbnail. - **Live auction state on every lot** — bidding start and end timestamps, reserve-price-met flag, buy-now availability, close status (open/closed), and live favourite count. - **6 interface languages** — English, Dutch, German, French, Spanish, and Italian, controlling both the lot text returned and the locale context. - **3 sort modes for time-sensitive monitoring** — Best Match, Ending Soonest, and Newest, so you can catch lots in the final hours or track freshly listed objects. - **Paste any Catawiki URL** — drop in a search or category URL and every filter already in it (category, country, price band, sort) is honoured exactly as the website renders it. - **Unlimited results with automatic pagination** — set Max Results to 0 and the scraper walks every page of a result set until it runs out. - **Covers every Catawiki category** — art, watches, jewelry, classic cars, wine & whisky, coins & stamps, comics, antiques, and more, all through the same input. ### Use Cases **Auction Market Research** - Track closing prices and bid activity across watch, art, and jewelry categories - Compare current bids in EUR, USD, and GBP to spot cross-market arbitrage - Monitor how reserve prices and buy-now options affect bidding behaviour - Build datasets of lots by category for trend and demand analysis **Reseller & Dealer Sourcing** - Find undervalued lots ending soon with no reserve met - Surface buy-now-available lots for instant acquisition - Filter sourcing to a specific category by pasting its Catawiki URL - Compare seller shops and countries to identify reliable suppliers **Price & Auction Monitoring** - Watch lots in their final hours with the Ending Soonest sort - Alert on new lots in a niche by re-running a keyword search on a schedule - Track favourite counts as an early signal of bidding interest - Capture point-in-time snapshots of current bids for valuation models **Collection Valuation** - Pull comparable sold and active lots to value a private collection - Aggregate current bids across similar objects to estimate fair market value - Match lots by category and seller country for like-for-like comparisons **Lead Generation** - Build lists of active seller shops by category and country - Identify high-volume sellers worth approaching for partnerships - Capture seller usernames and shop URLs for outreach ### Getting Started #### Simple Keyword Search Just type what you're looking for: ```json { "searchQueries": ["rolex submariner"], "maxResults": 50 } ```` #### Multiple Keywords, Ending Soonest Run several searches in one go and prioritise lots about to close: ```json { "searchQueries": ["omega speedmaster", "tag heuer monaco"], "sortBy": "bidding_end_desc", "language": "en", "maxResults": 200 } ``` #### Paste a Filtered Catawiki URL Browse a category or apply price filters on Catawiki, then paste the URL — every filter in it is honoured: ```json { "searchUrls": [ "https://www.catawiki.com/en/s?q=art+deco+lamp&filters=current_bid_eur[max]=500" ], "language": "de", "maxResults": 100 } ``` ### Input Reference #### What to Scrape | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `searchQueries` | string\[] | `["rolex submariner"]` | Plain keywords to search Catawiki for, e.g. "art deco lamp". Each keyword runs its own search — no URL building needed. | | `searchUrls` | string\[] | `[]` | Paste Catawiki search or category URLs directly. Any filters already in the URL — keyword, category, country, price, sort — are honoured as-is. This is how you collect a whole category. | #### Search Filters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `sortBy` | select | `Best Match` | Order in which keyword-search results are collected: Best Match, Ending Soonest, or Newest. Applies to keyword searches only — pasted URLs keep the sort encoded in the URL. | #### Options | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `maxResults` | integer | `100` | Maximum lots to return across all keywords and URLs combined. Set to 0 for unlimited. Start with 20–50 to test, then increase. | | `language` | select | `English` | Language and locale for the Catawiki site and the returned lot text: English, Dutch, German, French, Spanish, or Italian. | ### Output Each lot is one flat row. Here's a representative result: ```json { "id": 92345678, "title": "Rolex - Submariner Date - 16610", "subtitle": "Men - 2002-2003", "description": "Stainless steel automatic dive watch with box and papers...", "url": "https://www.catawiki.com/en/l/92345678-rolex-submariner-date-16610", "auctionId": 4567890, "scrapedFromUrl": "rolex submariner", "currentBid": { "EUR": 6200, "USD": 6700, "GBP": 5300 }, "currentBidValue": 6200, "currentBidCurrency": "EUR", "biddingStartTime": "2026-05-30T10:00:00Z", "biddingEndTime": "2026-06-06T19:18:58Z", "reservePriceSet": true, "reservePriceMet": false, "isBuyNowAvailable": false, "buyNow": null, "closeStatus": "open", "favoriteCount": 47, "sellerId": 1234567, "sellerShopName": "Vintage Time Pieces", "sellerUserName": "vintagetime", "sellerUrl": "https://www.catawiki.com/en/u/1234567-vintagetime", "sellerCountry": "Italy", "thumbImageUrl": "https://assets.catawiki.com/image/thumb/example.jpg", "originalImageUrl": "https://assets.catawiki.com/image/full/example.jpg", "images": [ "https://assets.catawiki.com/image/full/example1.jpg", "https://assets.catawiki.com/image/full/example2.jpg" ], "categoryId": 343, "categoryName": "Rolex Watches", "categoryUrl": "https://www.catawiki.com/en/c/343-rolex-watches", "hasFreeShipping": false, "isContentExplicit": false, "localized": true, "translatedTitle": null, "translatedSubtitle": null } ``` #### Core Fields | Field | Type | Description | |-------|------|-------------| | `id` | number | Unique Catawiki lot identifier | | `title` | string | Lot title | | `subtitle` | string | Lot subtitle (often condition/era summary) | | `description` | string | Full lot description text | | `url` | string | Direct URL to the lot page | | `auctionId` | number | Parent auction identifier | | `scrapedFromUrl` | string | The keyword or URL this row originated from | #### Pricing & Bidding | Field | Type | Description | |-------|------|-------------| | `currentBid` | object | Current top bid in all three currencies: `{ EUR, USD, GBP }` | | `currentBidValue` | number | Current top bid in the locale currency | | `currentBidCurrency` | string | Currency code of `currentBidValue` | | `biddingStartTime` | string | When bidding opens (ISO 8601) | | `biddingEndTime` | string | When bidding closes (ISO 8601) | | `reservePriceSet` | boolean | Whether the lot has a reserve price | | `reservePriceMet` | boolean | Whether the reserve has been met | | `isBuyNowAvailable` | boolean | Whether a buy-now option is available | | `buyNow` | object | Buy-now details when present | | `closeStatus` | string | Auction state: `open` or `closed` | | `favoriteCount` | number | Live count of users who favourited the lot | #### Seller | Field | Type | Description | |-------|------|-------------| | `sellerId` | number | Seller identifier | | `sellerShopName` | string | Seller shop / display name | | `sellerUserName` | string | Seller username | | `sellerUrl` | string | URL to the seller's Catawiki profile | | `sellerCountry` | string | Country the seller ships from | #### Images & Media | Field | Type | Description | |-------|------|-------------| | `thumbImageUrl` | string | Thumbnail image URL | | `originalImageUrl` | string | Primary full-size image URL | | `images` | string\[] | All full-resolution image URLs for the lot | #### Category & Flags | Field | Type | Description | |-------|------|-------------| | `categoryId` | number | Catawiki category identifier | | `categoryName` | string | Readable category name (e.g. "Rolex Watches") | | `categoryUrl` | string | URL to the lot's category page | | `hasFreeShipping` | boolean | Whether the lot ships for free | | `isContentExplicit` | boolean | Adult/explicit-content flag | | `localized` | boolean | Whether the text is localized to the requested language | | `translatedTitle` | string | Machine-translated title when the locale differs | | `translatedSubtitle` | string | Machine-translated subtitle when the locale differs | ### Tips for Best Results - **Start small** — set Max Results to 20–50 on your first run to confirm the data matches your needs, then scale up. - **Paste a filtered Catawiki URL to scope precisely** — apply a price band or category filter on the Catawiki website, copy the resulting URL into Search URLs, and the scraper reproduces that exact view. This is the most powerful way to narrow large categories. - **Use Ending Soonest for time-sensitive sourcing** — pair the Ending Soonest sort with a keyword to surface lots in their final hours, ideal for last-minute bidding decisions. - **Read `currentBid` directly for cross-market comparison** — it already carries EUR, USD, and GBP side by side, so there's no need to convert `currentBidValue` yourself. - **Combine keywords and URLs in one run** — mix plain keyword searches with pasted category URLs; results are merged and counted against a single Max Results cap. - **Set Max Results to 0 for a full sweep** — when you need an entire category or search, leave the cap at 0 and the scraper paginates to the end on its own. - **Match the language to your audience** — switching Language re-runs the search in that locale, so titles and descriptions come back in the language your team or models expect. ### Pricing **From $2.50 per 1,000 results** — among the most affordable Catawiki lot extractors on the market. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier. | Results | No discount | Bronze | Silver | Gold | |---------|-------------|--------|--------|------| | 100 | $0.30 | $0.28 | $0.265 | $0.25 | | 1,000 | $3.00 | $2.80 | $2.65 | $2.50 | | 10,000 | $30.00 | $28.00 | $26.50 | $25.00 | | 100,000 | $300.00 | $280.00 | $265.00 | $250.00 | A "result" is one auction lot row in the output dataset. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee. Platform fees depend on your Apify plan. ### Integrations Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via: - **Zapier** / **Make** / **n8n** — Workflow automation - **Google Sheets** — Direct spreadsheet export - **Slack** / **Email** — Notifications on new results - **Webhooks** — Trigger custom APIs on run completion - **Apify API** — Full programmatic access ### Legal & Ethical Use This actor is designed for legitimate auction-market research, sourcing, valuation, and analysis. Users are responsible for complying with applicable laws and Catawiki's Terms of Service. Do not use extracted data for spam, harassment, or any unlawful purpose, and handle any personal data (such as seller details) in line with applicable privacy regulations. # Actor input Schema ## `searchQueries` (type: `array`): Type what you're looking for, e.g. 'rolex submariner' or 'art deco lamp'. Each keyword runs its own search — no need to build a URL. Leave empty if you only use Search URLs below. ## `searchUrls` (type: `array`): Paste Catawiki search or category URLs directly (e.g. https://www.catawiki.com/en/s?q=rolex). Any filters already in the URL — keyword, category, country, sort — are honored as-is. To collect a whole category, open it on Catawiki and paste its URL here. The Sort setting below does NOT apply to pasted URLs. ## `sortBy` (type: `string`): Order in which Search Keywords results are collected. Only applies to Search Keywords — ignored for pasted Search URLs (those keep the sort encoded in the URL). ## `maxResults` (type: `integer`): Maximum number of lots to return across all keywords and URLs combined. Set to 0 for unlimited. Tip: start with 20-50 to test, then increase. ## `language` (type: `string`): Language and locale for the Catawiki site and the returned lot text. ## Actor input object example ```json { "searchQueries": [ "rolex submariner" ], "searchUrls": [], "sortBy": "best_match_desc", "maxResults": 100, "language": "en" } ``` # Actor output Schema ## `overview` (type: `string`): Table of scraped auction lots with title, current bid, bidding end time, and link. # 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 = { "searchQueries": [ "rolex submariner" ], "searchUrls": [], "sortBy": "best_match_desc", "maxResults": 100, "language": "en" }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/catawiki-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 = { "searchQueries": ["rolex submariner"], "searchUrls": [], "sortBy": "best_match_desc", "maxResults": 100, "language": "en", } # Run the Actor and wait for it to finish run = client.actor("solidcode/catawiki-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 '{ "searchQueries": [ "rolex submariner" ], "searchUrls": [], "sortBy": "best_match_desc", "maxResults": 100, "language": "en" }' | apify call solidcode/catawiki-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/catawiki-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Catawiki Scraper", "description": "[💰 $2.50 / 1K] Extract Catawiki auction lots — titles, current bids and currencies, bidding start/end times, reserve and buy-now status, seller, and images. Search by keyword and category or paste Catawiki search URLs. Built for collectors, dealers, and auction market research.", "version": "1.0", "x-build-id": "6IgtYKRdyMvMCRuWc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~catawiki-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-catawiki-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/solidcode~catawiki-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-catawiki-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/solidcode~catawiki-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-catawiki-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": { "searchQueries": { "title": "Search Keywords", "type": "array", "description": "Type what you're looking for, e.g. 'rolex submariner' or 'art deco lamp'. Each keyword runs its own search — no need to build a URL. Leave empty if you only use Search URLs below.", "items": { "type": "string" } }, "searchUrls": { "title": "Search URLs", "type": "array", "description": "Paste Catawiki search or category URLs directly (e.g. https://www.catawiki.com/en/s?q=rolex). Any filters already in the URL — keyword, category, country, sort — are honored as-is. To collect a whole category, open it on Catawiki and paste its URL here. The Sort setting below does NOT apply to pasted URLs.", "items": { "type": "string" } }, "sortBy": { "title": "Sort Results By", "enum": [ "best_match_desc", "bidding_end_desc", "published_at_desc" ], "type": "string", "description": "Order in which Search Keywords results are collected. Only applies to Search Keywords — ignored for pasted Search URLs (those keep the sort encoded in the URL).", "default": "best_match_desc" }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of lots to return across all keywords and URLs combined. Set to 0 for unlimited. Tip: start with 20-50 to test, then increase.", "default": 100 }, "language": { "title": "Language", "enum": [ "en", "nl", "de", "fr", "es", "it" ], "type": "string", "description": "Language and locale for the Catawiki site and the returned lot text.", "default": "en" } } }, "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 } } } } } } } } } } ```