# Kuantokusta Product Search Scraper (`stealth_mode/kuantokusta-product-search-scraper`) Actor

Scrape product listings from Kuantokusta.pt with complete pricing, offers, and brand data. Collect 27+ fields including prices, ratings, images, and store offers — perfect for price aggregators, market analysis, and competitive intelligence.

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

## Kuantokusta Product Scraper: Extract Price Comparison Data at Scale

---

### What Is Kuantokusta.pt?

Kuantokusta.pt is Portugal's leading price comparison platform, aggregating millions of product listings across electronics, home goods, beauty, and more. It consolidates offers from multiple retailers, displaying competitive pricing, ratings, and store details in a single interface. For businesses monitoring market trends, building price aggregators, or conducting competitive analysis, manually scraping this data is inefficient — the **Kuantokusta Product Scraper** automates extraction of structured product intelligence.

---

### Overview

The **Kuantokusta Product Scraper** extracts product search results from Kuantokusta.pt, transforming listings into clean, structured datasets. It is ideal for:

- **Price aggregators** creating multi-retailer price feeds
- **Market researchers** analyzing product availability and pricing trends
- **E-commerce businesses** benchmarking competitor pricing
- **Deal hunters** tracking price drops and store offers
- **Data analysts** building datasets for market research

Key features include bulk URL processing with per-URL item limits, multi-store offer aggregation, flexible error handling, and complete product metadata including images, ratings, and promotional badges.

---

### Input Format

The scraper accepts a JSON configuration specifying which Kuantokusta product list pages to crawl:

