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