{ "openapi": "3.0.1", "info": { "title": "MercadoLibre Scraper — Products, Prices & Reviews", "description": "MercadoLibre and Mercado Livre scraper for Mexico, Brazil, Argentina, Colombia, Chile, Uruguay and Peru. Search a keyword, category or product URL. One row per listing with title, price, condition, rating, seller and images. Optional detail and reviews. Handles the bot gate. JSON, CSV or Excel.", "version": "1.0", "x-build-id": "saaQ4ejJrLKzRcu49" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~mercadolibre-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-mercadolibre-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/memo23~mercadolibre-scraper/runs": { "post": { "operationId": "runs-sync-memo23-mercadolibre-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/memo23~mercadolibre-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-mercadolibre-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": { "searchTerms": { "title": "Search keywords", "type": "array", "description": "Keywords searched on the selected country site (e.g. `iphone`, `notebook gamer`).", "items": { "type": "string" } }, "startUrls": { "title": "Listing / category / product URLs", "type": "array", "description": "MercadoLibre search or category listing URLs, direct product URLs (…/p/MLM…), or bare keywords. Each entry is auto-classified.", "items": { "type": "string" } }, "country": { "title": "Country site", "enum": [ "MLM", "MLA", "MLB", "MCO", "MLC", "MLU", "MPE" ], "type": "string", "description": "Which MercadoLibre country site to search.", "default": "MLM" }, "enrichDetail": { "title": "Fetch full product detail (slower)", "type": "boolean", "description": "For each result, fetch its product page to add brand, rating, condition, the full image gallery, the description, the seller name and every spec row the listing states (attributes). For real estate this also fills address, coordinates, rooms, bedrooms, bathrooms, surface areas and expensas. Adds requests, so it's off by default.", "default": false }, "maxReviews": { "title": "Reviews per product", "minimum": 0, "maximum": 50, "type": "integer", "description": "Also scrape up to this many recent reviews per product (rating, text, date). 0 = off. Adds one request per product.", "default": 0 }, "maxItems": { "title": "Maximum products", "minimum": 1, "type": "integer", "description": "Hard cap on products collected (and billed).", "default": 1000 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel jobs. Kept low because each request solves a proof-of-work challenge.", "default": 4 }, "proxy": { "title": "Proxy configuration (optional override)", "type": "object", "description": "Leave this empty. The Actor already routes every request through its own residential proxy, in the right country, at no extra cost to you — setting your own only adds proxy charges to your account. In particular do NOT pick Apify Proxy here: MercadoLibre's captcha wall only accepts a token generated from the same IP that submits it, and Apify Proxy credentials inside an Actor run cannot be reached by the captcha solver, so the Actor will ignore that choice and fall back to its built-in proxy. Use this field only for your own external proxy service." } } }, "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 } } } } } } } } } }