```json
{
  "urls": [
    "https://www.kuantokusta.pt/c/1421/rosto?pag=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}
````

| Field | Description |
|---|---|
| `urls` | Array of Kuantokusta product list page URLs (search results, category pages, filtered pages) |
| `max_items_per_url` | Maximum products extracted per page (e.g., `200`). Default is `20`. Increase for comprehensive collection. |
| `ignore_url_failures` | If `true`, the scraper skips failed URLs and continues. If `false`, stops on first error. Recommended: `true` for bulk runs. |

**Finding URLs:** Navigate to Kuantokusta.pt, select a category or use search filters, then copy the resulting page URL. The scraper will extract all products from that list.

***

### Output Format

**Example Output Fragment:**

```json
{
  "id": 10758432,
  "badges": {
    "is_best_price": false,
    "deal_discount_percentage": 0
  },
  "brand": "Essence",
  "category_id": 1421,
  "created_at": null,
  "ean": [
    "4059729394330"
  ],
  "image_thumbnail": "https://s1.kuantokusta.pt/img_upload/produtos_saudebeleza/848781_2_essence-natural-matte-mousse-base-espumosa-tom-01-16-g.jpg",
  "images": [
    "https://s1.kuantokusta.pt/img_upload/produtos_saudebeleza/848781_3_essence-natural-matte-mousse-base-espumosa-tom-01-16-g.jpg"
  ],
  "name": "Essence Natural Matte Mousse Base Espumosa Tom 01 16 g",
  "old_product_id": "p-9-848781",
  "price_max": 6.49,
  "price_min": 3.23,
  "rating": {
    "rating_count": 0,
    "reviews_count": 0
  },
  "sku": [],
  "tags": {
    "in_stock": true,
    "adult_only": false,
    "top50": 0,
    "is_marketplace": true,
    "is_financeable": false,
    "is_floapay_illegible": false,
    "is_klarna": false,
    "is_fast_delivery": true
  },
  "updated_at": "2026-06-19T08:51:23.090Z",
  "url": "/p/10758432/essence-natural-matte-mousse-base-espumosa-tom-01-16-g",
  "variations": [],
  "total_offers": 4,
  "short_description": null,
  "store_old_price_discount": {
    "store_id": 7740,
    "old_price": 5.18,
    "discount_percentage": 19
  },
  "offers": [
    {
      "is_highlighted": true,
      "product_id": 10758432,
      "seller_id": 13157,
      "badges": {},
      "business_rules": {
        "cpc": {
          "is_clickable": true,
          "active": true
        },
        "mkt": {
          "active": false
        }
      },
      "created_at": null,
      "last_checked_at": "2026-06-19T08:35:37.000Z",
      "logo": "https://s1.kuantokusta.pt/img_upload/logins/13157_1.png",
      "old_price": 0,
      "payment_methods": [],
      "price": 3.23,
      "product_name": "essence BASE NATURAL MATTE MOUSSE, matificante, cubriente, expresión del resultado, mate (16g) - B0BQZ2SH21",
      "promotional_phrase": null,
      "rating": {
        "rating_count": 0,
        "reviews_count": 0,
        "url": null
      },
      "score": 0.4427500000000001,
      "shipping": {
        "expected_delivery_date": null,
        "minimum_price": 2.99
      },
      "store_name": "Amazon Spain",
      "store_slug": "amazon-spain",
      "total_price": 6.22,
      "updated_at": "2026-06-19T08:51:22.316Z",
      "id": null,
      "loyalty_points": 0,
      "loyalty_points_per_euro_ratio": 0,
      "filters": {
        "is_fast_delivery": false,
        "has_split_payment": false,
        "is_free_shipping": false,
        "is_marketplace": false,
        "is_shipped_to_islands": false,
        "has_old_price_discount": false
      }
    },
    {
      "is_highlighted": true,
      "product_id": 10758432,
      "seller_id": 9006,
      "badges": {
        "is_fast_delivery": true,
        "is_marketplace": true
      },
      "business_rules": {
        "cpc": {
          "is_clickable": false,
          "active": false,
          "url": null
        },
        "mkt": {
          "active": true
        }
      },
      "created_at": null,
      "last_checked_at": "2026-06-18T23:20:55.000Z",
      "logo": "https://s1.kuantokusta.pt/img_upload/logins/9006_1.png",
      "old_price": 0,
      "payment_methods": [],
      "price": 6.49,
      "product_name": "Essence Natural Matte Mousse Foundation Even Finish 01 16Gr",
      "promotional_phrase": null,
      "rating": {
        "rating_count": 4.3,
        "reviews_count": 915,
        "url": "https://www.opinioes-verificadas.com/avis-clients/beautyon.pt?utm_source=kuantokusta&utm_medium=website&utm_campaign=catalog"
      },
      "score": 0.40949857506361326,
      "shipping": {
        "expected_delivery_date": "2026-06-22T09:25:41.544Z",
        "minimum_price": 1.99,
        "expected_delivery_between": {
          "max": "2026-06-22T09:25:41.544Z",
          "min": "2026-06-19T09:25:41.544Z"
        },
        "is_next_day_delivery": false,
        "is_delivery_highlighted": true
      },
      "store_name": "BeautyOn",
      "store_slug": "beautyon",
      "total_price": 8.48,
      "updated_at": "2026-06-19T08:51:22.316Z",
      "id": null,
      "loyalty_points": 12,
      "loyalty_points_per_euro_ratio": 2,
      "filters": {
        "is_fast_delivery": true,
        "has_split_payment": false,
        "is_free_shipping": false,
        "is_marketplace": true,
        "is_shipped_to_islands": true,
        "has_old_price_discount": false
      }
    },
    {
      "is_highlighted": false,
      "product_id": 10758432,
      "seller_id": 12424,
      "badges": {},
      "business_rules": {
        "cpc": {
          "is_clickable": true,
          "active": true
        },
        "mkt": {
          "active": false
        }
      },
      "created_at": null,
      "last_checked_at": "2026-06-18T23:48:05.000Z",
      "logo": "https://s1.kuantokusta.pt/img_upload/logins/12424_1.png",
      "old_price": 4.99,
      "payment_methods": [],
      "price": 4.85,
      "product_name": "Essence Natural Matte Mousse Foundation - Tom 01",
      "promotional_phrase": null,
      "rating": {
        "rating_count": 0,
        "reviews_count": 0,
        "url": null
      },
      "score": 0.33314949109414765,
      "shipping": {
        "expected_delivery_date": null,
        "minimum_price": 3.3
      },
      "store_name": "A Tua Farmácia",
      "store_slug": "a-tua-farmacia",
      "total_price": 8.15,
      "updated_at": "2026-06-19T08:51:22.316Z",
      "id": null,
      "loyalty_points": 0,
      "loyalty_points_per_euro_ratio": 0,
      "filters": {
        "is_fast_delivery": false,
        "has_split_payment": false,
        "is_free_shipping": false,
        "is_marketplace": false,
        "is_shipped_to_islands": false,
        "has_old_price_discount": false
      }
    },
    {
      "is_highlighted": true,
      "product_id": 10758432,
      "seller_id": 12910,
      "badges": {},
      "business_rules": {
        "cpc": {
          "is_clickable": true,
          "active": true
        },
        "mkt": {
          "active": false
        }
      },
      "created_at": null,
      "last_checked_at": "2026-06-19T01:14:58.000Z",
      "logo": "https://s1.kuantokusta.pt/img_upload/logins/12910_1.png",
      "old_price": 0,
      "payment_methods": [],
      "price": 4.2,
      "product_name": "essence NATURAL MATTE MOUSSE base espumosa tom 01 16 g",
      "promotional_phrase": null,
      "rating": {
        "rating_count": 0,
        "reviews_count": 0,
        "url": null
      },
      "score": 0.31775,
      "shipping": {
        "expected_delivery_date": null,
        "minimum_price": 5.95
      },
      "store_name": "Notino",
      "store_slug": "notino",
      "total_price": 10.15,
      "updated_at": "2026-06-19T08:51:22.316Z",
      "id": null,
      "loyalty_points": 0,
      "loyalty_points_per_euro_ratio": 0,
      "filters": {
        "is_fast_delivery": false,
        "has_split_payment": false,
        "is_free_shipping": false,
        "is_marketplace": false,
        "is_shipped_to_islands": false,
        "has_old_price_discount": false
      }
    }
  ],
  "available_offer_filters": [
    {
      "highlight_order": null,
      "is_highlighted": false,
      "tag": "isFastDelivery",
      "translation_label": "Entrega Rápida"
    },
    {
      "highlight_order": 1,
      "is_highlighted": true,
      "tag": "isMarketplace",
      "translation_label": "Comprar no KuantoKusta"
    },
    {
      "highlight_order": null,
      "is_highlighted": false,
      "tag": "isShippedToIslands",
      "translation_label": "Entrega nas Ilhas"
    }
  ],
  "top_box_offer": {
    "is_highlighted": true,
    "product_id": 10758432,
    "seller_id": 9006,
    "badges": {
      "is_fast_delivery": true,
      "is_marketplace": true
    },
    "business_rules": {
      "cpc": {
        "is_clickable": false,
        "active": false,
        "url": null
      },
      "mkt": {
        "active": true
      }
    },
    "created_at": null,
    "last_checked_at": "2026-06-18T23:20:55.000Z",
    "logo": "https://s1.kuantokusta.pt/img_upload/logins/9006_1.png",
    "old_price": 0,
    "payment_methods": [],
    "price": 6.49,
    "product_name": "Essence Natural Matte Mousse Foundation Even Finish 01 16Gr",
    "promotional_phrase": null,
    "rating": {
      "rating_count": 4.3,
      "reviews_count": 915,
      "url": "https://www.opinioes-verificadas.com/avis-clients/beautyon.pt?utm_source=kuantokusta&utm_medium=website&utm_campaign=catalog"
    },
    "score": 0.40949857506361326,
    "shipping": {
      "expected_delivery_date": "2026-06-22T09:25:41.544Z",
      "minimum_price": 1.99,
      "expected_delivery_between": {
        "max": "2026-06-22T09:25:41.544Z",
        "min": "2026-06-19T09:25:41.544Z"
      },
      "is_next_day_delivery": false,
      "is_delivery_highlighted": true
    },
    "store_name": "BeautyOn",
    "store_slug": "beautyon",
    "total_price": 8.48,
    "updated_at": "2026-06-19T08:51:22.316Z",
    "id": null,
    "loyalty_points": 12,
    "loyalty_points_per_euro_ratio": 2,
    "filters": {
      "is_fast_delivery": true,
      "has_split_payment": false,
      "is_free_shipping": false,
      "is_marketplace": true,
      "is_shipped_to_islands": true,
      "has_old_price_discount": false
    }
  },
  "settings": {
    "active_offers_ads": true,
    "hour_limit_for_next_day_delivery": 15,
    "price_comparison": {
      "minimum_discount_percentage": 5,
      "average_price": 4.06,
      "average_price_date": "2026-06-17T00:00:00.000Z"
    }
  },
  "category": "Rosto",
  "from_url": "https://www.kuantokusta.pt/c/1421/rosto?pag=2"
}
```

Each scraped product record contains 27 fields covering pricing, metadata, images, and store offers:

#### Product Identification

| Field | Meaning |
|---|---|
| `ID` | Unique Kuantokusta product identifier |
| `Name` | Product title or name |
| `SKU` | Stock Keeping Unit for inventory tracking |
| `EAN` | European Article Number (barcode) |
| `URL` | Direct link to the product on Kuantokusta.pt |
| `Old Product ID` | Legacy product identifier (if applicable) |

#### Pricing & Offers

| Field | Meaning |
|---|---|
| `Price Min` | Lowest current offer price across all stores |
| `Price Max` | Highest current offer price across all stores |
| `Store Old Price Discount` | Historical discounts or previous pricing |
| `Offers` | Array of all store offers with prices, retailer info, and availability |
| `Top Box Offer` | The best offer (lowest price or featured retailer) |
| `Available Offer Filters` | Filter options for sorting offers (e.g., by price, shipping) |
| `Total Offers` | Count of competing offers available |

#### Product Details & Content

| Field | Meaning |
|---|---|
| `Brand` | Manufacturer or brand name |
| `Category` | Primary product category |
| `Category ID` | Internal category identifier |
| `Short Description` | Brief product summary or tagline |
| `Tags` | Keywords or product attributes (size, color, etc.) |
| `Badges` | Visual badges (e.g., "Best Price," "In Stock," promotions) |
| `Rating` | Average customer rating (if available) |

#### Media & Timestamps

| Field | Meaning |
|---|---|
| `Image Thumbnail` | URL of product thumbnail image |
| `Images` | Array of full-resolution product images |
| `Created At` | Date product was added to Kuantokusta |
| `Updated At` | Last timestamp the record was refreshed |

#### Advanced Data

| Field | Meaning |
|---|---|
| `Variations` | Available product variants (size, color, capacity, etc.) |
| `Settings` | Configuration options or scraper-specific metadata |

***

### How to Use

1. **Identify target categories** — Browse Kuantokusta.pt and find product lists you want to scrape (e.g., "Beauty," "Electronics," filtered search results).
2. **Copy list page URLs** — Grab the full URL from your browser's address bar (e.g., `https://www.kuantokusta.pt/c/1421/rosto?pag=2`).
3. **Configure the input** — Paste URLs into the `urls` array. Set `max_items_per_url` to control dataset size (higher = more products per page).
4. **Enable error tolerance** — Set `ignore_url_failures: true` to skip blocked or unavailable pages without interrupting the run.
5. **Execute and export** — Run the actor, monitor progress, and download results as JSON, CSV, or Excel.

