{ "openapi": "3.0.1", "info": { "title": "MercadoLibre Search Scraper — Price, Seller & Rating", "description": "Scrape MercadoLibre search results across 11 LATAM countries: title, price, discount, seller, rating, reviews, free shipping, installments, and result position. Keyword or search URL. MCP-ready.", "version": "0.1", "x-build-id": "ieWQ3KbDyzzxGNtoo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~mercadolibre-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-mercadolibre-search-scraper", "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/khadinakbar~mercadolibre-search-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-mercadolibre-search-scraper", "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/khadinakbar~mercadolibre-search-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-mercadolibre-search-scraper", "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 keywords", "type": "array", "description": "Free-text keywords to search on MercadoLibre, one per line (e.g. 'celular samsung', 'notebook gamer'). Each keyword runs against the country chosen below and is paginated up to maxResults. Defaults to 'celular'. NOT a URL — to scrape a specific results/category page paste it into startUrls instead.", "items": { "type": "string" } }, "startUrls": { "title": "Search / category URLs", "type": "array", "description": "Full MercadoLibre search or category result URLs, one per line (e.g. 'https://listado.mercadolibre.com.mx/celular' or a filtered listado/lista URL). The country is auto-detected from each URL's domain. Use this for pre-filtered searches you built in the browser. NOT a single product page — this actor scrapes results lists, not product details.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "MX", "AR", "BR", "CL", "CO", "UY", "PE", "EC", "VE", "BO", "PY" ], "type": "string", "description": "MercadoLibre marketplace to search when using keywords (e.g. 'MX' for Mexico, 'BR' for Brazil/Mercado Livre). Sets the site domain and pins a matching in-country residential exit IP. Defaults to 'MX'. Ignored for startUrls, whose country comes from the URL.", "default": "MX" }, "sort": { "title": "Sort order", "enum": [ "relevance", "price_asc", "price_desc", "most_recent" ], "type": "string", "description": "Order of the keyword search results: relevance (MercadoLibre default), lowest price, highest price, or newest. Applies to keyword searches only. Defaults to 'relevance'. For startUrls the sort encoded in the URL is kept as-is.", "default": "relevance" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of product cards to return across all keywords/URLs combined (MercadoLibre serves ~50 per page). Controls cost: you are billed per result returned. Defaults to 50, max 5000. MercadoLibre caps organic pagination near 2000 per search.", "default": 50 }, "enableCaptchaSolver": { "title": "Solve captchas (2captcha)", "type": "boolean", "description": "When MercadoLibre serves a reCAPTCHA wall on a retry, solve it automatically (managed 2captcha key, small extra cost per solve). Leave on for the highest success rate. Turn off to rely on proxy/IP rotation only. Defaults to true.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy used for the primary fetch attempts. For the best success rate select Apify Proxy → RESIDENTIAL and the matching country; the actor falls back to managed in-country residential + captcha solving on blocks. Defaults to automatic Apify Proxy so runs always start. Datacenter IPs are blocked by MercadoLibre, so residential is strongly recommended.", "default": { "useApifyProxy": true } } } }, "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 } } }, "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 } } } } } } } } } }