# Catawiki Instant Scraping API Documentation The Catawiki Instant Scraping API provides real-time access to auction data from the Catawiki platform. With powerful endpoints for lot search, detailed lot information, bid history, and category navigation, it’s the perfect choice for developers, marketers, and researchers looking to integrate live auction insights into their applications. --- ## Table of Contents - [Authentication](#authentication) - [Endpoints](#endpoints) - [1. Lot Endpoints](#1-lot-endpoints) - [2. Category Endpoints](#2-category-endpoints) - [3. Auction Endpoints](#3-auction-endpoints) - [4. Additional Lot Endpoints](#4-additional-lot-endpoints) - [Error Handling](#error-handling) - [Example Requests](#example-requests) - [Support](#support) --- ## Authentication To access the API, include the following headers in every HTTP request: - **X-RapidAPI-Host**: `catawiki-scraping.p.rapidapi.com` - **X-RapidAPI-Key**: `your_api_key` These headers ensure your requests are authenticated and allow us to monitor your API usage. --- ## Endpoints ### 1. Lot Endpoints #### GET `/lots/search` - **Description**: Searches for lots based on a query term. - **Parameters**: - `query` (required, query): The search term. - `page` (optional, query, default: 1): Page number. - `language` (optional, query, default: "en"): Response language.

Show Example Response

```json { "lots": [ { "id": 93645331, "title": "Hermès - Kelly watch - No Reserve Price - 689794 - Women - 1990-1999", "originalImageUrl": "https://assets.catawiki.nl/assets/2025/2/10/9/6/a/96ac02d5-db99-45f1-8953-616d5bb3c5ac.jpg", "url": "https://www.catawiki.com/en/l/93645331-hermes-kelly-watch-no-reserve-price-689794-women-1990-1999", "auctionId": 1096473, "isContentExplicit": false, "reservePriceSet": false, "biddingStartTime": "2025-02-11T17:00:00+00:00", "bidding_start_time": "2025-02-11T17:00:00+00:00", "buyNow": {"price_eur": 736} }, { "id": 93499573, "title": "Louis Poulsen - Hanging lamp - PH5 - Metal", "url": "https://www.catawiki.com/en/l/93499573-louis-poulsen-hanging-lamp-ph5-metal", "auction_id": 1079735, "original_image_url": "https://assets.catawiki.nl/assets/2024/11/13/a/d/b/adbcfea8-ad87-4ac8-bf5e-123e67240064.jpg" }, ..., { "id": 93494384, "title": "Signed Japan Wooden Noh Mask of Sakagami 能面逆髮 (with mask bag) - Sculpture Wood - Japan (No Reserve Price)", "url": "https://www.catawiki.com/en/l/93494384-signed-japan-wooden-noh-mask-of-sakagami-with-mask-bag-sculpture-wood-japan-no-reserve-price", "auction_id": 1084752, "original_image_url": "https://assets.catawiki.nl/assets/2025/2/2/0/3/c/03c6b60c-9d65-40b8-b878-a6b627f10362.jpg" }, { "id": 93572162, "title": "2022/23 Panini Prizm Premier League Erling Haaland, Look for autographs! 24 packs per box, 4 cards per pack - 1 Sealed box - Near Mint (NM)", "url": "https://www.catawiki.com/en/l/93572162-2022-23-panini-prizm-premier-league-erling-haaland-look-for-autographs-24-packs-per-box-4-cards-per-pack-1-sealed-box-near-mint-nm", "auction_id": 1086118, "original_image_url": "https://assets.catawiki.nl/assets/2024/3/5/3/c/d/3cd7d1be-a1dc-4138-bf32-0ff295b0c9d0.jpg" } ], "meta": {"total": 500, "total_pages": 25, "page": 2} } ```

--- #### GET `/lots/popular` - **Description**: Retrieves popular (or featured) lots. - **Parameters**: - `page` (optional, query, default: 1): Page number. - `language` (optional, query, default: "en"): Response language.

Show Example Response

