{
"openapi": "3.0.1",
"info": {
"title": "Mercado Libre Scraper - Products, Prices & Sellers",
"description": "Scrape Mercado Libre / Mercado Livre across 14 LATAM marketplaces: products, prices, discounts, units sold, ratings, sellers, variations, full specs & reviews. Search, category, product or seller URLs. Price monitoring, seller leads & multi-country research.",
"version": "0.1",
"x-build-id": "vqPWIwBl0ohBQn4aK"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~mercadolibre-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~mercadolibre-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-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/scrapesage~mercadolibre-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-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": {
"searchQueries": {
"title": "Search queries (keywords)",
"type": "array",
"description": "Keywords to search, e.g. iphone 15, notebook gamer. Each is searched on the marketplace selected in Country / site.",
"items": {
"type": "string"
}
},
"site": {
"title": "Country / site",
"enum": [
"MLM",
"MLB",
"MLA",
"MLC",
"MCO",
"MPE",
"MLU",
"MLV",
"MEC",
"MRD",
"MBO",
"MPY",
"MGT",
"MPA"
],
"type": "string",
"description": "Which Mercado Libre marketplace to search. Accepts a country name, ISO code or site id.",
"default": "MLM"
},
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "Mercado Libre URLs: search results, category, product (/p/MLM… or articulo…) or seller pages. Auto-classified; country is taken from the URL. Used in addition to the search queries. You can also link or upload a text file of URLs here.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"urlsFromFile": {
"title": "Import URLs from a file",
"type": "string",
"description": "Paste Mercado Libre URLs (one per line), or paste one link to a .txt / .csv file or a Google Sheet that lists them. They are added to Start URLs."
},
"maxItems": {
"title": "Max products (global cap)",
"minimum": 0,
"type": "integer",
"description": "Global cap on product records across all queries/URLs. A search page lists ~50 products. Set 0 for no limit (paginates until the results or the run timeout ends).",
"default": 100
},
"maxPagesPerQuery": {
"title": "Max pages per query",
"minimum": 1,
"type": "integer",
"description": "How many search-result pages (~50 products each) to paginate per query.",
"default": 3
},
"includeProductDetails": {
"title": "Include product details (specs, description, variations, sold count, seller)",
"type": "boolean",
"description": "Open each product page to add the full description, the complete specification table, every picture, available stock, units sold, condition, category path and IDs, the installment plan, and the seller (name, ID, reputation, official store). One product page per product, billed per product (productDetails event).",
"default": false
},
"includeReviews": {
"title": "Include buyer reviews",
"type": "boolean",
"description": "Attach the buyer reviews shown on each product page (star rating, text, date, likes, country). Mercado Libre shows up to 5 featured reviews per product page; each review is billed (review event). Implies product details.",
"default": false
},
"maxReviewsPerProduct": {
"title": "Max reviews per product",
"minimum": 1,
"type": "integer",
"description": "Cap on reviews per product when reviews are enabled (the product page shows up to 5).",
"default": 20
},
"condition": {
"title": "Condition",
"enum": [
"all",
"new",
"used"
],
"type": "string",
"description": "Filter by item condition.",
"default": "all"
},
"sort": {
"title": "Sort",
"enum": [
"relevance",
"price_asc",
"price_desc"
],
"type": "string",
"description": "Result ordering.",
"default": "relevance"
},
"minPrice": {
"title": "Min price",
"minimum": 0,
"type": "integer",
"description": "Minimum price filter (in the site currency)."
},
"maxPrice": {
"title": "Max price",
"minimum": 0,
"type": "integer",
"description": "Maximum price filter (in the site currency)."
},
"officialStoresOnly": {
"title": "Official stores only",
"type": "boolean",
"description": "Only products sold by official brand stores.",
"default": false
},
"freeShippingOnly": {
"title": "Free shipping only",
"type": "boolean",
"description": "Only products with free shipping.",
"default": false
},
"monitorMode": {
"title": "Monitor mode (only new/changed)",
"type": "boolean",
"description": "Remember products across runs and emit only NEW products or ones whose price, original price, rating or free-shipping flag changed - ideal for scheduled price tracking. Product pages are opened (and billed) only for new or changed products.",
"default": false
},
"monitorKey": {
"title": "Monitor key",
"type": "string",
"description": "Names the monitor memory so separate schedules don't collide."
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Residential proxies are required: Mercado Libre refuses datacenter IPs. The actor pins the proxy country to the selected marketplace. Defaults to Apify Residential.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
},
"debugMode": {
"title": "Debug mode",
"type": "boolean",
"description": "Dump raw pages to the key-value store for troubleshooting.",
"default": false
}
}
},
"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
}
}
}
}
}
}
}
}
}
}