# Scraper Perfumerías Pigmento Argentina (`latinamericadata/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/latinamericadata/perfumerias-pigmento-product-scraper.md
- **Developed by:** [Latin America Data](https://apify.com/latinamericadata) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 pigmento product results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_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("latinamericadata/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# 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("latinamericadata/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 latinamericadata/perfumerias-pigmento-product-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/L8EheCgFGleP87pmS/builds/aMaPsuqDsXwWkNSV4/openapi.json