**Best practices:**

- For category crawls with multiple pages, add separate URLs for each pagination level.
- Use `max_items_per_url: 200` for complete page collection; lower values for sampling.
- Export data immediately after completion to preserve pricing accuracy (offers change frequently).

***

### Use Cases & Business Value

- **Real-time price monitoring:** Track competitor pricing and promotions across retailers
- **Margin analysis:** Compare your pricing against market benchmarks
- **Product intelligence:** Build datasets for catalog management and market research
- **Deal aggregation:** Create feeds of trending products or discounted items
- **Market entry analysis:** Understand pricing strategies in the Portuguese market

By automating Kuantokusta data extraction, teams eliminate manual spreadsheet work, enabling data-driven pricing strategies and faster market insights.

***

### Conclusion

The **Kuantokusta Product Scraper** is the fastest way to extract competitive pricing and product data from Portugal's leading price comparison platform. With 27 data fields and flexible configuration, it powers everything from simple price checks to sophisticated market analysis. Start collecting structured product intelligence today.

# 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.kuantokusta.pt/c/1421/rosto?pag=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.kuantokusta.pt/c/1421/rosto?pag=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/kuantokusta-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.kuantokusta.pt/c/1421/rosto?pag=2"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/kuantokusta-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.kuantokusta.pt/c/1421/rosto?pag=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}' |
apify call stealth_mode/kuantokusta-product-search-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Kuantokusta Product Search Scraper",
        "description": "Scrape product listings from Kuantokusta.pt with complete pricing, offers, and brand data. Collect 27+ fields including prices, ratings, images, and store offers — perfect for price aggregators, market analysis, and competitive intelligence.",
        "version": "0.0",
        "x-build-id": "eAEwHJswoG2tPguzB"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/stealth_mode~kuantokusta-product-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-stealth_mode-kuantokusta-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~kuantokusta-product-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-stealth_mode-kuantokusta-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~kuantokusta-product-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-stealth_mode-kuantokusta-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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
