{ "openapi": "3.0.1", "info": { "title": "Mercado Libre (Mercado Livre) Scraper - Prices & Sold Counts", "description": "Search Mercado Libre / Mercado Livre by keyword in Argentina, Brazil, Mexico, Colombia or Chile, or paste product URLs. Get item ID, title, price, original price, sold count, rating, official store, shipping and link, with optional product-page details. No login, no cookies.", "version": "0.0", "x-build-id": "lFvbUrbMmsmojbuwe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lanternlab318~mercadolibre/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lanternlab318-mercadolibre", "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/lanternlab318~mercadolibre/runs": { "post": { "operationId": "runs-sync-lanternlab318-mercadolibre", "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/lanternlab318~mercadolibre/run-sync": { "post": { "operationId": "run-sync-lanternlab318-mercadolibre", "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": { "searchQueries": { "title": "Search terms", "type": "array", "description": "One search term per line, written as you would type it in the site's search box, in the site's own language: \"zapatillas running\", \"fone bluetooth\", \"pão de queijo\". Every term is searched separately on the country site below and its results are labelled with it. A product that matches several of your terms is returned once and charged once.", "items": { "type": "string" } }, "country": { "title": "Country site", "enum": [ "AR", "BR", "MX", "CO", "CL" ], "type": "string", "description": "Which Mercado Libre site the search terms are searched on. Each country is a separate site with its own listings, prices and currency. Product URLs are always read on the site their own address belongs to.", "default": "AR" }, "maxProducts": { "title": "Max products per search term", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Upper bound on the products one search term may produce, counted in the order Mercado Libre ranks them. Mercado Libre itself serves at most 2,000 results for one search, so a value above that does not reach more.", "default": 50 }, "includeDetails": { "title": "Open each product page for details", "type": "boolean", "description": "The search listing already gives the title, price, currency, original price, rating, sold quantity, official store and shipping label. With this on, every product's own page is opened as well, which adds the condition (new / used / refurbished) for every product, the number of ratings, the seller ID and stock status. It is one extra page per product, so it is slower and charged as a separate product-details event.", "default": false }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Optional. Product pages to read directly: a seller's listing (articulo.mercadolibre.com.ar/MLA-…), a catalogue product (…/p/MLA…) or a user product (…/up/MLAU…), on any of the five sites. Paste the product's own address as your browser shows it; links copied from an ad (click1.…) are refused because following them would register a paid ad click. Each URL row always includes the product-page details.", "items": { "type": "string" } }, "maxUpstreamRequests": { "title": "Max page requests", "minimum": 1, "type": "integer", "description": "Hard ceiling on the pages this run opens on Mercado Libre: search pages, product pages, session warm-up pages and retries together. At the ceiling collection stops - the inputs not reached are written with partialReason \"upstream_request_cap\" and the run then ends normally. Leave empty and the Actor works a ceiling out from your input, so a run is never unbounded." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "The proxy the pages are opened through. Mercado Libre sends datacenter IPs and visitors from other countries to its sign-in page, so the default is Apify residential proxy, and the exit country is always set to each site's own country automatically.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }