# SuperTop Argentina Scraper - Precios, Ofertas y Stock (`latinamericadata/supertop-argentina`) Actor

Extrae productos de SuperTop Argentina por búsqueda o categoría. Obtén precios, ofertas, stock, SKU, EAN, marcas y URLs en Dataset, JSON, CSV, Excel o API.

- **URL**: https://apify.com/latinamericadata/supertop-argentina.md
- **Developed by:** [Latin America Data](https://apify.com/latinamericadata) (community)
- **Categories:** Automation, E-commerce, Integrations
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 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

## SuperTop Argentina Scraper - Precios, Ofertas y Stock

Extraé productos de SuperTop Argentina por búsqueda o categoría y obtené precios, ofertas, stock, SKU, EAN, marcas, vendedores y URLs auditables. El Actor guarda los resultados en un Dataset de Apify listo para descargar como JSON, CSV o Excel, o para consumir desde una API.

Este scraper SuperTop está preparado para búsquedas y palabras clave como **SuperTop Argentina API**, **precios SuperTop Argentina**, **stock SuperTop**, **ofertas SuperTop**, **productos de supermercado** y **comparador de precios**. Podés combinar términos de búsqueda con categorías para relevar un producto, una marca o una sección completa del catálogo.

Es una herramienta independiente: no es una API oficial de SuperTop Argentina ni está afiliada, respaldada u operada por SuperTop. Extrae información disponible públicamente y no accede a cuentas de clientes ni a datos privados.

### Para qué sirve este Actor

El Actor automatiza la consulta del catálogo público de SuperTop Argentina y normaliza cada combinación de SKU y vendedor en una fila. Permite pasar de una búsqueda manual a un flujo repetible, exportable y auditable.

| Objetivo | Cómo ayuda el Actor |
|---|---|
| Buscar productos | Consulta uno o varios términos mediante `searchTerms`. |
| Recorrer categorías | Acepta IDs, rutas o URLs de categoría mediante `categories`. |
| Controlar el alcance | Limita resultados y páginas con `maxItems` y `maxPages`. |
| Auditar los datos | Conserva `source_url`, `request_url` y `scraped_at`. |
| Obtener más contexto | Con `withDetails` incorpora descripción, especificaciones, promociones y cuotas. |

### Casos de uso

- Monitoreo periódico de precios y stock de SuperTop Argentina.
- Seguimiento de ofertas, descuentos y precios de lista.
- Comparación de surtido, marcas y categorías.
- Análisis de disponibilidad por SKU y vendedor.
- Investigación de mercado para fabricantes, distribuidores y equipos de retail.
- Alimentación de tableros, alertas, agentes y procesos ETL.
- Construcción de una capa de API SuperTop Argentina para flujos internos, sin presentarla como una API oficial.

### Qué datos entrega

Cada fila exitosa representa una combinación de SKU y vendedor.

| Grupo | Campos principales | Contenido |
|---|---|---|
| Estado y origen | `status`, `country`, `source`, `input_type`, `input_value` | Estado técnico y objetivo que originó la fila. |
| Identificación | `product_id`, `sku_id`, `ean`, `product_name`, `sku_name` | IDs, EAN y nombres del producto. |
| Clasificación | `brand`, `category`, `categories` | Marca y jerarquía de categorías. |
| Precio y oferta | `price`, `list_price`, `discount_percent`, `currency` | Precio actual, precio de lista, descuento calculado y moneda. |
| Stock y vendedor | `available`, `available_quantity`, `seller_id`, `seller` | Disponibilidad informada y vendedor. |
| Detalles opcionales | `installment_count`, `installment_value`, `promotions`, `description`, `specifications` | Cuotas, promociones y contenido ampliado cuando `withDetails` está activo. |
| Evidencia | `image_url`, `source_url`, `request_url`, `scraped_at` | Imagen, URLs de origen y fecha de extracción. |

El Dataset predeterminado solo contiene filas con `status: success`. Los estados operativos `no_results`, `blocked` y `failed` se conservan en `RUN_SUMMARY` y en los logs para facilitar integraciones técnicas sin convertirlos en resultados facturables.

### Ejemplo de entrada

```json
{
  "searchTerms": ["yerba"],
  "maxItems": 100,
  "withDetails": true
}
```

También podés usar `categories` con el ID `2`, la ruta `/alimentos` o la URL `https://www.supertop.com.ar/alimentos`. Si omitís `maxItems` y `maxPages`, el Actor continúa hasta completar el alcance seleccionado.

### Resultado de ejemplo

Ejemplo simplificado con valores ilustrativos:

```json
{
  "status": "success",
  "country": "AR",
  "source": "SuperTop Argentina",
  "input_type": "search",
  "input_value": "yerba",
  "page": 1,
  "rank": 1,
  "product_id": "12345",
  "sku_id": "67890",
  "ean": "7790000000000",
  "product_name": "Yerba mate 1 kg",
  "sku_name": "Yerba mate 1 kg",
  "brand": "Marca de ejemplo",
  "category": "Almacén",
  "price": 4500,
  "list_price": 5000,
  "discount_percent": 10,
  "currency": "ARS",
  "available": true,
  "available_quantity": 25,
  "seller": "SuperTop Argentina IO",
  "source_url": "https://www.supertop.com.ar/yerba-mate-producto-de-ejemplo/p",
  "request_url": "https://www.supertop.com.ar/api/catalog_system/pub/products/search?ft=yerba",
  "scraped_at": "2026-07-18T12:00:00Z",
  "error_message": null
}
```

### Inicio rápido

1. Abrí el Actor en Apify y cargá uno o más valores en `searchTerms`, o indicá categorías en `categories`.
2. Definí `maxItems` o `maxPages` si querés limitar la ejecución.
3. Activá `withDetails` si necesitás descripciones, especificaciones, promociones y cuotas.
4. Ejecutá el Actor.
5. Revisá el Dataset o exportalo como JSON, CSV o Excel.

### Input

| Campo | Tipo | Valor predeterminado | Descripción |
|---|---|---|---|
| `searchTerms` | array de strings | `["yerba"]` | Productos, marcas o palabras clave. |
| `categories` | array de strings | — | IDs, rutas o URLs completas de categoría. |
| `maxItems` | integer | sin límite | Máximo total de filas de SKU y vendedor. |
| `maxPages` | integer | sin límite | Máximo de páginas por búsqueda o categoría. |
| `startPage` | integer | `1` | Primera página solicitada a VTEX. |
| `pageSize` | integer | `50` | Productos solicitados por página. |
| `sortOrder` | string | `OrderByNameASC` | Orden determinista de los resultados. |
| `withDetails` | boolean | `true` | Agrega descripción, especificaciones, promociones y cuotas. |
| `includeUnavailable` | boolean | `false` | Incluye SKU y vendedores sin stock. |
| `requestDelayMillis` | integer | `100` | Demora entre solicitudes, en milisegundos. |
| `requestTimeoutSecs` | integer | `45` | Tiempo máximo de espera por solicitud. |
| `retries` | integer | `3` | Intentos máximos ante fallas transitorias. |
| `failOnNoResults` | boolean | `false` | Hace fallar la ejecución en vez de devolver `no_results`. |

### Precios

El Actor utiliza pago por evento con una tarifa plana y predecible:

| Concepto | Importe y aplicación |
|---|---|
| `result` (evento principal) | USD 0.003 por cada producto/SKU guardado en el Dataset predeterminado mediante `apify-default-dataset-item`; equivale a USD 3.00 cada 1.000 resultados. |
| Actor start | Evento sintético de Apify de USD 0.00005 por ejecución. Al estar definido, Apify no cobra el uso de plataforma de los primeros 5 segundos de la ejecución. |

`result` es el evento principal que Apify muestra para comunicar el precio. `withDetails` no cambia la tarifa: una fila con detalles cuesta lo mismo que una fila compacta. Las filas operativas `no_results`, `blocked` y `failed` no se guardan en el Dataset ni se cobran como `result`; el cargo de Actor start sí puede aplicar a la ejecución. El uso restante de la plataforma Apify queda a cargo del usuario.

Si el usuario define un máximo total de cobro para la ejecución, el Actor reduce `maxItems` preventivamente y conserva el menor límite entre ese presupuesto y el valor solicitado.

### API, agentes y exportaciones

Podés ejecutar el Actor desde Apify Console, programaciones, REST API, clientes de JavaScript o Python, MCP y flujos con agentes. El Dataset se puede consultar por API o descargar como JSON, CSV y Excel.

En automatizaciones, esta salida funciona como una API SuperTop Argentina orientada a precios y stock: enviás el input, esperás la ejecución y consumís filas normalizadas. Se trata de una interfaz creada por este Actor, no de una API oficial de SuperTop.

### Preguntas frecuentes

#### ¿Necesita inicio de sesión?

No. Consulta el contrato público del catálogo VTEX y no accede a cuentas de clientes ni a información privada.

#### ¿Puedo buscar por palabra clave y por categoría?

Sí. Usá `searchTerms` para productos, marcas o palabras clave y `categories` para IDs, rutas o URLs de categoría.

#### ¿Cómo evita duplicados?

Usa paginación determinista y deduplica cada combinación de SKU y vendedor antes de guardar o cobrar el resultado.

#### ¿Qué pasa si no encuentra productos?

No agrega filas al Dataset. Registra `no_results` en `RUN_SUMMARY` y en los logs, sin cobrar un evento `result`; el evento Actor start sí puede aplicar. Si activás `failOnNoResults`, la ejecución falla en ese escenario.

#### ¿Los precios y el stock son en tiempo real?

Son una captura del catálogo al momento indicado por `scraped_at`. Pueden cambiar después de la extracción y variar según ubicación, tienda o condiciones comerciales.

### Fuente, límites y uso responsable

La fuente es el catálogo público de SuperTop Argentina. La disponibilidad, los precios, las promociones y las cuotas pueden variar por ubicación y cambiar sin aviso. El sitio también puede modificar su contrato público, límites o estructura.

El Actor incorpora una demora configurable entre solicitudes. Usalo con una frecuencia razonable, verificá los datos antes de tomar decisiones y respetá los términos aplicables, la normativa vigente y los derechos sobre marcas y contenidos.

### Independencia

Este Actor es una herramienta de datos independiente. No está afiliado, respaldado, autorizado ni operado por SuperTop Argentina. “SuperTop” y las demás marcas mencionadas pertenecen a sus respectivos titulares.

# Actor input Schema

## `searchTerms` (type: `array`):

Uno o más productos, marcas o palabras clave para buscar.

## `categories` (type: `array`):

IDs de categoría VTEX, rutas o URLs completas de SuperTop. Por ejemplo: `2`, `/alimentos` o `https://www.supertop.com.ar/alimentos`. Este campo es opcional.

## `maxItems` (type: `integer`):

Cantidad máxima opcional de registros de SKU y vendedor que se guardarán entre todos los objetivos.

## `maxPages` (type: `integer`):

Límite opcional de páginas para cada búsqueda o categoría. Si lo omitís, la paginación continúa hasta agotar los resultados.

## `startPage` (type: `integer`):

Primera página de VTEX que se solicitará, comenzando desde 1.

## `pageSize` (type: `integer`):

Cantidad de productos solicitados a VTEX por página. VTEX admite hasta 50.

## `sortOrder` (type: `string`):

Un orden determinista evita productos duplicados entre páginas desplazadas de VTEX.

## `withDetails` (type: `boolean`):

Incluye descripción, especificaciones, promociones y datos de cuotas. El precio por resultado sigue siendo USD 0.003.

## `includeUnavailable` (type: `boolean`):

Incluye SKU y vendedores sin stock cuando esta opción está activada.

## `requestDelayMillis` (type: `integer`):

Demora respetuosa entre solicitudes de páginas de VTEX, expresada en milisegundos.

## `requestTimeoutSecs` (type: `integer`):

Cantidad máxima de segundos de espera para cada solicitud al catálogo.

## `retries` (type: `integer`):

Cantidad máxima de intentos ante una falla transitoria en una solicitud al catálogo.

## `failOnNoResults` (type: `boolean`):

Hace fallar la ejecución cuando no hay coincidencias. En caso contrario, el Dataset queda vacío y el estado `no_results` se guarda en `RUN_SUMMARY`.

## Actor input object example

```json
{
  "searchTerms": [
    "yerba"
  ],
  "maxItems": 100,
  "startPage": 1,
  "pageSize": 50,
  "sortOrder": "OrderByNameASC",
  "withDetails": true,
  "includeUnavailable": false,
  "requestDelayMillis": 100,
  "requestTimeoutSecs": 45,
  "retries": 3,
  "failOnNoResults": false
}
```

# Actor output Schema

## `results` (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 = {
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("latinamericadata/supertop-argentina").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 = { "maxItems": 100 }

# Run the Actor and wait for it to finish
run = client.actor("latinamericadata/supertop-argentina").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 '{
  "maxItems": 100
}' |
apify call latinamericadata/supertop-argentina --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

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