```json { "lots": [ { "id": 93672132, "title": "Filippos Furs King Size - Black Rex Chinchilla - Blanket - 230 cm - 230 cm", "url": "https://www.catawiki.com/en/l/93672132-filippos-furs-king-size-black-rex-chinchilla-blanket-230-cm-230-cm", "auction_id": 1092209, "original_image_url": "https://assets.catawiki.nl/assets/2025/1/20/1/3/1/131baad9-b827-4f6f-9e3b-46eb5432b1da.jpg" }, { "id": 93391570, "title": "1 pcs Blue Sapphire - 2.05 ct - Antwerp Laboratory for Gemstone Testing (ALGT)", "url": "https://www.catawiki.com/en/l/93391570-1-pcs-blue-sapphire-2-05-ct-antwerp-laboratory-for-gemstone-testing-algt", "auction_id": 1090821, "original_image_url": "https://assets.catawiki.nl/assets/2021/2/10/3/9/c/39c723b1-8e31-4838-94d2-98dd25321157.jpg" }, ..., { "id": 93572162, "title": "2022/23 Panini Prizm Premier League Erling Haaland, Look for autographs! 24 packs per box, 4 cards per pack - 1 Sealed box - Near Mint (NM)", "url": "https://www.catawiki.com/en/l/93572162-2022-23-panini-prizm-premier-league-erling-haaland-look-for-autographs-24-packs-per-box-4-cards-per-pack-1-sealed-box-near-mint-nm", "auction_id": 1086118, "original_image_url": "https://assets.catawiki.nl/assets/2024/3/5/3/c/d/3cd7d1be-a1dc-4138-bf32-0ff295b0c9d0.jpg" } ], "meta": {"total": 500, "total_pages": 25, "page": 2} } ```

--- #### GET `/lots/{lot_id}/details` - **Description**: Returns detailed information for a specific lot. - **Parameters**: - `lot_id` (required, path): Lot ID. - `language` (optional, query, default: "en"): Response language.

Show Example Response

```json { "highest_bidder_token": "e26baa40962bfa9a9386c064ba53bb0b7d861fb0", "winner_token": "e26baa40962bfa9a9386c064ba53bb0b7d861fb0", "current_bid_amount": {"EUR": 140.0, "USD": 145.0, "GBP": 117.0}, "bidding_start_time": "2025-02-07T11:00:00Z", "bidding_end_time": "2025-02-12T18:44:20Z", "reserve_price_met": null, "favorite_count": 50, "closed": true, "id": 93509152, "is_buy_now_available": false, "title": "Citizen - Solar - Eco-Drive - Gold - 240 Days Power Reserve - No Reserve Price - Men - New", "thumbnail2_url": "https://assets.catawiki.nl/assets/2024/11/5/6/1/a/thumb2_61a768de-6cff-4758-b352-15dda5d24cba.jpg", "url": "https://www.catawiki.com/en/l/93509152-citizen-solar-eco-drive-gold-240-days-power-reserve-no-reserve-price-men-new", "explicit_content": false, "original_image_url": "https://assets.catawiki.nl/assets/2024/11/5/6/1/a/61a768de-6cff-4758-b352-15dda5d24cba.jpg", "specifications": [ {"specificationId": 1205, "valueId": 153411, "name": "Era", "value": "After 2000"}, {"specificationId": 909, "valueId": 60269, "name": "Brand", "value": "Citizen"}, ..., {"specificationId": 966, "valueId": null, "name": "Model", "value": "Solar - Eco-Drive - Gold - 240 Days Power Reserve"}, {"specificationId": 926, "valueId": 60038, "name": "Gender", "value": "Men"}, {"specificationId": 998, "valueId": 61727, "name": "Movement", "value": "Quartz"}, {"specificationId": 932, "valueId": 60020, "name": "Case material", "value": "Steel"}, {"specificationId": 914, "valueId": 77971, "name": "Condition", "value": "Unworn"} ], "sellerInfo": { "id": 5289227, "url": "https://www.catawiki.com/en/u/5289227-luxury-watches", "address": {"country": {"name": "The Netherlands", "shortCode": "nl"}}, "score": {"score": 99.81, "positiveCount": 1549, "negativeCount": 3, "neutralCount": 77, "lifetimeCount": 6114}, "profile": {"text": "All products are new.\n\n , You can always contact us for questions.", "automatedTranslation": true}, "sellerName": "Luxury-watches", "userName": "Luxury-watches", "isPro": true, "isTop": true, "sellerTermsUrl": null, "createdAt": "2017-09-15T10:49:26Z", "legalEntity": null }, "description": "New. \n\nWe are a professional jeweler company that only sells new, exclusive products. ..." } ```

