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 Actor supports two scraping modes — use only one at a time:

1. Scrape by URLs — scrape data directly from a list of Kuantokusta product list page URLs.

{
  "urls": [
    "https://www.kuantokusta.pt/c/1421/rosto?pag=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}

2. Scrape by search filters — scrape data using a keyword and additional filters (sorting, price range, etc.) instead of providing URLs.

{
  "keyword": "a",
  "sort_by": "3",
  "price_range": "10_1052",
  "page": 1,
  "max_items_per_url": 200
}

There is also a General settings group that applies to both modes.

1. Scrape by URLs

Use this mode when you already have specific Kuantokusta product list page URLs (search results, category pages, filtered pages). When this mode is used, all options in the "Scrape by search filters" section will be disabled.

Field	Type	Default	Description
urls	array	(required)	One or more Kuantokusta product list page URLs to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.
ignore_url_failures	boolean	true	If true, the scraper continues running when a URL fails instead of stopping the entire run. If false, the run stops on the first error. Recommended: true for bulk runs.

2. Scrape by search filters

Use this mode when you want to search using a keyword and additional filter attributes instead of scraping by URLs. If you use this mode, leave the urls field above empty.

Field	Type	Default	Description
keyword	string	—	The keyword to search for.
sort_by	string ("", 3, 2, 4, 5)	—	Sort results by Relevance (empty), Popularity (3), Cheapest (2), Most expensive (4), Alphabetical (5).
price_range	string	—	Price range to filter by, in min_max format (e.g. 1000_2000).
page	integer	—	The page number to start scraping from.

Note: the source schema lists a 6th sort option, "Newest", but no matching value is defined for it in sort_by — double-check this with the schema owner before relying on it.

3. General settings

Applies to both scraping modes above.

Field	Type	Default	Description
max_items_per_url	integer	20	The maximum number of products to extract per URL/search. Increase (e.g. to 200) for more comprehensive collection.

Finding URLs (for Scrape by URLs mode): 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:

{
  "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.