{
"openapi": "3.0.1",
"info": {
"title": "MercadoLibre Scraper",
"description": "MercadoLibre and Mercado Livre products by search, search link or product link in 8 countries (AR, BR, MX, CL, PE, UY, EC, VE): price, discount, installments, shipping, rating; optionally sold count, stock, variants, seller reputation, specs.",
"version": "1.0",
"x-build-id": "oW3lvgbdCIO975ObP"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/steadyscrape~mercadolibre-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-steadyscrape-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/steadyscrape~mercadolibre-scraper/runs": {
"post": {
"operationId": "runs-sync-steadyscrape-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/steadyscrape~mercadolibre-scraper/run-sync": {
"post": {
"operationId": "run-sync-steadyscrape-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": {
"searches": {
"title": "Searches",
"type": "array",
"description": "What you would type in MercadoLibre's search box: auriculares bluetooth, iphone 15, tênis nike. Each one is searched on the site of the country below.",
"items": {
"type": "string"
}
},
"country": {
"title": "Country (for the searches above)",
"enum": [
"AR",
"BR",
"MX",
"CL",
"PE",
"UY",
"EC",
"VE"
],
"type": "string",
"description": "Search links and product links carry their own country.",
"default": "AR"
},
"sort": {
"title": "Sort",
"enum": [
"relevance",
"price_asc",
"price_desc"
],
"type": "string",
"description": "Order of the searches above. Search links keep their own.",
"default": "relevance"
},
"condition": {
"title": "Condition",
"enum": [
"any",
"new",
"used"
],
"type": "string",
"description": "Filter of the searches above. Search links keep their own filters.",
"default": "any"
},
"searchUrls": {
"title": "Search links",
"type": "array",
"description": "MercadoLibre search links from any of the eight countries, with every filter and sort they carry (price range, brand, shipping, condition, category): set them on the site, then paste the address bar here, e.g. https://listado.mercadolibre.com.ar/zapatillas_OrderId_PRICE_NoIndex_True. A category's landing page (no search words) shows only its featured products: search inside the category instead.",
"items": {
"type": "string"
}
},
"productUrls": {
"title": "Product links",
"type": "array",
"description": "Products from any of the eight countries: classic links (https://articulo.mercadolibre.com.ar/MLA-2815639876-…, produto.mercadolivre.com.br/MLB-…), catalog links (…/p/MLA45765721), seller-product links (…/up/MLAU3760687791) or a bare item id (MLA2815639876). Each one is read from its own page, with all its details.",
"items": {
"type": "string"
}
},
"includeDetails": {
"title": "Include product details",
"type": "boolean",
"description": "Read each search result's own page too: how many sold, how many in stock, condition, every variant (colors, sizes…) with what is out of stock, the seller with its MercadoLíder level and sales, shipping promises, every specification, the description, all photos and the category path. One extra page per product, and the price of a product with details.",
"default": false
},
"maxItemsPerSearch": {
"title": "Max products per search",
"minimum": 0,
"type": "integer",
"description": "Stop each search or search link after this many products. 0 reads every page MercadoLibre shows, up to about 2,000 products per search (48 per page): split a larger market into narrower searches or price ranges. Checked before any request, so nothing past it is read or charged.",
"default": 100
}
}
},
"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
}
}
}
}
}
}
}
}
}
}