--- #### GET `/lots/{lot_id}/bids` - **Description**: Retrieves the bid history for a given lot. - **Parameters**: - `lot_id` (required, path): Lot ID. - `currency_code` (optional, query, default: "EUR"): Currency code. - `page` (optional, query, default: 1): Page number. - `language` (optional, query, default: "en"): Response language.

Show Example Response

```json { "bids": [ { "amount": 140.0, "currency_code": "EUR", "bidder": {"name": "Bidder 5684", "token": "e26baa40962bfa9a9386c064ba53bb0b7d861fb0", "country_code": "pt"}, "from_order": false, "explanation_type": null, "created_at": "2025-02-12T18:43:06Z" }, { "amount": 130.0, "currency_code": "EUR", "bidder": {"name": "Bidder 7291", "token": "af8951d8ad941ffd4add8894a64a9d1471c2cd51", "country_code": "hu"}, "from_order": false, "explanation_type": null, "created_at": "2025-02-12T18:42:12Z" }, ..., { "amount": 2.0, "currency_code": "EUR", "bidder": {"name": "Bidder 2804", "token": "4bfb313d1f77e5bfa3cd55f050f08397a3f37e09", "country_code": "it"}, "from_order": false, "explanation_type": null, "created_at": "2025-02-07T20:18:03Z" }, { "amount": 1.0, "currency_code": "EUR", "bidder": {"name": "Bidder 2546", "token": "f6bb59389ee5336f979834490795a62618bdd895", "country_code": "pl"}, "from_order": false, "explanation_type": null, "created_at": "2025-02-07T12:18:20Z" } ], "meta": {"total": 24, "page": 1, "total_pages": 1} } ```

--- #### GET `/lots/{lot_id}/extra` - **Description**: Retrieves additional information for a lot (e.g., shipping details and buyer commission). - **Parameters**: - `lot_id` (required, path): Lot ID. - `currency_code` (optional, query, default: "EUR"): Currency code. - `language` (optional, query, default: "en"): Response language.

Show Example Response

```json { "rates": [ {"region_code": "at", "region_name": "Austria", "price": 19.99, "currency_code": "EUR"}, {"region_code": "us", "region_name": "United States", "price": 24.95, "currency_code": "EUR"}, ..., {"region_code": "europe", "region_name": "Rest of Europe", "price": 24.95, "currency_code": "EUR"}, {"region_code": "world", "region_name": "Anywhere else", "price": 24.95, "currency_code": "EUR"} ], "payment_methods": [ {"name": "mastercard", "label": "MasterCard", "is_promoted": null}, {"name": "visa", "label": "Visa", "is_promoted": null}, {"name": "apple_pay", "label": "Apple Pay", "is_promoted": null}, {"name": "google_pay", "label": "Google Pay", "is_promoted": null}, {"name": "paypal", "label": "PayPal", "is_promoted": null}, {"name": "sepa_credit_transfer", "label": "Bank transfer", "is_promoted": null} ], "combined_shipping_allowed": true, "extra_insurance": true, "is_pickup_preferable": false, "is_pickup_only": false, "pickup_location": null, "buyer_commission": {"currency_code": "EUR", "variable": {"percentage": 9.0}, "fixed": {"amount": 3.0}} } ```

--- ### 2. Category Endpoints #### GET `/categories/main` - **Description**: Retrieves the main categories. - **Parameters**: - `language` (optional, query, default: "en"): Response language.

Show Example Response

