{ "openapi": "3.0.1", "info": { "title": "MercadoLibre & Mercado Livre Price Tracker (5 countries)", "description": "Track up to 1,000 Mercado Livre / Mercado Libre listings per run in BR, MX, AR, CO and CL: price, old price, discount, stock, units sold, seller, Full, Buy Box winner and what changed since the last run. Schedule it daily, return only changes. Blocked pages are never charged.", "version": "0.1", "x-build-id": "etHjzUGEcU70jpJXc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gangary~mercado-libre-price-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gangary-mercado-libre-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/gangary~mercado-libre-price-monitor/runs": { "post": { "operationId": "runs-sync-gangary-mercado-libre-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/gangary~mercado-libre-price-monitor/run-sync": { "post": { "operationId": "run-sync-gangary-mercado-libre-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", "required": [ "items" ], "properties": { "items": { "title": "Listings to monitor", "type": "array", "description": "Up to 1,000 listings, one per line. Accepts a listing ID (MLB5879370132, MLM-3421917534), a listing URL (produto.mercadolivre.com.br/MLB-..., articulo.mercadolibre.com.mx/MLM-...), a catalog URL with a listing (/p/MLB54495903?pdp_filters=item_id:MLB5879370132), a catalog URL without a listing (/p/MLB62391404: monitors whoever is winning that product; a bare catalog ID such as MLB62391404 works the same way) or a /up/ URL. You can mix countries: Brazil (MLB), Mexico (MLM), Argentina (MLA), Colombia (MCO) and Chile (MLC). Duplicates are removed.", "items": { "type": "string" } }, "checkBuyBox": { "title": "Check the Buy Box winner", "type": "boolean", "description": "For listings inside a catalog product, also read the catalog page to tell whether the listing is the Buy Box winner and who is winning (price and seller). Costs one extra page load per catalog product, shared by all your listings of the same product. Mexico, Argentina, Colombia and Chile also return the number of offers and the lowest price.", "default": true }, "onlyChanges": { "title": "Only return changes", "type": "boolean", "description": "Return a row only for listings whose price, stock, status, seller, Buy Box or shipping changed since your last run (the first run returns everything as a baseline). Every listing is still checked, and you are charged for every listing checked, even when no row is returned. State is kept in a key-value store named mercado-libre-price-monitor-state in your account. Each Apify task has its own history, so two tasks watching the same listing do not affect each other.", "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 }, "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 } } } } } } } } } }