Sinsay Product Scraper

A blazingly fast Apify Actor for scraping product data from Sinsay.com. Extract comprehensive product information including prices, variants, images, stock levels and ratings.

Features

• Extremely Fast - Scrapes 1000 products in ~17 seconds (59 products/second)
• Rich Product Data - Complete product information including all variants, sizes, colors, and stock levels
• Multi-Country Support - Works with any Sinsay country and language combination
• Advanced Filtering - Filter by categories, subcategories, and product keywords
• Smart Deduplication - Prevents duplicate products across multiple categories
• Real-Time Stock - Get current availability and stock quantities per size/color
• Comprehensive Variants - Extract all color options with sizes, images, and videos
• Cost-Effective - Minimal compute usage due to API-based approach (no heavy DOM parsing)
• 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 Sinsay category/subcategory pages	Yes	-
category_filter	Array	Filter by main categories (e.g., ["kobieta", "mezczyzna"])	No	[]
subcategory_filter	Array	Filter by subcategories (e.g., ["odziez", "buty"])	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
maxConcurrency	Integer	Number of parallel API requests (1-20)	No	10
maxRequestRetries	Integer	Retry attempts for failed requests	No	3
proxyConfiguration	Object	Proxy settings for the scraper	No	-

Important Notes About URLs

• Only category/subcategory URLs are supported (e.g., https://www.sinsay.com/pl/pl/kobieta/najchetniej-kupowane)
• Homepage URLs will NOT work - always use direct category links

Example Input - Basic Scraping

{
  "start_urls": [
    {
      "url": "https://www.sinsay.com/pl/pl/kobieta/najchetniej-kupowane"
    }
  ],
  "max_results": 50,
  "maxConcurrency": 10
}

Example Input - Multiple Categories

{
  "start_urls": [
    {
      "url": "https://www.sinsay.com/pl/pl/kobieta/najchetniej-kupowane"
    },
    {
      "url": "https://www.sinsay.com/pl/pl/mezczyzna/bestseller"
    }
  ],
  "deduplicate_across_all_start_urls": true,
  "max_results": 200,
  "maxConcurrency": 15
}

Example Input - Multi-Country Scraping

{
  "start_urls": [
    {
      "url": "https://www.sinsay.com/pl/pl/kobieta/najchetniej-kupowane"
    },
    {
      "url": "https://www.sinsay.com/de/de/damen/bestseller"
    },
    {
      "url": "https://www.sinsay.com/uk/en/woman/bestsellers"
    }
  ],
  "max_results": 100,
  "maxConcurrency": 12
}

Example Input - Filtered by Keywords

{
  "start_urls": [
    {
      "url": "https://www.sinsay.com/pl/pl/kobieta/odziez"
    }
  ],
  "product_seo_keyword_filter": ["sukienka", "spodnie"],
  "max_results": 100,
  "maxConcurrency": 10
}

Example Input - Unlimited Scraping

{
  "start_urls": [
    {
      "url": "https://www.sinsay.com/pl/pl/kobieta/najchetniej-kupowane"
    }
  ],
  "max_results": 0,
  "maxConcurrency": 15,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Output Format

Each product contains comprehensive data extracted directly from Sinsay's API:

{
  "sku": "710FJ-99M",
  "brand": "Sinsay",
  "name": "Spodnie wide leg",

  "price": 59.99,
  "currency": "PLN",
  "hasDiscount": false,
  "discountPercent": null,
  "priceIncludesTax": true,

  "mainImage": "https://static.sinsay.com/media/catalog/product/.../710FJ-99M-001-1.jpg",
  "images": [
    "https://static.sinsay.com/media/catalog/product/.../710FJ-99M-001-1.jpg",
    "https://static.sinsay.com/media/catalog/product/.../710FJ-99M-050-1.jpg"
  ],

  "stickers": [
    {
      "type": "custom",
      "text": "DRUGA RZECZ -50%",
      "color": "#000000",
      "backgroundColor": "#000000"
    },
    {
      "type": "tertiary",
      "text": "NOWOŚĆ",
      "color": "#2c8ee4",
      "backgroundColor": ""
    }
  ],

  "avgRating": 4.92,
  "ratingCount": 15,
  "ratingStars": "5",

  "isBestseller": true,
  "bestsellerCategory": "Spódnice damskie",

  "colorOptions": [
    {
      "id": 6582693,
      "sku": "710FJ-99M",
      "colorName": "czarny",
      "colorCode": "BLACK",
      "colorPhoto": "https://static.sinsay.com/media/.../710FJ-99M-999-1.jpg",
      "isActive": true,
      "isInStock": true,
      "url": "https://www.sinsay.com/pl/pl/spodnie-wide-leg-710fj-99m",

      "prices": {
        "currency": "PLN",
        "finalPrice": 59.99,
        "hasDiscount": false
      },

      "sizes": [
        {
          "size": "XS",
          "sku": "710FJ-99M-XS",
          "sizeId": 1035,
          "inStock": true,
          "stockQuantity": 30,
          "inTransitStock": false,
          "price": 59.99
        }
      ],

      "images": [
        "https://static.sinsay.com/media/.../710FJ-99M-001-1.jpg"
      ],

      "videoUrls": {
        "desktop": "https://static.sinsay.com/media/SHARED/video/video_710FJ-99M_DESKTOP.mp4",
        "mobile": "https://static.sinsay.com/media/SHARED/video/video_710FJ-99M_MOBILE.mp4",
        "tablet": "https://static.sinsay.com/media/SHARED/video/video_710FJ-99M_TABLET.mp4"
      },

      "ratingData": {
        "avgRating": 4.92,
        "ratingCount": 15
      }
    }
  ],

  "sizes": [
    {
      "size": "XS",
      "sizeId": 1035,
      "inStock": true,
      "stockQuantity": 30
    }
  ],

  "category": "kobieta",
  "subcategory": "nowosci",
  "website": "https://www.sinsay.com",
  "categoryPage": "https://www.sinsay.com/pl/pl/kobieta/nowosci",
  "productPage": "https://www.sinsay.com/pl/pl/spodnie-wide-leg-710fj-99m",
  "scrapedAt": "2025-01-15T10:30:00.000Z"
}

Output Fields Reference

Basic Product Information

• sku - Product SKU/ID
• brand - Always "Sinsay"
• name - Product name

Pricing

• price - Current/final price
• currency - Currency code (PLN, EUR, USD, etc.)
• hasDiscount - Boolean indicating if product is on sale
• discountPercent - Discount percentage (e.g., "30%") or null
• priceIncludesTax - Always true for Sinsay

Images & Media

• mainImage - Primary product image URL
• images - Array of all product image URLs

Promotional Information

• stickers - Array of promotional tags/stickers
  • type - "custom" or "tertiary"
  • text - Sticker text (e.g., "NEW", "-30%")
  • color - Text color
  • backgroundColor - Background color

Ratings & Reviews

• avgRating - Average rating (0.0-5.0) or null
• ratingCount - Number of reviews
• ratingStars - Star category ("0" to "5") or null

Bestseller Status

• isBestseller - Boolean indicating bestseller status
• bestsellerCategory - Bestseller category name or null

Color Variants

• colorOptions - Array of color variants (null if none)
  • id - Variant ID
  • sku - Variant SKU
  • colorName - Color name (e.g., "czarny", "biały")
  • colorCode - Color code (e.g., "BLACK", "WHITE")
  • colorPhoto - Color swatch image URL
  • isActive - Boolean indicating if variant is active
  • isInStock - Boolean indicating availability
  • url - Direct URL to this color variant
  • prices - Pricing for this color
    • currency - Currency code
    • finalPrice - Current price
    • hasDiscount - Discount status
  • sizes - Array of available sizes
    • size - Size name (XS, S, M, L, XL, etc.)
    • sku - Size-specific SKU
    • sizeId - Size ID
    • inStock - Availability boolean
    • stockQuantity - Number of items in stock
    • inTransitStock - Stock in transit boolean
    • price - Price for this size
  • images - Array of images for this color
  • videoUrls - Product videos
    • desktop - Desktop video URL
    • mobile - Mobile video URL
    • tablet - Tablet video URL
  • ratingData - Ratings for this color variant
    • avgRating - Average rating
    • ratingCount - Review count

Sizes (General)

• sizes - Array of sizes when no color options (null if colorOptions exist)
  • size - Size name
  • sizeId - Size ID
  • inStock - Availability
  • stockQuantity - Stock level

Metadata

• category - Main category from URL (e.g., "kobieta")
• subcategory - Subcategory from URL (e.g., "nowosci")
• website - Always "https://www.sinsay.com"
• categoryPage - Source category page URL
• productPage - Direct product page URL
• 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
• colorOptions and sizes are mutually exclusive - if colorOptions exists, sizes is usually null
• Stock quantities reflect real-time availability
• Not all products have ratings or bestseller status

Use Cases

• E-commerce Monitoring - Track competitor pricing and product availability
• Price Intelligence - Monitor price changes and discount patterns
• Inventory Analysis - Track stock levels and product availability
• Market Research - Analyze product trends across different countries
• Product Catalog - Build comprehensive product databases
• Trend Analysis - Identify bestsellers and popular products
• Multi-Market Strategy - Compare offerings across different Sinsay markets
• Fashion Analytics - Analyze clothing trends, colors, and sizes

Performance & Best Practices

Speed & Efficiency

The scraper uses API-first approach which makes it exceptionally fast:

• 1000 products: ~17 seconds
• Throughput: ~59 products/second
• Per product: ~0.017 seconds

This is 60x faster than traditional HTML scraping methods!

Important Notes

• Only category/subcategory URLs work - Homepage URLs are not supported
• Enable proxies for large-scale scraping to avoid rate limiting
• The scraper handles pagination automatically (100 products per API call)

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 or entire categories 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 page
/category?url=...&limit=N	GET	Scrape products from category (default limit: 100)

Example Usage

Health Check:

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

Scrape Single Product:

$curl "https://your-actor-standby-url/product?url=https://www.sinsay.com/pl/pl/spodnie-wide-leg-710fj-99m"

Scrape Category (with limit):

$curl "https://your-actor-standby-url/category?url=https://www.sinsay.com/pl/pl/kobieta/najchetniej-kupowane&limit=50"

API Response Format

Single Product Response:

{
  "name": "Spodnie wide leg",
  "price": 59.99,
  "currency": "PLN",
  "sku": "710FJ-99M",
  "color": "czarny",
  "sizes": ["XS", "S", "M", "L", "XL"],
  "images": ["https://static.sinsay.com/..."],
  "brand": "Sinsay",
  "productPage": "https://www.sinsay.com/pl/pl/spodnie-wide-leg-710fj-99m",
  "scrapedAt": "2025-01-15T10:30:00.000Z"
}

Category Response:

{
  "count": 50,
  "products": [
    {
      "sku": "710FJ-99M",
      "brand": "Sinsay",
      "name": "Spodnie wide leg",
      "price": 59.99,
      "currency": "PLN",
      "hasDiscount": false,
      "mainImage": "https://static.sinsay.com/...",
      "colorOptions": [...],
      "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
• Category Snapshots - Quick category scraping with customizable limits

---

Related Actors

Check out other scrapers from the same developer:

• Mohito Scraper - Scrape product data from Mohito.com (same LPP Group as Sinsay)
• 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.