```json { "categories": [ { "id": 863, "url": "https://www.catawiki.com/en/c/863-archaeology-natural-history", "name": "Archaeology & Natural History", "code_name": "archaeologyAndNaturalHistory", "auction_count": 65, "image_url": "https://assets.catawiki.nl/assets/categories/863-bd12df0604bca0a6c2b40157d4151eafb53c6499-original.jpg" }, ..., { "id": 720, "url": "https://www.catawiki.com/en/c/720-wine-whisky-spirits", "name": "Wine, Whisky & Spirits", "code_name": "wineWhiskyAndSpirits", "auction_count": 174, "image_url": "https://assets.catawiki.nl/assets/categories/720-b259e51185df6466fecca2d5556c9fc8f00d3c9f-original.jpg" } ] } ```

--- #### GET `/categories/{category_id}/subcategories` - **Description**: Retrieves the subcategories for a given category. - **Parameters**: - `category_id` (required, path): Category ID. - `language` (optional, query, default: "en"): Response language.

Show Example Response

```json [ {"title": "LEGO", "id": "1461"}, {"title": "Model Cars", "id": "379"}, {"title": "Model Trains", "id": "387"}, {"title": "Toys", "id": "723"}, {"title": "Video Games & Computers", "id": "365"} ] ```

--- #### GET `/categories/popular` - **Description**: Retrieves popular categories. - **Parameters**: - `language` (optional, query, default: "en"): Response language.

Show Example Response

```json { "category_ids": [597, 961, 387, 437, 1293, 971, 443, 1117] } ```

--- ### 3. Auction Endpoints #### GET `/auctions/popular` - **Description**: Retrieves a list of popular auctions. - **Parameters**: - `page` (optional, query, default: 1): Page number. - `language` (optional, query, default: "en"): Response language.

Show Example Response

```json { "auction_ids": [1093411, 1085359, 1080380, 1096743, 1089118, 1087078, 1097714, 1098625, 1080598, 1096312] } ```

--- ### 4. Additional Lot Endpoints #### GET `/lots/fromSeller` - **Description**: Retrieves all lots for a specific seller. - **Parameters**: - `seller_id` (required, query): Seller ID. - `page` (optional, query, default: 1): Page number. - `language` (optional, query, default: "en"): Response language.

Show Example Response

```json { "total": 1, "lots": [ { "id": 93380749, "title": "Other brand - Deux de Delvaux - Handbag", "originalImageUrl": "https://assets.catawiki.nl/assets/2025/1/27/3/b/d/3bd823e3-7ffc-4778-afec-e7157c302b12.jpg", "url": "https://www.catawiki.com/en/l/93380749-other-brand-deux-de-delvaux-handbag", "auctionId": 1093269, "isContentExplicit": false, "reservePriceSet": true, "biddingStartTime": "2025-02-12T11:00:00+00:00", "buyNow": null, "seller": {"country_code": "be", "shop_name": "georges1946"} } ] } ```

--- #### GET `/lots/fromCategory` - **Description**: Retrieves lots from a specific category. - **Parameters**: - `category_id` (required, query): Category ID. - `page` (optional, query, default: 1): Page number. - `language` (optional, query, default: "en"): Response language.

Show Example Response

