{ "openapi": "3.0.1", "info": { "title": "📉 Monitor de Precios Mercado Libre — Alerta de Baja y Stock", "description": "El Keepa de Mercado Libre (AR/MX/CL/CO/UY/PE): monitoreo de precios y stock de una watchlist — o de una búsqueda/categoría — con alerta de baja, alza, agotado/repuesto y nueva oferta. No es un scraper de snapshot: entrega solo el DELTA entre ejecuciones. Pagá por cambio, no por barrido.", "version": "0.1", "x-build-id": "aqoZpxFd5kQnwI6QI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/paulovitor18~mercado-libre-monitor-precios/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-paulovitor18-mercado-libre-monitor-precios", "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/paulovitor18~mercado-libre-monitor-precios/runs": { "post": { "operationId": "runs-sync-paulovitor18-mercado-libre-monitor-precios", "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/paulovitor18~mercado-libre-monitor-precios/run-sync": { "post": { "operationId": "run-sync-paulovitor18-mercado-libre-monitor-precios", "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": { "sitio": { "title": "País / Sitio de Mercado Libre", "enum": [ "AR", "MX", "CL", "CO", "UY", "PE" ], "type": "string", "description": "El país de Mercado Libre a monitorear. Define el dominio (AR mercadolibre.com.ar · MX mercadolibre.com.mx · CL mercadolibre.cl · CO mercadolibre.com.co · UY mercadolibre.com.uy · PE mercadolibre.com.pe), el país del proxy residencial y la moneda de referencia. Los productos de tu watchlist deben ser del país seleccionado (el prefijo del ID ya indica el país: MLA=AR, MLM=MX, MLC=CL, MCO=CO, MLU=UY, MPE=PE).", "default": "AR" }, "productos": { "title": "Productos a vigilar (watchlist)", "type": "array", "description": "Lista de productos de Mercado Libre a monitorear. Pegá la URL del producto (ej.: \"https://www.mercadolibre.com.ar/p/MLA22826188\") o solo el código del ítem (\"MLA...\", \"MLM...\", etc.). En cada ejecución el monitor lee precio, stock y oferta de cada uno y reporta solo lo que CAMBIÓ desde la ejecución anterior.", "default": [ "https://www.mercadolibre.com.ar/p/MLA22826188" ], "items": { "type": "string" } }, "busqueda": { "title": "Búsqueda a monitorear (modo búsqueda — alternativa a la watchlist)", "type": "string", "description": "MODO BÚSQUEDA (alternativa a la watchlist de arriba). En vez de vigilar productos fijos, vigilá el FEED DE RESULTADOS de una búsqueda de Mercado Libre. Informá un TÉRMINO (ej.: \"notebook\", \"iphone 15\") O una URL de búsqueda/categoría del sitio seleccionado (ej.: \"https://listado.mercadolibre.com.ar/notebook\"). El monitor lee los cards del tope de los resultados (hasta el tope de abajo) y reporta solo lo que CAMBIÓ: productos que entraron (producto_nuevo), salieron (producto_salio), o tuvieron baja/alza de precio, cambio de stock o de oferta. Dejalo VACÍO para usar el modo watchlist normal. Si está completado, el modo búsqueda tiene prioridad y la watchlist se ignora en esa ejecución (el estado de los dos modos es separado). El tope \"Productos por ejecución\" y la \"Variación mínima\" de abajo también valen acá. La búsqueda usa el dominio del sitio elegido arriba.", "default": "" }, "variacion_minima_pct": { "title": "Variación mínima de precio para alertar (%)", "minimum": 0, "maximum": 90, "type": "integer", "description": "Filtro de ruido: solo emite alerta_precio cuando la variación de precio, EN ESA ejecución, sea de al menos este porcentaje (en módulo). 0 = alerta cualquier cambio de precio. Ej.: 5 = solo avisa bajas/alzas de 5% o más. Es un filtro por ejecución (no acumula variaciones pequeñas entre runs).", "default": 0 }, "max_productos": { "title": "Tope de productos por ejecución", "minimum": 1, "maximum": 150, "type": "integer", "description": "Límite de seguridad de cuántos productos de la watchlist se renderizan por ejecución (control de costo/tiempo — cada producto es un render headless de ~25-30s, secuencial). El excedente se ignora en esa ejecución (señalado en el log). Mantenido bajo para caber en la ventana de ejecución; para listas más grandes, dividí en watchlists/agendamientos separados (stateStoreName propio por lista). En el modo búsqueda, el tope también define la ventana monitoreada (el top-N de la búsqueda).", "default": 90 }, "stateStoreName": { "title": "Nombre del almacenamiento de estado (avanzado)", "type": "string", "description": "Dónde persiste el historial de precios de tu watchlist entre ejecuciones. Dejalo VACÍO para usar el estado por defecto de esta cuenta — tu lista puede crecer/achicarse a voluntad (ítem nuevo = retrato inicial, ítem removido sale del estado; no reinicia el monitor). Completá con un nombre propio SOLO si querés correr LISTAS INDEPENDIENTES en paralelo (una por agendamiento): cada nombre es un monitor aislado.", "default": "" }, "modo": { "title": "Modo", "enum": [ "auto", "baseline" ], "type": "string", "description": "auto = la 1ª ejecución es el retrato inicial (baseline) y las siguientes reportan el delta. baseline = fuerza un nuevo retrato inicial (rebase del estado actual, sin cobrar alerta) — usalo para poner en cero el historial de la watchlist.", "default": "auto" }, "proxy": { "title": "Proxy", "type": "object", "description": "Ruteo de red. El país del proxy residencial se toma del SITIO elegido arriba. Mercado Libre exige IP residencial del país para hidratar la página de producto; no desactives el proxy a menos que sepas lo que hacés.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AR" } }, "self_test": { "title": "Modo diagnóstico (regresión del fixture-pack)", "type": "boolean", "description": "No usar en producción. Ignora la watchlist y corre la batería de known-answers del motor de parse (producto InStock, producto sin stock, input inválido, producto inexistente) + la prueba de delta, para probar que el parser y la semántica de cambio siguen correctos.", "default": false } } }, "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 } } } } } } } } } }