# Vivantis Product Search Scraper (`stealth_mode/vivantis-product-search-scraper`) Actor

Scrape beauty and fragrance product listings from Hondoscenter with precision. Capture SKUs, prices, stock status, ratings, images, and 30+ fields per product — perfect for price monitoring, inventory sync, and ecommerce analytics.

- **URL**: https://apify.com/stealth\_mode/vivantis-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

## Vivantis Product Scraper: Extract Perfume & Beauty Data Across Domains
---

### What Is Vivantis?

Vivantis is a major e-commerce platform across Central and Eastern Europe specializing in perfumes, cosmetics, and beauty products. Operating multiple regional domains (Vivantis.sk in Slovakia, Vivantis.ro in Romania, and others), it hosts thousands of beauty product listings with competitive pricing, reviews, and detailed product information. Manually collecting product data from Vivantis search results is tedious and error-prone — the **Vivantis Product Scraper** automates this, delivering structured product intelligence across all regional sites.

---

### Overview

The **Vivantis Product Scraper** extracts comprehensive product data from search result pages and category listings. It is designed for:

- **Price monitoring services** tracking beauty product costs across regions
- **Market researchers** analyzing perfume and cosmetics trends in Eastern Europe
- **Retailers and resellers** aggregating competitor pricing and product information
- **Data analysts** building datasets for market intelligence and inventory management
- **E-commerce platforms** integrating beauty products into multi-vendor systems

Key strengths include flexible URL handling, configurable item limits, and resilient error handling through `ignore_url_failures`, allowing reliable bulk collection across multiple Vivantis domains.

---

### Input Format

The scraper accepts a JSON configuration object:

```json
{
  "urls": [
    "https://www.vivantis.sk/parfumy/?page=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}
````

#### Input Parameters Explained

| Parameter | Type | Description | Example |
|---|---|---|---|
| `urls` | Array of strings | Product search list URLs from Vivantis domains to scrape | `["https://www.vivantis.sk/parfumy/?page=2", "https://www.vivantis.ro/parfumuri/"]` |
| `ignore_url_failures` | Boolean | If `true`, scraper continues running even if some URLs fail. If `false`, any failed URL stops the entire run. | `true` |
| `max_items_per_url` | Integer | Maximum number of products to extract from each URL | `200` |

#### How to Prepare URLs

- Navigate to a Vivantis domain (e.g., `.sk`, `.ro`, `.cz`, `.hu`)
- Browse product categories (e.g., /parfumy, /kosmetika)
- Paginate through results
- Copy the full URL including page parameters: `https://www.vivantis.sk/parfumy/?page=2`
- Paste URLs into the `urls` array, one per line

> **Tip:** Use `ignore_url_failures: true` for bulk runs to prevent interruptions from temporary blocks or unavailable pages.

***

### Output Format

**Sample output**