```json { "lots": [ { "id": 93572134, "title": "Grandi Moto da Collezione 1:24 - Model motorcycle (60)", "originalImageUrl": "https://assets.catawiki.nl/assets/2024/12/6/c/7/d/c7d6d320-2307-41a9-9910-8d939c26e36a.jpg", "url": "https://www.catawiki.com/en/l/93572134-grandi-moto-da-collezione-1-24-model-motorcycle-60", "auctionId": 1089728, "isContentExplicit": false, "reservePriceSet": false, "biddingStartTime": "2025-02-07T11:00:00+00:00", "bidding_start_time": "2025-02-07T11:00:00+00:00", "buyNow": null }, { "id": 93531820, "title": "1:43 - Model kit (16) - Voitures des chefs d'état", "originalImageUrl": "https://assets.catawiki.nl/assets/2025/2/4/6/6/6/6661f755-fe0f-4a02-8988-d8b0b523ca0b.jpg", "url": "https://www.catawiki.com/en/l/93531820-1-43-model-kit-16-voitures-des-chefs-d-etat", "auctionId": 1089728, "isContentExplicit": false, "reservePriceSet": false, "biddingStartTime": "2025-02-07T11:00:00+00:00", "bidding_start_time": "2025-02-07T11:00:00+00:00", "buyNow": null }, { "id": 93469972, "title": "1:43 - Model car (14) - city", "originalImageUrl": "https://assets.catawiki.nl/assets/2025/1/31/5/c/2/5c24ad2a-8df2-4262-b6ce-cfb4a6d44262.jpg", "url": "https://www.catawiki.com/en/l/93469972-1-43-model-car-14-city", "auctionId": 1089728, "isContentExplicit": false, "reservePriceSet": false, "biddingStartTime": "2025-02-07T11:00:00+00:00", "bidding_start_time": "2025-02-07T11:00:00+00:00", "buyNow": {"price_eur": 95} }, ..., { "id": 93486393, "title": "Lamborghini Raptor /Aventador Miura Homage 1:43 - Model car (2) - Design Giugiaro - Exotic Car", "originalImageUrl": "https://assets.catawiki.nl/assets/2025/2/4/8/3/6/836908eb-804a-4884-844e-8124e6ccfc6f.jpg", "url": "https://www.catawiki.com/en/l/93486393-lamborghini-raptor-aventador-miura-homage-1-43-model-car-2-design-giugiaro-exotic-car", "auctionId": 1089728, "isContentExplicit": false, "reservePriceSet": false, "biddingStartTime": "2025-02-07T11:00:00+00:00", "bidding_start_time": "2025-02-07T11:00:00+00:00", "buyNow": null } ], "meta": {"page": 1, "total_pages": 344, "total": 6863} } ```

--- #### GET `/lots/fromCollection` - **Description**: Retrieves lots from a specific collection. - **Parameters**: - `collection_id` (required, query): Collection ID. - `page` (optional, query, default: 1): Page number. - `language` (optional, query, default: "en"): Response language.

Show Example Response

```json { "lots": [ { "id": 93535708, "title": "Quiona+ (1987) - ‘The Street Mona Lisa’", "originalImageUrl": "https://assets.catawiki.nl/assets/2025/2/4/c/8/e/c8ec79b5-2614-441e-8845-1bcf4388c5b0.jpg", "url": "https://www.catawiki.com/en/l/93535708-quiona-1987-the-street-mona-lisa", "reservePriceSet": true, "auctionId": 1083214, "isContentExplicit": false, "biddingStartTime": "2025-02-07T11:00:00+00:00", "bidding_start_time": null, "buyNow": null, "reservePriceMet": true, "biddingEndTime": "2025-02-13T13:01:00+00:00", "highestBidderToken": "0faf76bf5d4a45f9c0e92520253cfb7242b610f8", "favoriteCount": 22, "winnerToken": "0faf76bf5d4a45f9c0e92520253cfb7242b610f8", "closeStatus": true }, { "id": 93429913, "title": "Sad monsters club / Jade Mouge - Le reflet et l'absence", "originalImageUrl": "https://assets.catawiki.nl/assets/2025/1/14/8/6/6/8668faed-16bf-4897-a48c-bf0bd471a641.jpg", "url": "https://www.catawiki.com/en/l/93429913-sad-monsters-club-jade-mouge-le-reflet-et-l-absence", "reservePriceSet": true, "auctionId": 1083214, "isContentExplicit": false, "biddingStartTime": "2025-02-07T11:00:00+00:00", "bidding_start_time": null, "buyNow": null, "reservePriceMet": false, "biddingEndTime": "2025-02-13T13:01:55+00:00", "highestBidderToken": "952281e4af5baa67e5339d1480506fde41521aed", "favoriteCount": 17, "winnerToken": null, "closeStatus": true }, ..., { "id": 93494091, "title": "Betty Rullo (1955) - Chalet", "originalImageUrl": "https://assets.catawiki.nl/assets/2025/2/2/6/e/3/6e3d598b-591e-40ff-b0d2-7110b584d32a.jpg", "url": "https://www.catawiki.com/en/l/93494091-betty-rullo-1955-chalet", "reservePriceSet": true, "auctionId": 1083214, "isContentExplicit": false, "biddingStartTime": "2025-02-07T11:00:00+00:00", "bidding_start_time": null, "buyNow": null, "reservePriceMet": false, "biddingEndTime": "2025-02-13T13:18:25+00:00", "highestBidderToken": "de9b6247b422c95ec89d175b5fb65f3d9d16a731", "favoriteCount": 16, "winnerToken": null, "closeStatus": true } ], "meta": {"page": 1, "total": 105, "total_pages": 6} } ```

