{ "openapi": "3.0.1", "info": { "title": "Mercado Libre Price Tracker Scraper – Monitor de Precios", "description": "Mercado Libre price tracker scraper: monitor official stores and get only what changed, like price drops and increases, discounts, new and removed products. Chile, Argentina, Mexico, Brazil, Colombia. No login. Monitor de precios para tiendas oficiales.", "version": "0.1", "x-build-id": "g7X8yk0jyl9ATVTyQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ener90~mercadolibre-seller-price-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ener90-mercadolibre-seller-price-monitor", "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/ener90~mercadolibre-seller-price-monitor/runs": { "post": { "operationId": "runs-sync-ener90-mercadolibre-seller-price-monitor", "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/ener90~mercadolibre-seller-price-monitor/run-sync": { "post": { "operationId": "run-sync-ener90-mercadolibre-seller-price-monitor", "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": { "officialStores": { "title": "Official stores", "type": "array", "description": "Official store slugs or URLs, e.g. samsung or https://www.mercadolibre.cl/tienda/samsung. Tracks the products shown on the store's storefront. No credentials needed.", "items": { "type": "string" } }, "items": { "title": "Listings (URLs or IDs)", "type": "array", "description": "Listing URLs or IDs like MLC1234567890. Requires Mercado Libre API credentials (below). Advanced: needs your own Mercado Libre OAuth access; may be blocked (HTTP 403).", "items": { "type": "string" } }, "sellers": { "title": "Sellers (ID or nickname)", "type": "array", "description": "Seller IDs or nicknames, tracked through the official search API. Mercado Libre restricted this endpoint in 2025, so it works only with an API token that still has access. Advanced: needs your own Mercado Libre OAuth access; may be blocked (HTTP 403).", "items": { "type": "string" } }, "site": { "title": "Site / country", "enum": [ "MLC", "MLA", "MLM", "MLB", "MCO", "MLU", "MPE", "MEC" ], "type": "string", "description": "Default site for slugs and bare IDs. Store URLs override it.", "default": "MLC" }, "trackPrice": { "title": "Track price", "type": "boolean", "description": "Report price changes.", "default": true }, "trackDiscount": { "title": "Track discount label", "type": "boolean", "description": "Report changes of the discount badge (e.g. 30% OFF).", "default": false }, "trackStock": { "title": "Track stock", "type": "boolean", "description": "Report available quantity changes (API sources only; storefront pages don't show stock).", "default": true }, "trackListings": { "title": "Track new / removed listings", "type": "boolean", "description": "Report listings that appear or disappear.", "default": true }, "trackStatus": { "title": "Track status", "type": "boolean", "description": "Report status changes (active, paused, closed, not_found).", "default": true }, "minChangePercent": { "title": "Min price change %", "minimum": 0, "maximum": 100, "type": "integer", "description": "Ignore price changes smaller than this percentage (e.g. 5 = only changes of 5% or more). Ignored changes are not charged.", "default": 0 }, "onlyPriceDrops": { "title": "Only price drops", "type": "boolean", "description": "Report price decreases only (increases are ignored and not charged).", "default": false }, "outputBaseline": { "title": "Output baseline on first run", "type": "boolean", "description": "On the first run (no previous snapshot) also write every listing as a BASELINE row.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Snapshots are kept in a named key-value store per monitor name. Use different names for different watch lists.", "default": "default" }, "resetBaseline": { "title": "Reset baseline", "type": "boolean", "description": "Ignore the saved snapshot and start over.", "default": false }, "mlClientId": { "title": "Mercado Libre app ID (optional)", "type": "string", "description": "From developers.mercadolibre.com. Needed for listings and sellers." }, "mlClientSecret": { "title": "Mercado Libre app secret", "type": "string", "description": "Used only to get a token; never logged or stored." }, "mlAccessToken": { "title": "Mercado Libre access token", "type": "string", "description": "Alternative to app ID + secret." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Use Apify Proxy (e.g. RESIDENTIAL) if store pages get blocked.", "default": { "useApifyProxy": 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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }