# Éxito Scraper Ultra (`knowten/exito-scraper`) Actor

Obtén información de productos, precios y ofertas en exito.com Colombia. Diseñado con arquitectura de alta velocidad.  Permite filtrar por marcas, categorías o usar el Modo Descubrimiento para identificar filtros dinámicos. Listo para exportar en JSON y Excel.

- **URL**: https://apify.com/knowten/exito-scraper.md
- **Developed by:** [Knowten](https://apify.com/knowten) (community)
- **Categories:** E-commerce, Agents
- **Stats:** 4 total users, 0 monthly users, 100.0% runs succeeded, 5 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $1.00 / 1,000 resultados

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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

## Exito Supermarket & Retail Data Extractor 🛒🇨🇴

Desbloquea el catálogo completo de **exito.com**, una de las cadenas de retail, tecnología y supermercados más grandes de Colombia. Obtén acceso inmediato y en tiempo real a miles de productos, precios actualizados, descuentos, marcas y especificaciones técnicas detalladas.

Diseñado con tecnología de extracción inteligente de alta velocidad y conexión directa optimizada, este actor garantiza la máxima velocidad, fiabilidad y eficiencia de costos del mercado.

---

### 🌟 Casos de Uso Principales

- **📉 Monitoreo de Precios y Competencia**: Rastrea cambios de precios diarios, ofertas relámpago y promociones para ajustar tu estrategia comercial.
- **📊 Investigación de Mercado**: Analiza qué marcas dominan cada categoría y descubre tendencias de mercado en Colombia.
- **🛍️ Enriquecimiento de Catálogos y E-commerce**: Sincroniza productos con tu propia tienda online o base de datos en cuestión de minutos.

---

### 🔍 Modo Descubrimiento (`discovery_mode`)

> [!IMPORTANT]
> **¿CÓMO FUNCIONAN LOS FILTROS EN ÉXITO?**
> En Éxito.com, cada categoría tiene filtros únicos (por ejemplo: la categoría *Televisores* tiene el filtro `resolucion-de-la-pantalla`, mientras que *Calzado* tiene `talla`).
> 
> Si deseas conocer exactamente qué filtros existen para una búsqueda específica, activa el **Modo Descubrimiento (`discovery_mode: true`)**.

> [!WARNING]
> **ATENCIÓN SOBRE EL MODO DESCUBRIMIENTO:**
> Este modo se utiliza **SOLAMENTE** para detectar e identificar la lista de filtros válidos y sus opciones disponibles para una búsqueda.
> **EL MODO DESCUBRIMIENTO NO EXTRAE PRODUCTOS.**
>
> Una vez que identifiques la clave y el valor del filtro que te interesa (ej. `resolucion-de-la-pantalla=Uhd-4K` o `talla=40`), **desactiva** el Modo Descubrimiento (`discovery_mode: false`) y coloca esos valores en los selectores de entrada o en el campo **Filtros Dinámicos Adicionales (`custom_filters`)**.

---

### 🚀 Flujo de Trabajo Recomendado

1. **Paso 1 (Opcional - Descubrir Filtros)**:
   - Ingresa tu palabra clave en `search_term` (ej. `televisor`).
   - Activa `discovery_mode: true`.
   - Ejecuta el actor. Obtendrás un listado estructurado con todos los filtros disponibles para esa búsqueda (ej. Clave: `resolucion-de-la-pantalla`, Opciones: `Uhd-4K`, `Full-Hd`, etc.).
2. **Paso 2 (Configurar Búsqueda Normal)**:
   - Desactiva `discovery_mode: false`.
   - Si el filtro que deseas está en los menú desplegables (Departamento, Marca, etc.), selecciónalo directamente.
   - Si es un filtro específico descubierto en el Paso 1, escríbelo en **Filtros Dinámicos Adicionales (`custom_filters`)** con el formato `Clave=Valor` (ej: `resolucion-de-la-pantalla=Uhd-4K`).
3. **Paso 3 (Ejecutar y Descargar)**:
   - Ejecuta el actor y descarga los resultados en **JSON, CSV, Excel** o consúmelos directamente por la **API de Apify**.

---

### ⚙️ Parámetros de Entrada (Input)

| Parámetro | Tipo | Descripción | Ejemplo |
| :--- | :--- | :--- | :--- |
| `search_term` | String | Palabra clave o término de búsqueda en Éxito. | `"televisor"` |
| `max_items` | Integer | Cantidad máxima de productos a extraer. Usa `0` para extraer todo el catálogo devuelto. | `100` |
| `discovery_mode` | Boolean | **SOLO para detectar filtros**. Si se activa, devuelve los filtros disponibles y se detiene (NO extrae productos). | `false` |
| `custom_filters` | String | Filtros dinámicos en formato `Clave=Valor` separados por coma. | `"resolucion-de-la-pantalla=Uhd-4K"` |
| `category_1` | String | Selección de Departamento principal. | `"tecnologia"` |
| `category_2` | String | Selección de Categoría secundaria. | `"televisores"` |
| `brand` | String | Selección de Marca. | `"samsung"` |
| `price` | String | Rango de precio en formato `Min:Max`. | `"1000000:3000000"` |

---

### 📊 Ejemplo de Resultados (Output)

#### 1. Salida en Modo Búsqueda Normal (Extracción de Productos)

```json
{
  "ID": "3688427",
  "Nombre": "Televisor SAMSUNG 58 pulgadas LED Uhd4K Smart TV",
  "Marca": "SAMSUNG",
  "Precio_Original": 2399900,
  "Precio_Final": 1699900,
  "URL_Producto": "https://www.exito.com/televisor-samsung-58-pulgadas-led-uhd4k-smart-tv-3688427/p",
  "Informacion_Adicional": {
    "Referencia": "UN58U8000FKXZL",
    "Resolución de la pantalla": "Uhd-4K",
    "Tipo de pantalla": "LED",
    "Tamaño de pantalla": "58\" pulgadas",
    "Garantía": "1 AÑO"
  }
}
````

#### 2. Salida en Modo Descubrimiento (`discovery_mode: true`)

```json
{
  "Filtro": "Resolución de la pantalla",
  "Clave": "resolucion-de-la-pantalla",
  "Opciones": [
    {
      "Nombre": "Uhd-4K",
      "Valor_Slug": "Uhd-4K"
    },
    {
      "Nombre": "Full-HD",
      "Valor_Slug": "Full-HD"
    }
  ]
}
```

***

### 💰 Rentabilidad y Costos

Optimizado para consumir el mínimo de memoria y tiempo de CPU:

- **Solo ~$1 USD por cada 1,000 productos extraídos.**

***

### ⚡ Rendimiento y Alta Disponibilidad

- Arquitectura optimizada para extracción masiva de alta velocidad.
- Sistema de resiliencia automatizado con reintentos inteligentes ante fluctuaciones de red.
- Integración nativa con Apify Proxy para máxima estabilidad y continuidad operativa.

# Actor input Schema

## `search_term` (type: `string`):

Palabra clave a buscar (ej. 'tv', 'celular').

## `category_1` (type: `string`):

Ej: electrodomesticos, tecnologia

## `category_2` (type: `string`):

Ej: accesorios-audio-y-video

## `category_3` (type: `string`):

Ej: televisores

## `brand` (type: `string`):

Ej: samsung, lg

## `price` (type: `string`):

Rango en pesos colombianos. Formato Mínimo:Máximo (Ej: 50000:200000 o 100000:\* para mayor a 100 mil).

## `vendido_por` (type: `string`):

Ej: Éxito

## `max_items` (type: `integer`):

Cantidad de productos a extraer. Usa 0 para sin límite.

## `discovery_mode` (type: `boolean`):

IMPORTANTE: Si se activa, este modo SOLAMENTE detecta e identifica los filtros y opciones disponibles para la búsqueda y se detiene (NO extrae productos). Úsalo para conocer las claves y valores que puedes filtrar.

## `custom_filters` (type: `string`):

Filtros específicos descubiertos previa búsqueda (Formato: Clave=Valor separados por coma). Ej: talla=M, resolucion-de-la-pantalla=Uhd-4K, antiadherente=si

## Actor input object example

```json
{
  "max_items": 100,
  "discovery_mode": false
}
```

# Actor output Schema

## `ID` (type: `string`):

Identificador único del producto en exito.com

## `Nombre` (type: `string`):

Título comercial del producto

## `Marca` (type: `string`):

Marca del producto

## `Precio_Original` (type: `string`):

Precio original de lista en pesos colombianos

## `Precio_Final` (type: `string`):

Precio final de venta con descuento en pesos colombianos

## `URL_Producto` (type: `string`):

Enlace web al producto en Éxito

## `Informacion_Adicional` (type: `string`):

Especificaciones técnicas dinámicas

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("knowten/exito-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("knowten/exito-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 '{}' |
apify call knowten/exito-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Éxito Scraper Ultra",
        "description": "Obtén información de productos, precios y ofertas en exito.com Colombia. Diseñado con arquitectura de alta velocidad.  Permite filtrar por marcas, categorías o usar el Modo Descubrimiento para identificar filtros dinámicos. Listo para exportar en JSON y Excel.",
        "version": "1.0",
        "x-build-id": "fkGhYCsuO3DpG2bh5"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/knowten~exito-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-knowten-exito-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/knowten~exito-scraper/runs": {
            "post": {
                "operationId": "runs-sync-knowten-exito-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/knowten~exito-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-knowten-exito-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": {
                    "search_term": {
                        "title": "Término de búsqueda",
                        "type": "string",
                        "description": "Palabra clave a buscar (ej. 'tv', 'celular')."
                    },
                    "category_1": {
                        "title": "Departamento (category-1)",
                        "enum": [
                            "bebes",
                            "deportes-y-fitness",
                            "electrodomesticos",
                            "eventos-y-temporadas",
                            "herramientas-y-ferreteria",
                            "hogar-y-decoracion",
                            "instrumentos-musicales",
                            "jardin-y-aire-libre",
                            "juguetes-y-juegos",
                            "mercado",
                            "moda-y-accesorios",
                            "papeleria-y-libros",
                            "tecnologia",
                            "vehiculos"
                        ],
                        "type": "string",
                        "description": "Ej: electrodomesticos, tecnologia"
                    },
                    "category_2": {
                        "title": "Categoría (category-2)",
                        "enum": [
                            "accesorios-audio-y-video",
                            "accesorios-de-moda",
                            "accesorios-para-carros",
                            "accesorios-para-celulares",
                            "acondicionamiento-fisico",
                            "adhesivos-y-pegantes-ferreteria",
                            "almohadas-y-cojines",
                            "audio",
                            "bloques-y-armables",
                            "camaras",
                            "camping",
                            "colchones",
                            "computadores",
                            "consolas-y-videojuegos",
                            "decoracion",
                            "dormitorio-bebes-y-ninos",
                            "electricidad-e-iluminacion",
                            "electrodomesticos-de-cocina",
                            "electrodomesticos-de-cuidado-personal",
                            "electrodomesticos-hogar",
                            "estimulacion-y-entretenimiento-del-bebe",
                            "fiesta-y-pinateria",
                            "figuras-de-accion",
                            "griferia-para-bano-y-cocina",
                            "herramientas-electricas",
                            "herramientas-manuales",
                            "insumos-y-accesorios-ferreteria",
                            "jardineria",
                            "juegos-de-mesa",
                            "juguetes",
                            "juguetes-a-control-remoto-y-electronicos",
                            "mascotas",
                            "moda-mujer",
                            "muebles-para-el-hogar",
                            "ollas-y-utensilios-de-cocina",
                            "organizadores-para-el-hogar",
                            "pianos-y-teclados-musicales",
                            "ropa-de-cama",
                            "ropa-interior-para-hombre",
                            "televisores",
                            "utiles-escolares-y-oficina",
                            "video-proyectores"
                        ],
                        "type": "string",
                        "description": "Ej: accesorios-audio-y-video"
                    },
                    "category_3": {
                        "title": "Sub-categoría (category-3)",
                        "enum": [
                            "accesorios-de-computador",
                            "accesorios-para-camping",
                            "accesorios-para-carros",
                            "accesorios-para-el-bano",
                            "accesorios-para-gimnasio",
                            "accesorios-y-decodificadores",
                            "alicates-y-llaves",
                            "almohadas",
                            "almohadas-y-cojines-para-ninos",
                            "amplificadores",
                            "antenas-y-cables",
                            "aspiradoras",
                            "audifonos",
                            "barra-de-sonido",
                            "bicicletas-estaticas-y-elipticas",
                            "bombillos",
                            "cajas-y-canastas-organizadoras",
                            "camaras-de-seguridad",
                            "caminadoras-trotadoras-y-escaladoras",
                            "camisetas-interior-de-hombre",
                            "cojines",
                            "colchones-dobles",
                            "colchones-king",
                            "colchones-queen",
                            "colchones-semidobles",
                            "colchones-sencillos",
                            "comedor",
                            "computadores-de-escritorio-y-all-in-one",
                            "consolas",
                            "control-remoto",
                            "controles-y-accesorios",
                            "cuchillos-y-tablas",
                            "decoracion-para-fiestas",
                            "dormitorio",
                            "extensiones-multitomas-y-reguladores",
                            "figuras-de-accion-y-personajes-animados",
                            "freidoras",
                            "herramientas-de-jardineria",
                            "juegos-de-mesa-y-cartas",
                            "juguetes-estimulacion-y-desarrollo",
                            "juguetes-y-accesorios-mascotas",
                            "lamparas",
                            "maquinas-de-afeitar-electricas",
                            "maquinas-y-multifuncionales",
                            "masajeadores",
                            "monitores",
                            "oficina-y-estudio",
                            "ollas-arroceras",
                            "ollas-y-baterias-de-cocina",
                            "otras-herramientas-electricas",
                            "otras-herramientas-manuales",
                            "otras-marcas-de-televisores",
                            "otros-accesorios",
                            "parlantes",
                            "pegantes-de-ferreteria",
                            "pelotas-y-balones-para-ninos",
                            "pinturas",
                            "planchas-de-ropa",
                            "planchas-y-asadores",
                            "portatiles",
                            "procesadores-de-alimentos-y-trituradores",
                            "protectores-y-estuches",
                            "purificadores-de-aire",
                            "relojes",
                            "reproductores-de-audio",
                            "ropa-interior-para-mujer",
                            "ropa-mujer",
                            "sabanas-y-complementos-de-cama",
                            "sabanas-cobijas-y-edredones-para-ninos",
                            "sala",
                            "sartenes-sets-y-woks",
                            "soportes-para-tv",
                            "taladros-y-destornilladores-electricos",
                            "televisores-caixun",
                            "televisores-challenger",
                            "televisores-finlandek",
                            "televisores-hisense",
                            "televisores-hyundai",
                            "televisores-kalley",
                            "televisores-lg",
                            "televisores-samsung",
                            "televisores-tcl",
                            "termos-y-portacomidas",
                            "torres-de-sonido",
                            "utensilios-de-cocina",
                            "videojuegos"
                        ],
                        "type": "string",
                        "description": "Ej: televisores"
                    },
                    "brand": {
                        "title": "Marca",
                        "enum": [
                            "10",
                            "117b2",
                            "22-grados-de-decoracion",
                            "22-grados-decoracion",
                            "abc",
                            "afdesings",
                            "aisonyung",
                            "aiwa",
                            "akivoy",
                            "alsolneg",
                            "amazon",
                            "ambiente-living",
                            "ameriwood-home",
                            "amur-ideas",
                            "amyove",
                            "android-tv",
                            "anker",
                            "aosom-llc",
                            "apple",
                            "argomtech",
                            "as-seen-on-tv",
                            "ashley-furniture-industries",
                            "asus",
                            "atvaly",
                            "aula",
                            "avc",
                            "avimar",
                            "banzay",
                            "batman",
                            "behringer",
                            "belkin",
                            "belleze",
                            "bertolini",
                            "best-soul",
                            "beta-three",
                            "betcompras",
                            "big-boss",
                            "biny-martin",
                            "body-innovation",
                            "bonno",
                            "bose",
                            "box",
                            "breakermatic",
                            "byl",
                            "bylmo",
                            "c-o",
                            "caixun",
                            "casa-bayur",
                            "central-gamer",
                            "challenger",
                            "cinemac",
                            "clikuutory",
                            "coaster",
                            "colchones-jubilo",
                            "colchones-total-comfort",
                            "colplast",
                            "comercio-hjl",
                            "compaq",
                            "control-smartv",
                            "convenience-concepts",
                            "cosas-inteligentes",
                            "cosmoliving",
                            "creative-labs",
                            "crosley-furniture",
                            "daoder",
                            "dayzok",
                            "debra",
                            "dellthus",
                            "denon",
                            "dko-design-sas",
                            "dobe",
                            "dolphin",
                            "dong-guan-simer-electronics",
                            "doredo",
                            "dormilandia",
                            "dumos",
                            "dvb",
                            "dxg",
                            "e4u",
                            "ekonomodo-design",
                            "emma-oliver",
                            "enclave-audio",
                            "energy-plus",
                            "epson",
                            "ergo-y-health",
                            "ergonomus",
                            "evolutech",
                            "exonica",
                            "fansafurn",
                            "ferrum",
                            "finlandek",
                            "fire",
                            "flaray",
                            "flash-furniture",
                            "fly-sound",
                            "fosmon",
                            "fulgore",
                            "funko",
                            "furinno",
                            "furniture-of-america",
                            "furnx",
                            "futurebatt-inc",
                            "game-box",
                            "general",
                            "generica",
                            "generico",
                            "generico-marca-exclusiva",
                            "genius",
                            "geoyeao",
                            "gimnasio",
                            "gogroove",
                            "google",
                            "hcs350",
                            "hd-vision",
                            "hds-trading-corp",
                            "henn-hart",
                            "hennhart",
                            "hepa-tecnologia",
                            "hi-screen",
                            "hihip",
                            "hisense",
                            "hiwill",
                            "hodedah",
                            "hogar-universal",
                            "hogareto",
                            "home-design",
                            "home-desing",
                            "home-elements",
                            "hommpa",
                            "hongxing",
                            "hotel-dreams",
                            "houagi",
                            "hp",
                            "hyundai",
                            "iceberg",
                            "idealhouse",
                            "iffalcon",
                            "importado-gs",
                            "imusa",
                            "indurama",
                            "innovo",
                            "innovo-led",
                            "innovo-tech",
                            "inval",
                            "ipega",
                            "jaltech",
                            "janus",
                            "jbl",
                            "jd",
                            "jlc",
                            "jojoka",
                            "jummico",
                            "jvc",
                            "jyr-technology",
                            "kaiwi",
                            "kalley",
                            "kaloc",
                            "kar-parts",
                            "kidshop",
                            "klip-xtreme",
                            "kotek",
                            "krono",
                            "kronos",
                            "kshioe",
                            "kts",
                            "kyuck",
                            "larksound",
                            "lego",
                            "lencicol",
                            "lewwiner",
                            "lg",
                            "lgc",
                            "lifetime-home",
                            "lightbek",
                            "linco",
                            "littoak",
                            "logitech",
                            "lulive",
                            "luxoak",
                            "luxurystar",
                            "lz-import",
                            "maderkit",
                            "madesa",
                            "manhattan-comfort",
                            "maos-pets",
                            "maxlin",
                            "mecool",
                            "megacra-limited",
                            "merax",
                            "mercury",
                            "mido",
                            "millwork-holdings",
                            "mini-keyboard",
                            "minikeyboard",
                            "miroir",
                            "modway",
                            "modway-inc",
                            "monarch-specialties",
                            "mont-dolent",
                            "montecarlo",
                            "motorola",
                            "movisun",
                            "muebles-2020",
                            "muebles-molina",
                            "muebles-venecia",
                            "multimuebles",
                            "multitech",
                            "mxq",
                            "mxq-pro",
                            "my-home",
                            "mym-mobile",
                            "mymobile",
                            "nanotec",
                            "nathan-james",
                            "nb",
                            "nb-north-bayou",
                            "nia",
                            "niatec",
                            "nintendo",
                            "noblewell",
                            "north",
                            "north-bayon",
                            "north-bayou",
                            "noskatu",
                            "nrizc",
                            "nt-generation",
                            "nuvitecno",
                            "oem",
                            "oivo",
                            "olimpo",
                            "one-for-all",
                            "one-tech",
                            "oster",
                            "otra-marca",
                            "oxs",
                            "paylesshere",
                            "perduoutlet-com",
                            "philips",
                            "philips-audio",
                            "pix-link",
                            "plus",
                            "polimes",
                            "polk",
                            "pop-rose",
                            "powest",
                            "prodj",
                            "proyector",
                            "rca",
                            "realme",
                            "redragon",
                            "rimax",
                            "roku",
                            "rolanstar",
                            "rp-houseware",
                            "rta",
                            "rta-design",
                            "rta-desing",
                            "rta-muebles",
                            "safavieh",
                            "safdie-co",
                            "sag",
                            "samsung",
                            "samusng",
                            "sandberg-furniture",
                            "sanus",
                            "sanyoac",
                            "sat",
                            "sauder-woodworking",
                            "seguro-exito",
                            "sennheiser",
                            "shimasu",
                            "shuan-tv",
                            "simpli-home-ltd",
                            "simply-turn-on",
                            "sisdata",
                            "skulltrap-electronics",
                            "sky",
                            "sm",
                            "smart-touch",
                            "solbakuilt",
                            "solid-view",
                            "songmics-home",
                            "sonivox",
                            "sony",
                            "soportv",
                            "sorbus",
                            "sound-around",
                            "south-shore-soucs",
                            "stalion-shop",
                            "stephania",
                            "steren",
                            "sunnydaze-decor",
                            "super-tv-box",
                            "surtidas-varias",
                            "sweetcrispy",
                            "swift",
                            "syfrufo",
                            "tangkula",
                            "tatub",
                            "tcl",
                            "tdt",
                            "techgo",
                            "techman",
                            "technosoportes",
                            "tecnohogarjs",
                            "tecnoventas",
                            "tenda",
                            "tezzio",
                            "toproad",
                            "tor-technology",
                            "tp-link",
                            "trond",
                            "tu-home",
                            "turelojs",
                            "tv-box",
                            "tv-box-4k",
                            "tv-direct-llc",
                            "tv-market",
                            "tv-novedades",
                            "tvbox",
                            "ugreen",
                            "uimoso",
                            "ultimea",
                            "uni",
                            "universal",
                            "urban-design",
                            "varias",
                            "vasagle",
                            "vecelo",
                            "virtual-muebles",
                            "virzo",
                            "visivo",
                            "vizio",
                            "vm-hogar",
                            "volteck",
                            "vr-box",
                            "vta",
                            "walker-edison",
                            "water-zoom",
                            "weifeng",
                            "wet-sounds",
                            "whitewood-industries",
                            "wlive",
                            "x-3-pro",
                            "xiaomi",
                            "xilingol",
                            "xkim",
                            "xp-pen",
                            "xtech",
                            "yaheetech",
                            "yamaha",
                            "yes4all",
                            "yeshomy",
                            "yitahome",
                            "zeno",
                            "zpk",
                            "zte"
                        ],
                        "type": "string",
                        "description": "Ej: samsung, lg"
                    },
                    "price": {
                        "title": "Rango de Precio",
                        "type": "string",
                        "description": "Rango en pesos colombianos. Formato Mínimo:Máximo (Ej: 50000:200000 o 100000:* para mayor a 100 mil)."
                    },
                    "vendido_por": {
                        "title": "Vendido por",
                        "type": "string",
                        "description": "Ej: Éxito"
                    },
                    "max_items": {
                        "title": "Máximo de items a extraer",
                        "type": "integer",
                        "description": "Cantidad de productos a extraer. Usa 0 para sin límite.",
                        "default": 100
                    },
                    "discovery_mode": {
                        "title": "Modo Descubrimiento (SOLO detectar filtros)",
                        "type": "boolean",
                        "description": "IMPORTANTE: Si se activa, este modo SOLAMENTE detecta e identifica los filtros y opciones disponibles para la búsqueda y se detiene (NO extrae productos). Úsalo para conocer las claves y valores que puedes filtrar.",
                        "default": false
                    },
                    "custom_filters": {
                        "title": "Filtros Dinámicos Adicionales",
                        "type": "string",
                        "description": "Filtros específicos descubiertos previa búsqueda (Formato: Clave=Valor separados por coma). Ej: talla=M, resolucion-de-la-pantalla=Uhd-4K, antiadherente=si"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
