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

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

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