{ "openapi": "3.0.1", "info": { "title": "Mercado Libre Product Scraper - Prices, Discounts & Sales", "description": "For price tracking, best-seller research and dropshipping: Mercado Libre products by search or category in Mexico, Brazil, Argentina, Colombia, Chile, Peru and Uruguay. Price, discount, units sold, rating, Full. Export as Excel, CSV or JSON. Monitoring returns new products and price drops.", "version": "0.1", "x-build-id": "jDoOYJVeXDraZFVOl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~mercado-libre-product-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-mercado-libre-product-search", "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/neverempty~mercado-libre-product-search/runs": { "post": { "operationId": "runs-sync-neverempty-mercado-libre-product-search", "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/neverempty~mercado-libre-product-search/run-sync": { "post": { "operationId": "run-sync-neverempty-mercado-libre-product-search", "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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "What you would type in the Mercado Libre search box, one per line, in the language of the country (for example iphone 15, licuadora, geladeira frost free, notebook lenovo). Each term is searched in the country below. Products that appear under several terms are returned once.", "items": { "type": "string" } }, "categoryUrls": { "title": "Mercado Libre search or category addresses (optional)", "type": "array", "description": "Paste one or more addresses from a Mercado Libre product list, for example https://listado.mercadolibre.com.mx/celulares-telefonos/celulares-smartphones/ or https://lista.mercadolivre.com.br/geladeira . The country is taken from the address. A category address without a search term is searched once for each search term above.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "mx", "br", "ar", "co", "cl", "pe", "uy" ], "type": "string", "description": "The Mercado Libre site to search for the search terms. Prices come in that country's currency (some listings in Argentina, Peru and Uruguay are priced in USD and keep USD). Ignored for pasted addresses.", "default": "mx" }, "maxProducts": { "title": "Maximum products", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many product rows to return in total across all searches. Each returned product is one charged result. Mercado Libre shows up to 2,016 products for one search; to get more, add more search terms, categories or price ranges.", "default": 100 }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "price-asc", "price-desc" ], "type": "string", "description": "The order Mercado Libre lists products in. With a maximum below the number of results, this decides which products you get.", "default": "relevance" }, "condition": { "title": "Condition", "enum": [ "any", "new", "used" ], "type": "string", "description": "Return only new or only used products.", "default": "any" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Lowest price, in the country's own currency (MXN, BRL, ARS...). 0 = no minimum. Listings priced in another currency (for example USD in Argentina) cannot be compared and are left out when a price range is set.", "default": 0 }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Highest price, in the country's own currency. 0 = no maximum.", "default": 0 }, "onlyFreeShipping": { "title": "Only free shipping", "type": "boolean", "description": "Return only products Mercado Libre shows with free shipping.", "default": false }, "onlyFull": { "title": "Only Full (shipped by Mercado Libre)", "type": "boolean", "description": "Return only products stored and shipped by Mercado Libre (the Full badge).", "default": false }, "onlyOfficialStores": { "title": "Only official stores", "type": "boolean", "description": "Return only products sold by an official store (Tienda oficial / Loja oficial).", "default": false }, "excludeSponsored": { "title": "Leave out sponsored products", "type": "boolean", "description": "Leave out the ads Mercado Libre places among the results.", "default": false }, "minRating": { "title": "Minimum rating", "pattern": "^([0-4](\\.[0-9])?|5(\\.0)?)$", "type": "string", "description": "Lowest star rating from 0 to 5, for example 4.5. 0 = keep products without a rating too.", "default": "0" }, "minDiscountPercent": { "title": "Minimum discount %", "minimum": 0, "maximum": 99, "type": "integer", "description": "Return only products whose price is at least this many percent below the original price Mercado Libre shows. 0 = no discount needed.", "default": 0 }, "excludeKeywords": { "title": "Leave out titles containing", "type": "array", "description": "Words that remove a product when they appear in its title, for example funda, case, capinha, reacondicionado. Not case-sensitive.", "items": { "type": "string" } }, "maxPagesPerSearch": { "title": "Maximum pages per search", "minimum": 0, "maximum": 42, "type": "integer", "description": "Stop each search after this many result pages (48 products per page). 0 = as many as needed for the maximum above.", "default": 0 }, "monitoringMode": { "title": "Monitoring mode (only new products and price drops)", "type": "boolean", "description": "For scheduled runs. The first run with an input remembers every product and its price and returns nothing (not charged). Later runs with the same input return only products that were not there before and, if chosen below, products whose price went down.", "default": false }, "watchPriceDrops": { "title": "Also return price drops", "type": "boolean", "description": "In monitoring mode, also return products already seen whose price is now lower (same currency only), with the previous price and the drop in percent.", "default": true }, "minPriceDropPercent": { "title": "Minimum price drop %", "minimum": 0, "maximum": 99, "type": "integer", "description": "In monitoring mode, ignore price drops smaller than this percentage. 0 = every drop.", "default": 0 }, "resetMonitoringState": { "title": "Forget what monitoring remembered", "type": "boolean", "description": "Clear the products remembered for this input. The next monitoring run starts again with a free first run.", "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 } } } } } } } } } }