```json
{
  "code": "pLTF118",
  "online": 1,
  "price": {
    "with_vat": {
      "amount": "2170",
      "multiplier": 100,
      "currency": "EUR",
      "decimal": "21.70"
    },
    "without_vat": {
      "amount": "1764",
      "multiplier": 100,
      "currency": "EUR",
      "decimal": "17.64"
    },
    "base_with_vat": {
      "amount": "2170",
      "multiplier": 100,
      "currency": "EUR",
      "decimal": "21.70"
    },
    "rrp_with_vat": {
      "amount": "2520",
      "multiplier": 100,
      "currency": "EUR",
      "decimal": "25.20"
    }
  },
  "currency": "EUR",
  "price_vat": 23,
  "stocks": {
    "main": 4,
    "mailstep": 0,
    "migrace": 0
  },
  "delivery_text": "pozajtra u vás",
  "delivery_date": "2026-06-26",
  "price_action": {
    "action": false,
    "sale": false,
    "rrp_discount": false,
    "percent": 0,
    "end": null,
    "text": ""
  },
  "badges_prioritized": [
    {
      "id": "AKCE_KOD",
      "title": "Akcia s kódom",
      "short_title": "",
      "design": "sales"
    },
    {
      "id": "TAG_VYHODNE",
      "title": "Výhodné",
      "short_title": "",
      "design": "sales"
    }
  ],
  "unit_price": {
    "price": {
      "amount": "2170",
      "multiplier": 100,
      "currency": "EUR",
      "decimal": "21.70"
    },
    "unit": "ml",
    "quantity": 100
  },
  "flash_sale_propagation": null,
  "id": "9e0d9d98-7722-46ab-b0b6-b1ce3cfb18fc",
  "uuid": "9e0d9d98-7722-46ab-b0b6-b1ce3cfb18fc",
  "description": null,
  "shop": "p",
  "name": "Ra`ed Oud - EDP",
  "new": false,
  "product_test_score": null,
  "pars": [
    {
      "code": "pLTF118100",
      "online": 1,
      "price": {
        "with_vat": {
          "amount": "2170",
          "multiplier": 100,
          "currency": "EUR",
          "decimal": "21.70"
        },
        "without_vat": {
          "amount": "1764",
          "multiplier": 100,
          "currency": "EUR",
          "decimal": "17.64"
        },
        "base_with_vat": {
          "amount": "2170",
          "multiplier": 100,
          "currency": "EUR",
          "decimal": "21.70"
        },
        "rrp_with_vat": {
          "amount": "2520",
          "multiplier": 100,
          "currency": "EUR",
          "decimal": "25.20"
        }
      },
      "currency": "EUR",
      "price_vat": 23,
      "stocks": {
        "main": 4,
        "mailstep": 0,
        "migrace": 0
      },
      "delivery_text": "pozajtra u vás",
      "delivery_date": "2026-06-26",
      "price_action": {
        "action": false,
        "sale": false,
        "rrp_discount": false,
        "percent": 0,
        "end": null,
        "text": ""
      },
      "badges_prioritized": [
        {
          "id": "AKCE_KOD",
          "title": "Akcia s kódom",
          "short_title": "",
          "design": "sales"
        },
        {
          "id": "TAG_VYHODNE",
          "title": "Výhodné",
          "short_title": "",
          "design": "sales"
        }
      ],
      "unit_price": {
        "price": {
          "amount": "2170",
          "multiplier": 100,
          "currency": "EUR",
          "decimal": "21.70"
        },
        "unit": "ml",
        "quantity": 100
      },
      "flash_sale_propagation": null,
      "name": "Objem",
      "value": "100 ml",
      "order": 0,
      "perfume_sample": false,
      "bquality": null,
      "badges": []
    }
  ],
  "brands": [
    {
      "name": "Lattafa"
    }
  ],
  "sections": [
    {
      "id": 66477,
      "name": "Parfumy",
      "parent_id": null
    },
    {
      "id": 66487,
      "name": "Parfumová voda (EDP)",
      "parent_id": 66477
    }
  ],
  "sections_all": [
    66477,
    66487
  ],
  "flags": [],
  "order": 1,
  "has_pars_different_price": false,
  "has_pars_different_percent": false,
  "is_violating_google_policy": false,
  "perfume_composition_match_ratio": null,
  "img_list": [
    {
      "type": "primary",
      "par": null,
      "url": "/photos/p/_orig/LT/lattafa-ra-ed-oud-edp_14900253205634.jpg",
      "illustrative_only": false,
      "text": null,
      "blurhash": "LmLX0q00_NNINyR+oLRj%Ms:WBt7",
      "miniature": "https://img.vivantiscdn.net/photos/w50_h50_fN/p/_orig/LT/lattafa-ra-ed-oud-edp_14900253205634.jpg",
      "mini_card": "https://img.vivantiscdn.net/photos/w100_h100_fN/p/_orig/LT/lattafa-ra-ed-oud-edp_14900253205634.jpg",
      "gallery": "https://img.vivantiscdn.net/photos/w88_h88_fN/p/_orig/LT/lattafa-ra-ed-oud-edp_14900253205634.jpg",
      "product_card": "https://img.vivantiscdn.net/photos/w400_h400_fN/p/_orig/LT/lattafa-ra-ed-oud-edp_14900253205634.jpg",
      "fe24product_card": "https://img.vivantiscdn.net/photos/w272_h328_fN/p/_orig/LT/lattafa-ra-ed-oud-edp_14900253205634.jpg",
      "detail": "https://img.vivantiscdn.net/photos/w400_h325/p/_orig/LT/lattafa-ra-ed-oud-edp_14900253205634.jpg",
      "large": "https://img.vivantiscdn.net/photos/w600_h600_fN/p/_orig/LT/lattafa-ra-ed-oud-edp_14900253205634.jpg",
      "original": "https://img.vivantiscdn.net/photos/-/p/_orig/LT/lattafa-ra-ed-oud-edp_14900253205634.jpg"
    },
    {
      "type": "product_additional",
      "par": "pLTF118",
      "url": "/photos/p/_orig/LT/dalsi_obrazky/ra-ed-oud-edp-244452606205635.png",
      "illustrative_only": false,
      "text": null,
      "blurhash": "LQQcM0?wOt?F00o~NfxB%MWVM{ay",
      "miniature": "https://img.vivantiscdn.net/photos/w50_h50_fN/p/_orig/LT/dalsi_obrazky/ra-ed-oud-edp-244452606205635.png",
      "mini_card": "https://img.vivantiscdn.net/photos/w100_h100_fN/p/_orig/LT/dalsi_obrazky/ra-ed-oud-edp-244452606205635.png",
      "gallery": "https://img.vivantiscdn.net/photos/w88_h88_fN/p/_orig/LT/dalsi_obrazky/ra-ed-oud-edp-244452606205635.png",
      "product_card": "https://img.vivantiscdn.net/photos/w400_h400_fN/p/_orig/LT/dalsi_obrazky/ra-ed-oud-edp-244452606205635.png",
      "fe24product_card": "https://img.vivantiscdn.net/photos/w272_h328_fN/p/_orig/LT/dalsi_obrazky/ra-ed-oud-edp-244452606205635.png",
      "detail": "https://img.vivantiscdn.net/photos/w400_h325/p/_orig/LT/dalsi_obrazky/ra-ed-oud-edp-244452606205635.png",
      "large": "https://img.vivantiscdn.net/photos/w600_h600_fN/p/_orig/LT/dalsi_obrazky/ra-ed-oud-edp-244452606205635.png",
      "original": "https://img.vivantiscdn.net/photos/-/p/_orig/LT/dalsi_obrazky/ra-ed-oud-edp-244452606205635.png"
    }
  ],
  "url_relative": "/parfumy/lattafa-ra-ed-oud-edp.html",
  "is_bquality": false,
  "master_code": "pLTF118",
  "review_summary": {
    "product_master_code": "pLTF118",
    "rating_count": 7,
    "verbose_rating_count": 0,
    "rating_summary": 30.5,
    "average_rating": 4.4,
    "source_rating": [
      {
        "source_name": "Heureka",
        "rating_count": 7,
        "rating_summary": 30.5,
        "average_rating": 4.4
      }
    ],
    "value_rating": [
      {
        "rating_value": 1,
        "rating_count": 1,
        "rating_percent": 14
      },
      {
        "rating_value": 2,
        "rating_count": 0,
        "rating_percent": 0
      },
      {
        "rating_value": 3,
        "rating_count": 0,
        "rating_percent": 0
      },
      {
        "rating_value": 4,
        "rating_count": 0,
        "rating_percent": 0
      },
      {
        "rating_value": 5,
        "rating_count": 6,
        "rating_percent": 86
      }
    ]
  },
  "default_variant": "pLTF118100",
  "pars_view_type": "default",
  "badges": [],
  "from_url": "https://www.vivantis.sk/parfumy/?page=2"
}
```

Each product returns a rich record with 40+ fields containing detailed information:

#### Product Identification

| Field | Description |
|---|---|
| `Code` | Unique product code or SKU within Vivantis |
| `ID` | Internal Vivantis product identifier |
| `UUID` | Universally unique identifier for the product |
| `Master Code` | Primary code for multi-variant products |
| `URL Relative` | Product page URL path (relative to domain) |

#### Pricing & Availability

| Field | Description |
|---|---|
| `Price` | Current product price (base price without VAT) |
| `Currency` | Currency of the price (e.g., EUR, SKK) |
| `Price VAT` | Price including Value Added Tax |
| `Unit Price` | Price per unit of measurement (for per-item or per-quantity pricing) |
| `Online` | Boolean flag indicating if product is available for online purchase |
| `Stocks` | Current inventory level or stock status |
| `Delivery Text` | Shipping/delivery information text (e.g., "Same-day delivery available") |
| `Delivery Date` | Expected delivery date or timeframe |
| `Price Action` | Price change status or discount flag |

#### Product Details

| Field | Description |
|---|---|
| `Name` | Product title/name as displayed on Vivantis |
| `Description` | Full product description including ingredients, uses, and benefits |
| `Brands` | Product brand(s) (e.g., "Chanel", "Dior", "Paco Rabanne") |
| `Sections` | Product category (e.g., "Parfumy", "Kosmetika", "Vlasová Kozmetika") |
| `Sections All` | Complete category hierarchy/breadcrumb path |
| `Shop` | Seller or shop information |
| `New` | Flag indicating if product is newly listed |
| `Product Test Score` | Rating or test score if available |

#### Product Attributes & Flags

| Field | Description |
|---|---|
| `Pars` | Product parameters/attributes (e.g., volume, scent type, concentration) |
| `Pars View Type` | How parameters are displayed or categorized |
| `Default Variant` | Default product variant if multiple versions exist |
| `Has Pars Different Price` | Boolean: true if different variants have different prices |
| `Has Pars Different Percent` | Boolean: true if variants have different percentage differences |
| `Perfume Composition Match Ratio` | Match score for perfume composition similarity (if available) |
| `Badges` | Special labels like "Best Seller", "Sale", "New" |
| `Badges Prioritized` | Primary/featured badges displayed prominently |
| `Flash Sale Propagation` | Flash sale indicator and propagation status |
| `Is Bquality` | Quality flag for B-grade or discounted products |
| `Is Violating Google Policy` | Compliance flag for Google Shopping policies |

#### Review & Engagement

| Field | Description |
|---|---|
| `Review Summary` | Aggregated customer review score or summary |
| `Order` | Product ranking or sort order in results |

#### Media

| Field | Description |
|---|---|
| `Image List` | Array of product image URLs (thumbnail, detail, etc.) |

***

### How to Use

1. **Identify target URLs** — Navigate Vivantis category or search pages and note the URLs you want to scrape (e.g., product category pages, filtered search results).

2. **Prepare input JSON** — Add URLs to the `urls` array. Set `max_items_per_url` based on expected product count per page (typically 20–200 products).

3. **Configure error handling** — Set `ignore_url_failures: true` for resilience in bulk operations (recommended for multi-domain runs).

4. **Run the scraper** — Execute and monitor the run log for progress.

5. **Download results** — Export as JSON, CSV, or Excel for analysis, price monitoring, or database import.

**Best practices:**

- Test with a single URL first before bulk runs
- Use `max_items_per_url: 200` to capture complete pages
- Set `ignore_url_failures: true` when scraping across multiple regional domains
- Scrape during off-peak hours to reduce server load

**Common issues:**

- If products are missing, verify the URL is a search/category page, not a detail page
- If blocked, increase delays or use rotation strategies
- Missing prices may indicate out-of-stock products or regional unavailability

***

### Use Cases & Business Value

- **Price intelligence:** Monitor beauty product pricing across Vivantis regional sites to identify arbitrage opportunities
- **Competitive analysis:** Track competitor product availability, pricing strategies, and promotion patterns
- **Inventory aggregation:** Integrate Vivantis products into multi-vendor marketplaces or comparison sites
- **Market research:** Analyze beauty and perfume trends by region, brand popularity, and seasonal demand
- **Review analysis:** Scrape customer review summaries to assess product sentiment and quality perception

The Vivantis Product Scraper transforms manual browsing into automated, scalable data collection — enabling rapid market insights and reliable product integration.

***

### Conclusion

The **Vivantis Product Scraper** is a powerful tool for anyone needing structured beauty and perfume product data across Central and Eastern European markets. With 40+ data fields, multi-domain support, and flexible configuration, it delivers the product intelligence you need — without the manual effort. Start scraping today and unlock competitive advantage through data-driven decision making.

# 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.vivantis.sk/parfumy/?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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.vivantis.sk/parfumy/?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/vivantis-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.vivantis.sk/parfumy/?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/vivantis-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.vivantis.sk/parfumy/?page=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}' |
apify call stealth_mode/vivantis-product-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=stealth_mode/vivantis-product-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Vivantis Product Search Scraper",
        "description": "Scrape beauty and fragrance product listings from Hondoscenter with precision. Capture SKUs, prices, stock status, ratings, images, and 30+ fields per product — perfect for price monitoring, inventory sync, and ecommerce analytics.",
        "version": "0.0",
        "x-build-id": "0NplHgsvGy6bOCG45"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/stealth_mode~vivantis-product-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-stealth_mode-vivantis-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~vivantis-product-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-stealth_mode-vivantis-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~vivantis-product-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-stealth_mode-vivantis-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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
