# Gratis Product Search Scraper (`stealth_mode/gratis-product-search-scraper`) Actor
Scrape product listings from Gratis.com with precision. Collect IDs, prices, stock status, images, reviews, variants, and 17+ fields per product — perfect for price monitoring, inventory tracking, and market analysis.
- **URL**: https://apify.com/stealth\_mode/gratis-product-search-scraper.md
- **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## 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:
```json
{
"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**
```json
{
"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!
• Chupa Chups Lemon Sorbet Deodorant, enerjisi ile günlük temponuza uyum sağlar ve sizi daima zinde tutar.
• Limonun taze aromasıyla gününüze neşeli, eğlenceli ve taptaze bir dokunuş yapmanızı sağlar.
Uyarılar
• Kullanmadan önce çalkalayınız.
• 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": "Satıcının İsmi: Gratis İç ve Dış Ticaret A.Ş.
Kayıtlı Ticari Ünvan: Gratis İç ve Dış Ticaret A.Ş.
Posta Adresi: Levent Mah. Yapı Kredi Plaza C Blok, Cömert Sok. 1C, Kat: 5 PK: 34330, Beşiktaş / İstanbul
E-Posta Adresi: info@gratis.com
İmalatçı/İthalatçı Bilgileri: 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.
# Actor input Schema
## `urls` (type: `array`):
Add the URLs of the product search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.
## `ignore_url_failures` (type: `boolean`):
If true, the scraper will continue running even if some URLs fail to be scraped.
## `max_items_per_url` (type: `integer`):
The maximum number of items to scrape per URL.
## Actor input object example
```json
{
"urls": [
"https://www.gratis.com/parfum-deodorant-c-504?page=2"
],
"ignore_url_failures": true,
"max_items_per_url": 20
}
```
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"urls": [
"https://www.gratis.com/parfum-deodorant-c-504?page=2"
],
"ignore_url_failures": true,
"max_items_per_url": 20
};
// Run the Actor and wait for it to finish
const run = await client.actor("stealth_mode/gratis-product-search-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"urls": ["https://www.gratis.com/parfum-deodorant-c-504?page=2"],
"ignore_url_failures": True,
"max_items_per_url": 20,
}
# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/gratis-product-search-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"urls": [
"https://www.gratis.com/parfum-deodorant-c-504?page=2"
],
"ignore_url_failures": true,
"max_items_per_url": 20
}' |
apify call stealth_mode/gratis-product-search-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=stealth_mode/gratis-product-search-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Gratis Product Search Scraper",
"description": "Scrape product listings from Gratis.com with precision. Collect IDs, prices, stock status, images, reviews, variants, and 17+ fields per product — perfect for price monitoring, inventory tracking, and market analysis.",
"version": "0.0",
"x-build-id": "pVLigXwzfaIciirIs"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/stealth_mode~gratis-product-search-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-stealth_mode-gratis-product-search-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/stealth_mode~gratis-product-search-scraper/runs": {
"post": {
"operationId": "runs-sync-stealth_mode-gratis-product-search-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/stealth_mode~gratis-product-search-scraper/run-sync": {
"post": {
"operationId": "run-sync-stealth_mode-gratis-product-search-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"urls": {
"title": "URLs of the product search list urls to scrape",
"type": "array",
"description": "Add the URLs of the product search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.",
"items": {
"type": "string"
}
},
"ignore_url_failures": {
"title": "Continue running even if some URLs fail to be scraped",
"type": "boolean",
"description": "If true, the scraper will continue running even if some URLs fail to be scraped."
},
"max_items_per_url": {
"title": "Max items per URL",
"type": "integer",
"description": "The maximum number of items to scrape per URL."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```