Reserved Product Scraper

An Apify Actor for scraping product data from Reserved.com (LPP Group). Extract comprehensive product information including prices, sizes, colors, images, ratings, and promotional data using fast Algolia API.

Features

• Algolia API Powered - Lightning-fast data extraction via Reserved's internal API
• Rich Product Data - Complete product information including sizes, colors, materials, and images
• Multi-Country Support - Works with any Reserved country and language combination
• Promotion Support - Scrape Black Friday, Sale, and other promotional pages
• Advanced Filtering - Filter by categories, subcategories, and product keywords
• Smart Deduplication - Prevents duplicate products across multiple categories
• Real-Time Data - Get current prices and product availability
• REST API Mode - On-demand product scraping via HTTP endpoints

Input Configuration

The actor accepts the following input parameters:

Parameter	Type	Description	Required	Default
start_urls	Array	Direct URLs to Reserved category/subcategory pages	Yes	-
category_filter	Array	Filter by main categories (e.g., ["ubrania", "akcesoria"])	No	[]
subcategory_filter	Array	Filter by subcategories (e.g., ["kurtki-plaszcze", "sukienki"])	No	[]
product_seo_keyword_filter	Array	Filter by keywords in product URL	No	[]
deduplicate_across_all_start_urls	Boolean	Remove duplicate products across all URLs	No	true
max_results	Integer	Maximum products to scrape (0 = unlimited)	No	100
scrape_product_details	Boolean	Visit each product page for full details	No	false
maxConcurrency	Integer	Number of parallel requests (1-20)	No	5
maxRequestRetries	Integer	Retry attempts for failed requests	No	3
proxyConfiguration	Object	Proxy settings for the scraper	No	-

Important Notes About URLs