--- #### GET `/lots/fromAuction` - **Description**: Retrieves lots associated with a specific auction. - **Parameters**: - `auction_id` (required, query): Auction ID. - `page` (optional, query, default: 1): Page number. - `language` (optional, query, default: "en"): Response language.

Show Example Response

```json { "lots": [ { "id": 93500167, "title": "Uberti, Magnificentia Saten - Franciacorta - 6 Bottles (0.75L)", "originalImageUrl": "https://assets.catawiki.nl/assets/2025/2/2/f/7/c/f7c03e02-5fb7-43fa-81a7-5b4a24c57bdc.jpg", "url": "https://www.catawiki.com/en/l/93500167-uberti-magnificentia-saten-franciacorta-6-bottles-0-75l", "auctionId": 1098002, "isContentExplicit": false, "reservePriceSet": false, "biddingStartTime": null, "bidding_start_time": null, "buyNow": null }, { "id": 93517036, "title": "2019 Nervi Conterno Gattinara - Piedmont - 6 Bottles (0.75L)", "originalImageUrl": "https://assets.catawiki.nl/assets/2025/2/3/2/f/3/2f3660df-538e-49ca-82a8-d098974e5cb4.jpg", "url": "https://www.catawiki.com/en/l/93517036-2019-nervi-conterno-gattinara-piedmont-6-bottles-0-75l", "auctionId": 1098002, "isContentExplicit": false, "reservePriceSet": false, "biddingStartTime": null, "bidding_start_time": null, "buyNow": null }, ..., { "id": 93558275, "title": "2000 Marisa Fenocchio - Barolo - 5 Bottles (0.75L)", "originalImageUrl": "https://assets.catawiki.nl/assets/2025/1/12/8/4/b/84b793d1-efd9-49ec-a90c-d48e4f601577.jpg", "url": "https://www.catawiki.com/en/l/93558275-2000-marisa-fenocchio-barolo-5-bottles-0-75l", "auctionId": 1098002, "isContentExplicit": false, "reservePriceSet": false, "biddingStartTime": null, "bidding_start_time": null, "buyNow": null } ], "meta": {"page": 1, "total_pages": 6, "total": 119} } ```

--- ## Error Handling The API returns standard HTTP status codes to indicate errors: - **400 Bad Request**: The request is malformed or required parameters are missing. - **403 Forbidden**: Unauthorized access (invalid or missing API key). - **404 Not Found**: The requested resource could not be found. - **429 Too Many Requests**: The rate limit has been exceeded. - **5XX Server Errors**: An internal server error has occurred. Error responses include an object detailing the error message and error code to help diagnose issues. --- ## Example Requests ### Example with cURL #### Searching for Lots ```bash curl --request GET "https://catawiki-scraping.p.rapidapi.com/lots/search?query=antiquity&page=1&language=en" \ --header "X-RapidAPI-Host: catawiki-scraping.p.rapidapi.com" \ --header "X-RapidAPI-Key: your_api_key" ``` #### Retrieving Lot Details ```bash curl --request GET "https://catawiki-scraping.p.rapidapi.com/lots/12345/details?language=en" \ --header "X-RapidAPI-Host: catawiki-scraping.p.rapidapi.com" \ --header "X-RapidAPI-Key: your_api_key" ``` --- ## Support For any questions or technical assistance, please contact our support team: - **Email**: support@catawiki-scraping.com - **Discord**: [Join our Discord server](https://discord.gg/yourDiscordLink) --- This documentation provides all the necessary information to integrate and effectively use the Catawiki Instant Scraping API. Please check back regularly for updates.