# Primor Product Search Scraper (`stealth_mode/primor-product-search-scraper`) Actor Scrape Primor.eu product search results with ease. This scraper collects product IDs, ratings, reviews, images, user data, and 25+ fields per listing — perfect for price monitoring, competitor analysis, and beauty market research. - **URL**: https://apify.com/stealth\_mode/primor-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, NaN 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 ## Primor.eu Product Search Scraper: Extract Beauty Product Listings at Scale --- ### What Is Primor.eu? Primor.eu is a major Spanish beauty and perfume retailer, offering thousands of products across skincare, fragrance, makeup, and haircare. Its search pages aggregate product listings with rich metadata including ratings and reviews. Manually collecting this data across hundreds of search queries is impractical — the **Primor.eu Product Search Scraper** automates extraction and delivers structured records ready for analysis. --- ### Overview The **Primor Product Search Scraper** crawls Primor.eu search result pages and extracts detailed product and review data per listing. Designed for: - **E-commerce analysts** benchmarking product ratings and review volume - **Brand managers** monitoring consumer sentiment on Primor's platform - **Researchers** studying beauty market trends in Spanish-speaking markets - **Developers** building product feeds or comparison tools --- ### Input Format ```json { "ignore_url_failures": true, "max_items_per_url": 200, "urls": [ "https://www.primor.eu/es_es/?page=3&query=dior" ] } ```` | Field | Type | Description | |---|---|---| | `urls` | `array` | URLs of Primor.eu product search result pages to scrape. Supports multiple URLs. Example: `https://www.primor.eu/es_es/?page=3&query=dior` | | `max_items_per_url` | `integer` | Maximum number of items to collect per URL. Default: `20`. Set higher (e.g., `200`) for full-page extraction. | | `ignore_url_failures` | `boolean` | If `true`, skips failed URLs and continues the run instead of stopping. Recommended for bulk runs. Default: `true`. | > **Tip:** To paginate through results, increment the `page` parameter across multiple URLs (e.g., `?page=1`, `?page=2`). Use the `query` parameter to target specific brands or categories (e.g., `query=chanel`). *** ### Output Format **Sample output** ```json { "tagging": { "add2cart": "https://api.empathy.co/tagging/v1/track/primor/add2cart?q=dior&lang=es&store=es&scope=desktop&title=DIOR+HOMME+INTENSE+Eau+de+Parfum+Intense&productId=M-4AM00949&position=2&page=1&url=https%3A%2F%2Fwww.primor.eu%2Fes_es%2Fdior-dior-homme-intense-eau-de-parfum-intense-112289.html&follow=false&origin=url%3Aexternal&type=4&filtered=true&filters=store%3Aes&spellcheck=false", "click": "https://api.empathy.co/tagging/v1/track/primor/click?q=dior&lang=es&scope=desktop&store=es&title=DIOR+HOMME+INTENSE+Eau+de+Parfum+Intense&productId=M-4AM00949&position=2&page=1&url=https%3A%2F%2Fwww.primor.eu%2Fes_es%2Fdior-dior-homme-intense-eau-de-parfum-intense-112289.html&follow=false&origin=url%3Aexternal&type=4&filtered=true&filters=store%3Aes&spellcheck=false", "checkout": "https://api.empathy.co/tagging/v1/track/primor/checkout?q=dior&lang=es&store=es&scope=desktop&title=DIOR+HOMME+INTENSE+Eau+de+Parfum+Intense&productId=M-4AM00949&position=2&page=1&url=https%3A%2F%2Fwww.primor.eu%2Fes_es%2Fdior-dior-homme-intense-eau-de-parfum-intense-112289.html&follow=false&origin=url%3Aexternal&type=4&filtered=true&filters=store%3Aes&spellcheck=false", "display_click": "https://api.empathy.co/tagging/v1/track/primor/displayClick?q=dior&lang=es&scope=desktop&store=es&title=DIOR+HOMME+INTENSE+Eau+de+Parfum+Intense&productId=M-4AM00949&position=2&page=1&url=https%3A%2F%2Fwww.primor.eu%2Fes_es%2Fdior-dior-homme-intense-eau-de-parfum-intense-112289.html&follow=false&origin=url%3Aexternal&type=4&filtered=true&filters=store%3Aes&spellcheck=false" }, "images": null, "document_type": 1, "number_variants": 3, "variant_value": "50 ML", "link": "https://www.primor.eu/es_es/dior-dior-homme-intense-eau-de-parfum-intense-112289.html", "rating": 4.8, "link_app": "localhost/product-detail/M-4AM00949", "availability": "true", "variants": [ { "sale_price": 82.95, "variant_attribute_id": 854, "variant_value": "50 ML", "link": "https://www.primor.eu/es_es/dior-dior-homme-intense-eau-de-parfum-intense-112289.html#854=66330", "variant_option_id": 66330, "link_app": "localhost/product-detail/M-4AM00949", "availability": "true", "image_link": "https://cdn2.primor.eu/media/catalog/product/cache/d6783718319e1115c892a6ee4029f50a/3/3/3348900838178_1f94.jpg", "variant_id": "51332" }, { "sale_price": 115.95, "variant_attribute_id": 854, "variant_value": "100 ML", "link": "https://www.primor.eu/es_es/dior-dior-homme-intense-eau-de-parfum-intense-112289.html#854=66333", "variant_option_id": 66333, "link_app": "localhost/product-detail/M-4AM00949", "availability": "true", "image_link": "https://cdn2.primor.eu/media/catalog/product/cache/d6783718319e1115c892a6ee4029f50a/3/3/3348900838185_966a.jpg", "variant_id": "51333" }, { "sale_price": 137.99, "variant_attribute_id": 854, "variant_value": "150 ML", "link": "https://www.primor.eu/es_es/dior-dior-homme-intense-eau-de-parfum-intense-112289.html#854=66331", "variant_option_id": 66331, "link_app": "localhost/product-detail/M-4AM00949", "availability": "true", "image_link": "https://cdn2.primor.eu/media/catalog/product/cache/d6783718319e1115c892a6ee4029f50a/3/3/3348901001120_6055.jpg", "variant_id": "51334" } ], "title": "DIOR HOMME INTENSE Eau de Parfum Intense", "hide_discount_price": true, "image_link": "https://cdn2.primor.eu/media/catalog/product/cache/d6783718319e1115c892a6ee4029f50a/3/3/3348900838178_1f94.jpg", "score": 34000056.0, "item_id": null, "categories": [ "Eau de parfum (EDP)", "Perfumes para hombres", "Perfumes" ], "id": "112289-51332-es", "sku": "M-4AM00949", "brand": "Dior", "name": null, "product_id": "112289", "sale_price": 82.95, "ocultar_pvr": true, "url": null, "count_reviews": 61, "external_id": "M-4AM00949", "boost_id": null, "ocultar_dto_pvr": true, "prices": null, "from_url": "https://www.primor.eu/es_es/?page=5&query=dior" } ``` Each scraped item returns a review/product record with 25+ fields: #### Core Identifiers | Field | Meaning | |---|---| | `ID` | Unique identifier for the review or product record | | `Product` | Associated product metadata (name, ID, URL) | | `Original Product` | Source product reference, useful when product data has been remapped | | `User` | Reviewer profile data (username, ID, avatar) | #### Review Content | Field | Meaning | |---|---| | `Rating` | Numeric score given by the reviewer | | `Good Text` | Positive aspects noted in the review | | `Bad Text` | Negative aspects noted in the review | | `Addition Text` | Additional freeform comments | | `Review Type` | Category of review (e.g., verified purchase, editorial) | | `Is Recommended` | Whether the reviewer recommends the product | | `Is Translated` | Whether the review was auto-translated from another language | | `Rewrite Badge` | Indicates if the review text was AI-assisted or rewritten | | `Blind` | Whether the review is hidden/blinded from public view | | `Is Validated` | Whether the review passed a validation check | | `Validation Popup Text` | Message shown when a validation flag is triggered | #### Dates & Timestamps | Field | Meaning | |---|---| | `Created At` | Timestamp when the review was first submitted | | `Modified At` | Timestamp of the last edit to the review | #### Engagement Metrics | Field | Meaning | |---|---| | `Like Count` | Total likes received on the review | | `Comment Count` | Number of comments on the review | | `View Count` | How many times the review has been viewed | | `Likes` | Detailed like data (user IDs or counts) | | `User Review Count` | Total number of reviews submitted by this user | #### User Interaction State | Field | Meaning | |---|---| | `Is Liked` | Whether the current session user has liked this review | | `Is Scrapped` | Whether the review has been saved/bookmarked | | `Is Followed` | Whether the current user follows the reviewer | #### Gamification & Events | Field | Meaning | |---|---| | `Is Ggom Event` | Whether the review is part of a special platform event | | `Ggom Event Popup Text` | Text shown for the associated event popup | #### Media | Field | Meaning | |---|---| | `Images` | Array of image URLs attached to the review | *** ### How to Use 1. **Build your search URL** — Go to Primor.eu, search for a brand or product (e.g., `dior`), and copy the URL including the `query` and `page` parameters. 2. **Configure input** — Paste URLs into the `urls` array. Adjust `max_items_per_url` based on how many results per page you need. 3. **Handle pagination** — Add multiple URLs with incrementing `page` values to collect across all search pages. 4. **Run the scraper** — Start the actor. Enable `ignore_url_failures: true` for uninterrupted bulk runs. 5. **Export** — Download results as JSON, CSV, or Excel. **Common issues:** - If no results return, confirm the URL loads product results in a browser before adding it. - For queries with few results, `max_items_per_url` can be set lower to avoid empty iterations. *** ### Use Cases & Business Value - **Brand monitoring:** Track ratings and sentiment for specific brands (e.g., Dior, Chanel) across Primor's catalog - **Review analysis:** Aggregate `Good Text` and `Bad Text` fields for NLP sentiment pipelines - **Market research:** Understand which products generate the most engagement in the Spanish beauty market - **Content moderation research:** Use `Is Validated`, `Blind`, and `Rewrite Badge` flags to study platform review policies *** ### Conclusion The **Primor.eu Product Search Scraper** turns search result pages into structured datasets with minimal configuration. With detailed review, engagement, and product metadata across 25+ fields, it's a practical tool for anyone analyzing the Spanish beauty retail market. Configure your query, set your page range, and start extracting. # 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.primor.eu/es_es/?page=3&query=dior" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "urls": [ "https://www.primor.eu/es_es/?page=3&query=dior" ], "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/primor-product-search-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "urls": ["https://www.primor.eu/es_es/?page=3&query=dior"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/primor-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.primor.eu/es_es/?page=3&query=dior" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/primor-product-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/primor-product-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Primor Product Search Scraper", "description": "Scrape Primor.eu product search results with ease. This scraper collects product IDs, ratings, reviews, images, user data, and 25+ fields per listing — perfect for price monitoring, competitor analysis, and beauty market research.", "version": "0.0", "x-build-id": "4lGwk7i4cZfvylDlF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~primor-product-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-primor-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~primor-product-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-primor-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~primor-product-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-primor-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 } } } } } } } } } } ```