• Category/subcategory URLs are supported (e.g., https://www.reserved.com/pl/pl/kobieta/ubrania)
• Promotion URLs are supported (e.g., https://www.reserved.com/pl/pl/black-friday/kobieta)
• Homepage URLs will NOT work - always use direct category links

Example Input - Basic Scraping

{
  "start_urls": [
    {
      "url": "https://www.reserved.com/pl/pl/kobieta/ubrania"
    }
  ],
  "max_results": 50,
  "maxConcurrency": 5
}

Example Input - Black Friday / Promotions

{
  "start_urls": [
    {
      "url": "https://www.reserved.com/pl/pl/black-friday/kobieta"
    },
    {
      "url": "https://www.reserved.com/pl/pl/black-friday/mezczyzna"
    }
  ],
  "max_results": 200
}

Example Input - Multiple Categories

{
  "start_urls": [
    {
      "url": "https://www.reserved.com/pl/pl/kobieta/ubrania"
    },
    {
      "url": "https://www.reserved.com/pl/pl/mezczyzna/ubrania"
    }
  ],
  "deduplicate_across_all_start_urls": true,
  "max_results": 200
}

Example Input - Multi-Country Scraping

{
  "start_urls": [
    {
      "url": "https://www.reserved.com/pl/pl/kobieta/ubrania"
    },
    {
      "url": "https://www.reserved.com/de/de/damen/bekleidung"
    },
    {
      "url": "https://www.reserved.com/cz/cz/zeny/obleceni"
    }
  ],
  "max_results": 100
}

Output Format

Each product contains comprehensive data:

{
  "sku": "5863V-99X",
  "brand": "Reserved",
  "name": "Kurtka puchowa z kapturem",

  "price": 299.99,
  "originalPrice": 449.99,
  "currency": "PLN",
  "hasDiscount": true,
  "discountPercent": 33,

  "mainImage": "https://static.reserved.com/media/catalog/product/.../5863V-99X-001.jpg",
  "secondaryImage": "https://static.reserved.com/media/catalog/product/.../5863V-99X-002.jpg",

  "color": "czarny",
  "colorVariants": [
    {
      "sku": "5863V-99X",
      "color": "czarny",
      "image": "https://static.reserved.com/..."
    }
  ],

  "sizes": ["XS", "S", "M", "L", "XL"],

  "rating": 4.5,
  "ratingCount": 128,

  "stickers": ["-20% Z KODEM EXTRA20", "TYLKO ONLINE"],

  "productDescription": "Elegancka kurtka puchowa z kapturem...",
  "features": {},

  "category": "Kobieta",
  "subcategory": "Kurtki, płaszcze",
  "allCategories": ["Kobieta", "Ubrania", "Kurtki, płaszcze"],

  "season": "AW24",
  "collection": "Autumn Winter 2024",
  "inStock": true,
  "lowStock": false,

  "website": "https://www.reserved.com",
  "productPage": "https://www.reserved.com/pl/pl/kurtka-puchowa-z-kapturem-5863v-99x",
  "algoliaId": "5863V-99X_PL_PL",
  "scrapedAt": "2025-01-15T10:30:00.000Z"
}

Output Fields Reference

Basic Product Information

• sku - Product SKU/ID (e.g., "5863V-99X")
• brand - Always "Reserved"
• name - Product name

Pricing

• price - Current/final price
• originalPrice - Original price before discount (if applicable)
• currency - Currency code (PLN, EUR, CZK, etc.)
• hasDiscount - Boolean indicating if product is on sale
• discountPercent - Discount percentage (0-100)

Images & Media

• mainImage - Primary product image URL
• secondaryImage - Secondary/back product image URL

Colors & Sizes

• color - Main product color
• colorVariants - Array of color variant objects with SKU, color name, and image
• sizes - Array of available sizes

Ratings & Reviews

• rating - Average rating (0.0-5.0) or null
• ratingCount - Number of ratings

Promotional Information

• stickers - Array of promotional tags (e.g., "-20% Z KODEM EXTRA20", "BESTSELLER", "NOWOŚĆ")

Product Details

• productDescription - Full product description
• features - Object containing product features

Categories

• category - Main category (gender: "Kobieta", "Mężczyzna", etc.)
• subcategory - Subcategory (e.g., "Kurtki, płaszcze")
• allCategories - Full category hierarchy

Inventory & Collection

• season - Season code (e.g., "AW24")
• collection - Collection name
• inStock - Product availability
• lowStock - Low stock indicator

Metadata

• website - Always "https://www.reserved.com"
• productPage - Direct product page URL
• algoliaId - Internal Algolia ID
• scrapedAt - ISO 8601 timestamp

Notes on Data Availability

• All fields are always present in the output
• Fields may be null, empty strings "", or empty arrays [] if data is not available
• Data is extracted via Algolia API for maximum speed and reliability

Use Cases

• E-commerce Monitoring - Track competitor pricing and product availability
• Price Intelligence - Monitor price changes and discount patterns
• Black Friday Tracking - Monitor promotional products and discounts
• Market Research - Analyze product trends across different countries
• Product Catalog - Build comprehensive product databases
• Fashion Analytics - Analyze clothing trends, colors, and sizes
• Multi-Market Strategy - Compare offerings across different Reserved markets

Supported Countries

• Poland: https://www.reserved.com/pl/pl/...
• Czech Republic: https://www.reserved.com/cz/cz/...
• Slovakia: https://www.reserved.com/sk/sk/...
• Hungary: https://www.reserved.com/hu/hu/...
• Romania: https://www.reserved.com/ro/ro/...
• Germany: https://www.reserved.com/de/de/...

Best Practices

• Use promotion URLs for sales - e.g., /black-friday/kobieta for Black Friday products
• Set reasonable max_results to control run time
• Use proxies for large-scale scraping to avoid rate limiting
• Only category URLs work - Homepage URLs are not supported

REST API Mode (Standby)

The scraper supports an API mode for on-demand product scraping. When you run the Actor with empty start_urls, it starts an HTTP server that allows you to scrape individual products via API calls.

Enabling API Mode

Run the Actor with empty start URLs:

{
  "start_urls": []
}

API Endpoints

Endpoint	Method	Description
/	GET	API info and available endpoints
/health	GET	Health check
/product?url=...	GET	Scrape a single product

Example Usage

Health Check:

$curl https://your-actor-standby-url/health

Scrape Single Product:

$curl "https://your-actor-standby-url/product?url=https://www.reserved.com/pl/pl/kurtka-puchowa-z-kapturem-5863v-99x"

API Response Format

{
  "name": "Kurtka puchowa z kapturem",
  "price": 299.99,
  "originalPrice": 449.99,
  "currency": "PLN",
  "sku": "5863V-99X",
  "color": "czarny",
  "sizes": ["XS", "S", "M", "L", "XL"],
  "mainImage": "https://static.reserved.com/...",
  "rating": 4.5,
  "ratingCount": 128,
  "stickers": ["-20% Z KODEM EXTRA20"],
  "brand": "Reserved",
  "productPage": "https://www.reserved.com/pl/pl/kurtka-puchowa-z-kapturem-5863v-99x",
  "scrapedAt": "2025-01-15T10:30:00.000Z"
}

Use Cases for API Mode

• Real-time Price Checking - Get current product data on demand
• Integration with Other Systems - Connect via HTTP for automated workflows
• Single Product Lookups - When you don't need bulk scraping

---

Related Actors

Check out other scrapers from the same developer:

• Mohito Scraper - Fast scraper for Mohito.com product data (same LPP Group as Reserved)
• Sinsay Scraper - Fast scraper for Sinsay.com product data (same LPP Group as Reserved)
• Ceneo Product Scraper - Extract product data and prices from Poland's largest price comparison website
• Empik Product Search Scraper - Scrape product listings from Empik.com search results and category pages
• Empik Product Page Details Scraper - Extract detailed product data from Empik.com product pages
• Pracuj.pl Scraper - Scrape job listings from Poland's leading job portal

---

Your Feedback

We are always working to improve our scrapers. If you have any technical feedback or found a bug, please create an issue in the repository or contact us through Apify Console.