{ "openapi": "3.0.1", "info": { "title": "MercadoLibre Scraper", "description": "Scrape MercadoLibre listings, prices, discounts, ratings and seller info by keyword or URL. Covers 15 Latin American markets - Argentina, Mexico, Brazil, Chile, Colombia, Peru, Uruguay and more - in one run. No login required. Export to JSON, CSV or Excel.", "version": "0.3", "x-build-id": "kqol1UqC0DP5nifiu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sheshinmcfly~mercadolibre-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sheshinmcfly-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/sheshinmcfly~mercadolibre-scraper/runs": { "post": { "operationId": "runs-sync-sheshinmcfly-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/sheshinmcfly~mercadolibre-scraper/run-sync": { "post": { "operationId": "run-sync-sheshinmcfly-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": { "mode": { "title": "Scraping mode", "enum": [ "search", "urls" ], "type": "string", "description": "`search` = search by keyword across one or more countries; `urls` = scrape direct product or listing URLs.", "default": "search" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search (e.g. \"laptop\", \"iphone 15\"). Each term runs against each selected country.", "items": { "type": "string" }, "default": [ "laptop" ] }, "countries": { "title": "Countries", "type": "array", "description": "MercadoLibre countries to query. All 15 are supported and reliable; on busy targets the scraper may retry with a fresh IP automatically.", "items": { "type": "string", "enum": [ "CL", "AR", "MX", "CO", "PE", "UY", "BR", "CR", "DO", "EC", "PA", "NI", "SV", "BO", "PY" ], "enumTitles": [ "Chile (CL)", "Argentina (AR)", "México (MX)", "Colombia (CO)", "Perú (PE)", "Uruguay (UY)", "Brasil (BR)", "Costa Rica (CR)", "Rep. Dominicana (DO)", "Ecuador (EC)", "Panamá (PA)", "Nicaragua (NI)", "El Salvador (SV)", "Bolivia (BO)", "Paraguay (PY)" ] }, "default": [ "AR" ] }, "urls": { "title": "Direct URLs", "type": "array", "description": "Direct MercadoLibre product or listing URLs (used only in `urls` mode).", "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Max results per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of products per term × country combination.", "default": 100 }, "sortBy": { "title": "Sort results by", "enum": [ "relevance", "price_asc", "price_desc", "sold_quantity_desc" ], "type": "string", "description": "Result ordering. Defaults to MercadoLibre's relevance.", "default": "relevance" }, "priceMin": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Minimum price in the local currency of the selected country. Optional." }, "priceMax": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Maximum price in the local currency of the selected country. Optional." }, "fetchDetails": { "title": "Fetch product details", "type": "boolean", "description": "If enabled, visits each product page to extract richer data (HD images, stock, rating). Slower and more expensive per item.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. RESIDENTIAL is REQUIRED for MercadoLibre — datacenter IPs are blocked instantly. Do not change unless testing.", "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 } } }, "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 } } } } } } } } } }