Catawiki Scraper & Opportunity Notification

Pricing

Rating

Developer

Actor stats

Categories

Share

Actor Description

This Apify Actor is an advanced tool for the comprehensive scraping and monitoring of all information returned by the Catawiki platform. The software does not only identify buying opportunities but also extracts and saves every available metadata field for the lots viewed into the dataset, allowing for deep catalog analysis.

The algorithm analyzes lots at a specific filtered URL, evaluates current bids and remaining time, and can send an email notification via the Resend service if opportunities matching the user's price and deadline criteria are identified.

Core Functionality

The algorithm performs the following steps:

• Full Scraping Extraction: Navigates through result pages and extracts the entire data object containing all technical specifications, descriptions, and metadata for every lot.
• Filtering & Notification: If the enableNotification flag is active, it compares the current price with maxPrice and the remaining time with minituesToEnd. If your criteria match it'll send a notification mail with matching object (image, direct link to bid). Don't miss out on a bargain!
• Storage: Saves all extracted data into the Apify dataset for all objects. Download JSON, CSV, XML, Excel, HTML Table, RSS, JSONL.

Input Parameters

Extracted Data (Scraping)

The Actor saves all information returned by the Catawiki server for each lot into the dataset, including:

• Identifiers: Lot ID and full title.
• Auction Details: Current price (bid), minimum bid, start time, and end time.
• Media: Image URLs (thumbImageUrl) and direct links.
• Application Logic: The shouldBuy flag indicating if the lot passed the set filters and can indentify as a Opportunity.
• Enable Nofitifcation flag: The enableNotification parameter used during the run. If enableNotification = False, shouldBuy can be ignored.

Technical Notes

• Anti-Ban: Uses proxies and random delays between requests to simulate human behavior.
• Dataset: Even if notifications are disabled, the Actor functions as a full scraper, populating the dataset with all discovered lots based on url.

Scraper Output for a buy opportunity ("shouldBuy": true):

[
{
"id":103689247,
"title":"Omega - 14K Solid Gold Ultra Thin cal. 600 - Senza prezzo di riserva - 131.004-SC-62 - Uomo - 1962",
"subtitle":"Carica manuale - Oro giallo",
"thumbImageUrl":"https://assets.catawiki.nl/assets/2026/5/7/8/8/1/thumb2_8815b163-4b4c-43b9-82bc-242ad49546fa.jpg",
"originalImageUrl":"https://assets.catawiki.nl/assets/2026/5/7/8/8/1/8815b163-4b4c-43b9-82bc-242ad49546fa.jpg",
"favoriteCount":0,
"url":"https://www.catawiki.com/it/l/103689247-omega-14k-solid-gold-ultra-thin-cal-600-senza-prezzo-di-riserva-131-004-sc-62-uomo-1962",
"localized":true,
"translatedTitle":null,
"translatedSubtitle":null,
"auctionId":1227948,
"pubnubChannel":"CWAUCTION-production-1227948",
"useRealtimeMessageFallback":false,
"use_realtime_message_fallback":false,
"isContentExplicit":false,
"reservePriceSet":false,
"biddingStartTime":"2026-05-12T10:00:00.000Z",
"bidding_start_time":"2026-05-12T10:00:00+00:00",
"buyNow":null,
"hasFreeShipping":false,
"isVectorSearchResult":false,
"description":null,
"sellerId":null,
"sellerShopName":null,
"live":null,
"liveLot":{
"id":103689247,
"reservePriceMet":null,
"bid":{
"EUR":1400,
"GBP":1,
"USD":1
},
"biddingStartTime":1778580000000,
"biddingEndTime":1779127800000,
"highestBidderToken":"9d5bc2ee10549800be282578c8218a73697ab993",
"closeStatus":"Open",
"buyNow":null
},
"currencyCode":"EUR",
"detailLotId":103689247,
"currentBid":1400,
"biddingEndTime":"2026-05-18T18:10:00.000Z",
"closeStatus":"Open",
"shouldBuy":true,
"enableNotification":true
}
]

Scraper Output for a not-buy opportunity ("shouldBuy": false):

