Gratis.com Product Search Scraper: Extract E-commerce Data Effortlessly

---

What Is Gratis.com?

Gratis.com is a European e-commerce platform offering a wide range of consumer products, from beauty and personal care to household items. The platform hosts thousands of listings with dynamic pricing, inventory updates, and detailed product information. Manually extracting product data across categories is inefficient — the Gratis Product Search Scraper automates collection, delivering structured product records in seconds.

---

Overview

The Gratis Product Search Scraper extracts comprehensive product data from Gratis.com search result pages, converting unstructured product listings into clean, machine-readable records. It is designed for:

• Price monitoring services tracking market prices across categories
• E-commerce aggregators building multi-source product databases
• Market researchers analyzing pricing trends and product availability
• Inventory analysts monitoring stock levels and product variations
• Retailers benchmarking competitor offerings

Key features include flexible item limits, automatic pagination handling, robust error management via ignore_url_failures, and rich output spanning 17+ data fields per product.

---

Input Format

The scraper accepts a JSON configuration object specifying which pages to scrape and how:

{
  "urls": [
    "https://www.gratis.com/parfum-deodorant-c-504?page=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}

Field	Description
urls	Direct links to Gratis.com product search result pages (including category and page parameters)
max_items_per_url	Maximum number of products to extract per page (e.g., 200 for comprehensive category coverage)
ignore_url_failures	If true, the scraper continues running even if some URLs fail; if false, any error stops the entire run

Tip: Include pagination parameters (e.g., ?page=2) to scrape multiple result pages in a single run. Copy URLs directly from your browser's address bar.

---

Output Format

Sample output

{
  "id": "10211200",
  "stock_status": "HIGH",
  "prices": {
    "currency": "TRY",
    "discount_rate": 0,
    "discount_rate_label": "%0",
    "discounted_price": 23900,
    "discounted_price_label": "239,00 TL",
    "normal_price": 23900,
    "normal_price_label": "239,00 TL",
    "promotion_price": 9550,
    "promotion_price_label": "95,50 TL",
    "discounted_text": "Gratis Kart ile",
    "promotion_label": "250 TL ve Üzeri Alışverişe"
  },
  "attributes": {
    "brand": "Chupa Chups",
    "display_name": "Chupa Chups Lemon Sorbet Kadın Deodorant Body Sprey 150 ml",
    "order_limit": 4,
    "categories": [
      "Parfüm & Deodorant",
      "Deodorant",
      "Kadın Deodorant Sprey"
    ],
    "boosts": {},
    "description": "Limonun ferahlatıcı ve dinamik kokusuyla kendinizi yenilenmiş gibi hissedin!<br><br>• Chupa Chups Lemon Sorbet Deodorant, enerjisi ile günlük temponuza uyum sağlar ve sizi daima zinde tutar.<br>• Limonun taze aromasıyla gününüze neşeli, eğlenceli ve taptaze bir dokunuş yapmanızı sağlar.<br><br><b>Uyarılar</b><br><br>• Kullanmadan önce çalkalayınız.<br>• Dik pozisyonda 15 cm uzaklıktan cildinize püskürtünüz.",
    "brand_id": "60919",
    "tags": [
      "10sbtplgnl",
      "10sbtprf",
      "12sbtsys",
      "18sbtplgc",
      "11mrtpl60",
      "16mrtysl",
      "19mrtpl70",
      "8nsn60gnl",
      "14nsnkoku",
      "14nsnplgenel",
      "21nsndeo",
      "21nsngenel",
      "27nsnpl60",
      "18myspl",
      "21ockpl",
      "29myskoku",
      "29mysgenel",
      "1hazpl60",
      "6hazek10",
      "6hazdeo",
      "10hazgece60",
      "11hz60",
      "11hzgenel",
      "23hzgece"
    ],
    "ean_upc": "8680586080515",
    "assortment_variant": "Lemon Sorbet",
    "rating_avg": 0,
    "rating_avg_round": 0,
    "keywords": [],
    "max_instalments": 1,
    "tax_code": "20",
    "category_ids": [
      "504",
      "50403",
      "5040301"
    ],
    "features": [],
    "antiperspirant": "Yok",
    "cesit": "Tekli",
    "hacim": "150 ml",
    "pudra": "Yok",
    "ztedarik": "<b>Satıcının İsmi:</b> Gratis İç ve Dış Ticaret A.Ş.<br><b>Kayıtlı Ticari Ünvan:</b> Gratis İç ve Dış Ticaret A.Ş.<br><b>Posta Adresi:</b> Levent Mah. Yapı Kredi Plaza C Blok, Cömert Sok. 1C, Kat: 5 PK: 34330, Beşiktaş / İstanbul<br><b>E-Posta Adresi:</b> info@gratis.com<br><b>İmalatçı/İthalatçı Bilgileri:</b> Diamo Kozmetik Sanayi ve Tic. A.Ş. - Kazım Karabekir Mah. 6913/2 Sok. No: 5 Torbalı / İzmir",
    "zmensei": "Türkiye"
  },
  "images": [],
  "badges": [
    {
      "type": "erp",
      "text": "",
      "image": "",
      "position": "",
      "keyword": "isPL"
    }
  ],
  "badge_description": "",
  "banner_text_one": "",
  "banner_text_two": "",
  "banner_texts": [],
  "image_urls": [
    {
      "file_url": "https://api.gratis.retter.io/1oakekr4e/CALL/Image/getImage/10211200-sidm1pJSk8-01_1024x1024.jpg",
      "file_name": "10211200_01.jpg"
    }
  ],
  "review_average": 3.1,
  "review_count": 9,
  "variant_count": "5 Tür",
  "analytics": {
    "view_count": 7310,
    "sales_count": 284,
    "favorite_count": 583
  },
  "variants": {
    "type": "assortment",
    "values": [
      {
        "id": "10211199",
        "value": "Strawberry Swirl"
      },
      {
        "id": "10211200",
        "value": "Lemon Sorbet"
      },
      {
        "id": "10211201",
        "value": "Tutti Frutti"
      },
      {
        "id": "10211202",
        "value": "Cheeky Cherry"
      },
      {
        "id": "10211203",
        "value": "Pineapple Coco Splash"
      }
    ]
  },
  "share_link": "https://www.gratis.com/kadin-deodorant-sprey/chupa-chups-lemon-sorbet-kadin-deodorant-body-sprey-150-ml-p-10211200",
  "is_active": true,
  "from_url": "https://www.gratis.com/parfum-deodorant-c-504"
}

Each scraped product returns a detailed record with 17+ fields:

Product Identification

Field	Meaning
ID	Unique identifier for the product in the Gratis system
Is Active	Boolean flag indicating whether the product is currently available for purchase

Pricing & Availability

Field	Meaning
Prices	Current and historical pricing data (may include discounts, currency)
Stock Status	Availability status (in stock, low stock, out of stock, pre-order)

Visual Content

Field	Meaning
Images	Product image data references
Image URLs	Direct URLs to product images for display or download
Banner Text One	Primary promotional text displayed above the product
Banner Text Two	Secondary promotional or descriptive text
Banner Texts	Aggregated banner messages for the product

Product Details

Field	Meaning
Attributes	Product attributes (e.g., color, size, fragrance type for perfumes)
Badges	Special labels such as "Best Seller," "New," "On Sale"
Badge Description	Explanatory text for each badge (e.g., why it earned "Best Seller")
Variant Count	Total number of product variants available (sizes, colors, etc.)
Variants	Detailed variant data including SKUs, pricing, and availability per variant

Customer & Social Data

Field	Meaning
Review Average	Average product rating (typically 0–5 scale)
Review Count	Total number of customer reviews

Tools & Sharing

Field	Meaning
Share Link	Shareable product URL for social media or messaging
Analytics	Engagement or performance data (views, clicks, if available)

---

How to Use

1. Navigate to Gratis.com — Browse to a product category (e.g., Perfume & Deodorant).
2. Copy the URL — From the category or search results page, copy the full URL from your browser's address bar, including any page, filter, or sort parameters.
3. Configure input — Paste the URL(s) into the urls array. Adjust max_items_per_url based on the number of products per page you wish to collect.
4. Enable error handling — Set ignore_url_failures: true for bulk runs to skip problematic URLs without interruption.
5. Execute the scraper — Start the actor and monitor progress in the logs.
6. Download results — Export the dataset as JSON, CSV, or Excel for analysis or import into your system.

Common tips:

• For category-wide data, include multiple page URLs (e.g., ?page=1, ?page=2, ?page=3).
• Use filters and sorting parameters in the URL to narrow product scope before scraping.
• Check review_count and review_average for product quality insights.

---

Use Cases & Business Value

• Price intelligence: Monitor competitor pricing, discounts, and promotional campaigns in real time
• Inventory management: Track stock availability and reorder signals across product lines
• Assortment analysis: Identify trending products, variants, and attribute combinations
• Product aggregation: Feed Gratis data into multi-source product feeds or comparison websites
• Market research: Analyze product ratings, review volumes, and customer sentiment trends

By automating product data collection, the scraper eliminates hours of manual work and enables data-driven decisions on pricing, inventory, and assortment strategy.

---

Conclusion

The Gratis.com Product Search Scraper is a powerful tool for anyone needing reliable e-commerce product data at scale. With comprehensive output across pricing, inventory, reviews, and imagery, it transforms search result pages into actionable datasets. Whether you are tracking market trends, managing inventory, or building product aggregators, this scraper streamlines the process and delivers consistent, structured data.