{ "openapi": "3.0.1", "info": { "title": "MercadoLibre Seller Price Monitor – Competitor & Buy Box", "description": "Monitor MercadoLibre sellers, official stores and competitors: per catalog product, the seller's price, rank, gap to the cheapest competitor, MAP violations and price history. Official API, no proxies. Pay per row.", "version": "0.1", "x-build-id": "DRwhMssOD96asHvs0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pricelatam~mercadolibre-seller-price-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pricelatam-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/pricelatam~mercadolibre-seller-price-monitor/runs": { "post": { "operationId": "runs-sync-pricelatam-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/pricelatam~mercadolibre-seller-price-monitor/run-sync": { "post": { "operationId": "run-sync-pricelatam-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", "required": [ "sellers" ], "properties": { "sellers": { "title": "Sellers to monitor", "minItems": 1, "maxItems": 10, "type": "array", "description": "1 to 10 sellers, one per line. Each line can be: the numeric seller ID (e.g. 2923575120); any link containing _CustId_ (open one of the seller's listings and click 'Ver más productos del vendedor' / 'Ver mais produtos do vendedor': that link contains _CustId_ followed by the ID); a profile link such as https://www.mercadolibre.com.co/perfil/NICKNAME; or the bare nickname. A numeric ID always works; a nickname is found among the sellers we already know or in the offers of 'Products where the seller appears'. The prefilled example, 2923575120 (UNIVERSOELECTRONICOCOF), was the Colombian seller with the most active catalog offers in our shared history on 13 Nov 2026.", "default": [ "2923575120" ], "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "MCO", "MLM", "MLA", "MLB", "MLC", "MPE", "MLU", "MEC" ], "type": "string", "description": "MercadoLibre site of the sellers, the search keywords and the products found in our history. Brazil is Mercado Livre.", "default": "MCO" }, "maxProductsPerSeller": { "title": "Max products per seller", "minimum": 1, "maximum": 500, "type": "integer", "description": "Upper limit of catalog products reported per seller: your 'Products where the seller appears' and the products of mapPrices first, then keyword results where the seller sells, then the products where our shared history has an active offer of the seller (most recently seen first).", "default": 50 }, "discoveryProducts": { "title": "Products where the seller appears (optional)", "type": "array", "description": "Catalog product IDs (MCO12345) or product URLs (…/p/MCO12345) to monitor for every seller. They are also used to find sellers given by nickname: every seller with an offer on these products is checked. A seller without an offer on one of them gets a 'no_offer' row for it.", "items": { "type": "string" } }, "queries": { "title": "Search keywords (optional)", "type": "array", "description": "Searches such as 'ipad 11 256gb'. The category is detected automatically; the catalog products found are added for each seller that has an offer on them, and their sellers are checked when resolving nicknames.", "items": { "type": "string" } }, "refreshLive": { "title": "Read live prices", "type": "boolean", "description": "On: every product's offers are read from MercadoLibre now and recorded in the shared price history. Off: the answer comes only from our stored history (faster, but prices are as of the last time anybody checked the product; see scrapedAt).", "default": true }, "condition": { "title": "Offer condition", "enum": [ "new", "used", "any" ], "type": "string", "description": "Condition used for the rank, the best competitor and MAP checks. The shared price history always stores every offer.", "default": "new" }, "mapPrices": { "title": "Minimum advertised prices (MAP, optional)", "type": "object", "description": "Minimum authorized price per catalog product, in its local currency, e.g. {\"MCO50912377\": 2000000}. Every offer of the chosen condition below it is flagged, the monitored seller's own (sellerBelowMap) and competitors' (competitorsBelowMap). These products are always monitored for every seller, like 'Products where the seller appears'." }, "includeCompetitorOffers": { "title": "Include every offer", "type": "boolean", "description": "Attach all offers of the product (seller, nickname when known, price, condition, shipping) to each row.", "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 } } } } } } } } } }