# Scraper Perfumerías Pigmento Argentina (`pmodinger/perfumerias-pigmento-product-scraper`) Actor Extrae productos de Perfumerías Pigmento Argentina: precios en pesos argentinos, ofertas, descuentos, disponibilidad, EAN, marcas, categorías, imágenes y datos de SKU desde el catálogo público VTEX. - **URL**: https://apify.com/pmodinger/perfumerias-pigmento-product-scraper.md - **Developed by:** [Latin America Data](https://apify.com/pmodinger) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Scraper de precios y ofertas de Perfumerías Pigmento Argentina Extrae datos estructurados de productos de **Perfumerías Pigmento Argentina**: precios en pesos argentinos, ofertas, descuentos, promociones, disponibilidad, EAN/códigos de barra, marcas, categorías, imágenes, cuotas y metadata de SKU desde el catálogo público VTEX. Este Actor de Apify está pensado para Argentina: equipos de ecommerce, pricing, retail intelligence, marcas de belleza, perfumería, cosmética, cuidado capilar, trade marketing, BI, data warehouses, Google Sheets, CRMs y flujos de IA que necesitan monitorear precios y promociones de Perfumerías Pigmento. ### Qué Extrae - Nombre del producto y nombre de SKU - Product ID, SKU ID y referencias internas - EAN / código de barras cuando está disponible - URL del producto en Perfumerías Pigmento - Imagen principal y, opcionalmente, todas las imágenes del SKU - Precio actual en ARS - Precio de lista y precio sin descuento - Porcentaje de descuento - Disponibilidad y cantidad disponible - Vendedor VTEX - Marca y brand ID - Categoría principal, rutas de categorías y category IDs - Unidad de medida y multiplicador - Variantes de SKU como tamaño, color, tono o formato cuando están disponibles - Promociones, colecciones, campañas y descuentos visibles en VTEX - Mejor plan de cuotas sin interés devuelto por el catálogo - Especificaciones técnicas/comerciales - Descripción limpia del producto - URL exacta de request y timestamp de extracción ### Casos de Uso Populares - Monitorear precios de Perfumerías Pigmento Argentina. - Seguir ofertas, descuentos, Hot Sale, Cyber Monday y campañas activas. - Comparar precios de perfumes, maquillaje, skincare, capilares y cuidado personal. - Analizar surtido por marca, categoría y SKU. - Enriquecer catálogos internos con EAN, imágenes, categorías y descripciones. - Crear alertas de cambios de precio o disponibilidad. - Alimentar dashboards de BI, hojas de cálculo, data warehouses y modelos de IA. - Auditar promociones de retail beauty y perfumería en Argentina. - Comparar precios de perfumería argentina frente a otros retailers. - Detectar productos en oferta para estrategias comerciales locales. ### Input Podés scrapear por búsquedas libres, categorías, colecciones VTEX o productos puntuales. ```json { "searchTerms": ["shampoo", "perfume mujer", "protector solar"], "categoryPaths": ["/perfume/mujer", "/capilar/shampoo"], "collectionIds": ["3318"], "maxItems": 100, "pageSize": 24, "sort": "OrderByScoreDESC", "includeUnavailable": true, "includeDescription": true } ```` Categorías útiles: - `/perfume` - `/perfume/mujer` - `/perfume/hombre` - `/maquillaje` - `/maquillaje/labios` - `/capilar` - `/capilar/shampoo` - `/cuidado-de-la-piel` - `/cuidado-personal` También podés pasar URLs completas de categorías o productos desde `https://www.perfumeriaspigmento.com.ar/`. ### Output Cada item del dataset representa un producto/SKU de Perfumerías Pigmento. ```json { "status": "success", "country": "AR", "source": "perfumeriaspigmento.com.ar", "source_url": "https://www.perfumeriaspigmento.com.ar/elvive-shampoo-dream-liso-efecto-keratina/p", "scraped_at": "2026-06-10T12:00:00Z", "input_type": "search", "input_value": "shampoo", "product_id": "31331", "sku_id": "31890", "ean": "7509552964387", "product_name": "Shampoo Elvive Dream Liso", "sku_name": "Shampoo Elvive Dream Liso 400 Ml", "brand": "Elvive", "category": "Shampoo", "categories": ["Capilar/Shampoo", "Capilar"], "price": 7890, "list_price": 11270, "discount_percent": 29.99, "currency": "ARS", "available": true, "available_quantity": 99999, "image_url": "https://perfugroupar.vteximg.com.br/arquivos/ids/...", "promotions": ["30% OFF", "OFERTAS"], "max_installments_without_interest": 6 } ``` ### Precio Precio del Actor en Apify Store: **USD 0.003 por resultado**. Este Actor escribe un item en el default dataset por cada producto/SKU guardado. Está configurado con **Pay per event (PPE)** usando el evento `apify-default-dataset-item` a **USD 0.003**. La configuración del actor incluye `isPPEPlatformUsagePaidByUser: true`, por lo que el usuario final asume también el costo de uso de plataforma cuando Apify lo aplique. ### Fuente Tecnica - Pais: Argentina - Retailer: Perfumerías Pigmento - Website: `https://www.perfumeriaspigmento.com.ar/` - Plataforma: VTEX - Fuente de datos: endpoints públicos de catálogo VTEX - Browser automation: no requerida - Moneda: ARS El Actor usa requests directos al catálogo público, por lo que es más rápido y barato que un scraper basado en navegador. ### Notas y Limitaciones - Precios, descuentos, cuotas y stock pueden variar según sesión, región, reglas comerciales y promociones activas. - El Actor no inicia sesión, no compra productos y no usa cuentas privadas. - Si Perfumerías Pigmento cambia su contrato público VTEX, puede requerirse una actualización del endpoint o normalizador. - Usá `requestDelayMillis` y valores razonables de `maxItems` en corridas recurrentes. - Activá `includeAllImages` o `includeRawData` solo si lo necesitás; aumentan el tamaño del dataset. # Actor input Schema ## `searchTerms` (type: `array`): Búsquedas libres de productos, por ejemplo shampoo, perfume mujer, protector solar, labial o crema facial. ## `categoryUrls` (type: `array`): URLs de categorías de Perfumerías Pigmento, por ejemplo https://www.perfumeriaspigmento.com.ar/perfume/mujer o /capilar/shampoo. ## `categoryPaths` (type: `array`): Rutas VTEX sin dominio, por ejemplo /perfume/mujer, /capilar/shampoo, /maquillaje/labios o /cuidado-de-la-piel/protectores-solares. ## `collectionIds` (type: `array`): IDs VTEX productClusterIds para ofertas o campañas, por ejemplo 3318 para una colección de ofertas si está activa. ## `productUrls` (type: `array`): URLs específicas de productos de Perfumerías Pigmento terminadas en /p. El Actor extrae el slug automáticamente. ## `productSlugs` (type: `array`): Slugs específicos de producto, con o sin /p, por ejemplo elvive-shampoo-dream-liso-efecto-keratina/p. ## `maxItems` (type: `integer`): Cantidad máxima de productos/SKU a guardar entre todos los objetivos. ## `pageSize` (type: `integer`): Cantidad de productos solicitados por página del catálogo VTEX. VTEX suele soportar hasta 50. ## `sort` (type: `string`): Ordenamiento del catálogo VTEX. ## `includeUnavailable` (type: `boolean`): Si está desactivado, se omiten productos sin stock/disponibilidad actual. ## `includeDescription` (type: `boolean`): Si está activado, cada resultado incluye una descripción limpia del producto. Desactivalo para datasets más livianos. ## `includeAllImages` (type: `boolean`): Si está activado, cada resultado incluye todas las URLs de imágenes del SKU. Aumenta el tamaño del dataset. ## `includeRawData` (type: `boolean`): Si está activado, cada resultado incluye el payload crudo de producto, item y vendedor VTEX para debugging o enriquecimiento. ## `requestDelayMillis` (type: `integer`): Demora opcional entre requests al catálogo para reducir presión sobre el sitio fuente. ## `maxRetries` (type: `integer`): Reintentos por request cuando Pigmento devuelve errores transitorios. ## Actor input object example ```json { "searchTerms": [ "shampoo" ], "categoryUrls": [], "categoryPaths": [], "collectionIds": [], "productUrls": [], "productSlugs": [], "maxItems": 50, "pageSize": 24, "sort": "OrderByScoreDESC", "includeUnavailable": true, "includeDescription": true, "includeAllImages": false, "includeRawData": false, "requestDelayMillis": 250, "maxRetries": 2 } ``` # Actor output Schema ## `dataset` (type: `string`): No description ## `summary` (type: `string`): No description # 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 = { "searchTerms": [ "shampoo" ], "categoryUrls": [], "categoryPaths": [], "collectionIds": [], "productUrls": [], "productSlugs": [] }; // Run the Actor and wait for it to finish const run = await client.actor("pmodinger/perfumerias-pigmento-product-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 = { "searchTerms": ["shampoo"], "categoryUrls": [], "categoryPaths": [], "collectionIds": [], "productUrls": [], "productSlugs": [], } # Run the Actor and wait for it to finish run = client.actor("pmodinger/perfumerias-pigmento-product-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 '{ "searchTerms": [ "shampoo" ], "categoryUrls": [], "categoryPaths": [], "collectionIds": [], "productUrls": [], "productSlugs": [] }' | apify call pmodinger/perfumerias-pigmento-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=pmodinger/perfumerias-pigmento-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Scraper Perfumerías Pigmento Argentina", "description": "Extrae productos de Perfumerías Pigmento Argentina: precios en pesos argentinos, ofertas, descuentos, disponibilidad, EAN, marcas, categorías, imágenes y datos de SKU desde el catálogo público VTEX.", "version": "0.1", "x-build-id": "aMaPsuqDsXwWkNSV4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pmodinger~perfumerias-pigmento-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pmodinger-perfumerias-pigmento-product-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/pmodinger~perfumerias-pigmento-product-scraper/runs": { "post": { "operationId": "runs-sync-pmodinger-perfumerias-pigmento-product-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/pmodinger~perfumerias-pigmento-product-scraper/run-sync": { "post": { "operationId": "run-sync-pmodinger-perfumerias-pigmento-product-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": { "searchTerms": { "title": "Búsquedas", "type": "array", "description": "Búsquedas libres de productos, por ejemplo shampoo, perfume mujer, protector solar, labial o crema facial.", "default": [ "shampoo" ], "items": { "type": "string" } }, "categoryUrls": { "title": "URLs de categorías", "type": "array", "description": "URLs de categorías de Perfumerías Pigmento, por ejemplo https://www.perfumeriaspigmento.com.ar/perfume/mujer o /capilar/shampoo.", "items": { "type": "string" } }, "categoryPaths": { "title": "Rutas de categorías", "type": "array", "description": "Rutas VTEX sin dominio, por ejemplo /perfume/mujer, /capilar/shampoo, /maquillaje/labios o /cuidado-de-la-piel/protectores-solares.", "items": { "type": "string" } }, "collectionIds": { "title": "IDs de colecciones", "type": "array", "description": "IDs VTEX productClusterIds para ofertas o campañas, por ejemplo 3318 para una colección de ofertas si está activa.", "items": { "type": "string" } }, "productUrls": { "title": "URLs de productos", "type": "array", "description": "URLs específicas de productos de Perfumerías Pigmento terminadas en /p. El Actor extrae el slug automáticamente.", "items": { "type": "string" } }, "productSlugs": { "title": "Slugs de productos", "type": "array", "description": "Slugs específicos de producto, con o sin /p, por ejemplo elvive-shampoo-dream-liso-efecto-keratina/p.", "items": { "type": "string" } }, "maxItems": { "title": "Máximo de resultados", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Cantidad máxima de productos/SKU a guardar entre todos los objetivos.", "default": 50 }, "pageSize": { "title": "Tamaño de página", "minimum": 1, "maximum": 50, "type": "integer", "description": "Cantidad de productos solicitados por página del catálogo VTEX. VTEX suele soportar hasta 50.", "default": 24 }, "sort": { "title": "Orden", "enum": [ "OrderByScoreDESC", "OrderByTopSaleDESC", "OrderByPriceASC", "OrderByPriceDESC", "OrderByNameASC", "OrderByNameDESC", "OrderByReleaseDateDESC", "OrderByBestDiscountDESC" ], "type": "string", "description": "Ordenamiento del catálogo VTEX.", "default": "OrderByScoreDESC" }, "includeUnavailable": { "title": "Incluir productos no disponibles", "type": "boolean", "description": "Si está desactivado, se omiten productos sin stock/disponibilidad actual.", "default": true }, "includeDescription": { "title": "Incluir descripciones", "type": "boolean", "description": "Si está activado, cada resultado incluye una descripción limpia del producto. Desactivalo para datasets más livianos.", "default": true }, "includeAllImages": { "title": "Incluir todas las imágenes", "type": "boolean", "description": "Si está activado, cada resultado incluye todas las URLs de imágenes del SKU. Aumenta el tamaño del dataset.", "default": false }, "includeRawData": { "title": "Incluir datos crudos", "type": "boolean", "description": "Si está activado, cada resultado incluye el payload crudo de producto, item y vendedor VTEX para debugging o enriquecimiento.", "default": false }, "requestDelayMillis": { "title": "Demora entre requests", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Demora opcional entre requests al catálogo para reducir presión sobre el sitio fuente.", "default": 250 }, "maxRetries": { "title": "Reintentos máximos", "minimum": 0, "maximum": 5, "type": "integer", "description": "Reintentos por request cuando Pigmento devuelve errores transitorios.", "default": 2 } } }, "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 } } } } } } } } } } ```