[
{
"id":103827035,
"title":"Omega - Lady - Manual- 1955 - Senza prezzo di riserva - 2418-4 - Donna - 1955",
"subtitle":"Carica manuale - Placcato oro",
"thumbImageUrl":"https://assets.catawiki.nl/assets/2026/5/12/9/2/f/thumb2_92ffebc5-1ce9-4869-8bd4-c8b47cb58029.jpg",
"originalImageUrl":"https://assets.catawiki.nl/assets/2026/5/12/9/2/f/92ffebc5-1ce9-4869-8bd4-c8b47cb58029.jpg",
"favoriteCount":0,
"url":"https://www.catawiki.com/it/l/103827035-omega-lady-manual-1955-senza-prezzo-di-riserva-2418-4-donna-1955",
"localized":true,
"translatedTitle":null,
"translatedSubtitle":null,
"auctionId":1238012,
"pubnubChannel":"CWAUCTION-production-1238012",
"useRealtimeMessageFallback":false,
"use_realtime_message_fallback":false,
"isContentExplicit":false,
"reservePriceSet":false,
"biddingStartTime":"2026-05-15T10:00:00.000Z",
"bidding_start_time":"2026-05-15T10:00:00+00:00",
"buyNow":null,
"hasFreeShipping":false,
"isVectorSearchResult":true,
"description":null,
"sellerId":null,
"sellerShopName":null,
"live":null,
"liveLot":{
"id":103827035,
"reservePriceMet":null,
"bid":{
"EUR":25,
"GBP":1,
"USD":1
},
"biddingStartTime":1778839200000,
"biddingEndTime":1779293400000,
"highestBidderToken":"806cf2a8bebb6d8a03024d529654532944d8d1bc",
"closeStatus":"Open",
"buyNow":null
},
"currencyCode":"EUR",
"detailLotId":103827035,
"currentBid":25,
"biddingEndTime":"2026-05-20T16:10:00.000Z",
"closeStatus":"Open",
"shouldBuy":false,
"enableNotification":true
}
]

API clients

NodeJs

import{ ApifyClient }from'apify-client';
// Initialize the ApifyClient with API token
const client =newApifyClient({
token:'<YOUR_API_TOKEN>',
});
// Prepare Actor input
const input ={
"url":"https://www.catawiki.com/it/c/333-fake-category?filters=936%5B%5D=77927!",
"maxItems":10,
"enableNotification":true,
"maxPrice":100,
"minituesToEnd":15,
"sendMailTo":"user@example.com"
};
(async()=>{
// Run the Actor and wait for it to finish
const run =await client.actor("TZWfWhjtgf9lh8Fts").call(input);
// Fetch and print Actor results from the run's dataset (if any)
 console.log('Results from dataset');
const{ items }=await client.dataset(run.defaultDatasetId).listItems();
 items.forEach((item)=>{
 console.dir(item);
});
})();

Python

from apify_client import ApifyClient
# Initialize the ApifyClient with your API token
client = ApifyClient("<YOUR_API_TOKEN>")
# Prepare the Actor input
run_input ={
"url":"https://www.catawiki.com/it/c/333-fake-category?filters=936%5B%5D=77927!",
"maxItems":10,
"enableNotification":True,
"maxPrice":100,
"minituesToEnd":15,
"sendMailTo":"user@example.com",
}
# Run the Actor and wait for it to finish
run = client.actor("TZWfWhjtgf9lh8Fts").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)

cURL

# Set API token
API_TOKEN=<YOUR_API_TOKEN>
# Prepare Actor input
cat> input.json <<'EOF'
{
 "url": "https://www.catawiki.com/it/c/333-fake-category?filters=936%5B%5D=77927!",
 "maxItems": 10,
 "enableNotification": true,
 "maxPrice": 100,
 "minituesToEnd": 15,
 "sendMailTo": "user@example.com"
}
EOF
# Run the Actor
curl"https://api.apify.com/v2/acts/TZWfWhjtgf9lh8Fts/runs?token=$API_TOKEN"\
-X POST \
-d @input.json \
-H'Content-Type: application/json'