{ "openapi": "3.0.1", "info": { "title": "Mercado Libre Scraper", "description": "Scrape Mercado Libre and Mercado Livre search results and product pages in 18 countries: price, discount, installments, seller and reputation, sales, ratings, Full shipping, specs and images.", "version": "0.1", "x-build-id": "ebfbeyabbJJqUqTrY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automly~mercadolibre-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automly-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/automly~mercadolibre-scraper/runs": { "post": { "operationId": "runs-sync-automly-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/automly~mercadolibre-scraper/run-sync": { "post": { "operationId": "run-sync-automly-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 terms", "type": "array", "description": "What to search for, one search per line, e.g. iphone 15, tenis nike, freidora de aire. Each search uses the country and filters below. Leave empty to use only links.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "MX", "AR", "BR", "CO", "CL", "PE", "UY", "VE", "EC", "BO", "CR", "DO", "GT", "HN", "NI", "PA", "PY", "SV" ], "type": "string", "description": "Which Mercado Libre site to search, e.g. MX for mercadolibre.com.mx or BR for mercadolivre.com.br. Prices come in that site's currency. Pasted links keep their own country.", "default": "MX" }, "startUrls": { "title": "Mercado Libre links", "type": "array", "description": "Paste Mercado Libre or Mercado Livre links from any country in any mix, e.g. a search or category page with the filters you set on the site (listado.mercadolibre.com.mx/iphone), a seller's listings or store page (listado.mercadolibre.com.mx/_CustId_123456, mercadolibre.com.mx/tienda/sony), a product page (/p/MLM...), an item page (articulo.mercadolibre.com.mx/MLM-...) or an item number such as MLM2352759681.", "items": { "type": "string" } }, "maxItems": { "title": "Max results per search or link", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "How many results to save for each search or link, e.g. 100. Set 0 for every result. Searches with more than 2,000 results are read in full when you ask for more than 2,000.", "default": 100 }, "includeDetails": { "title": "Include full product details", "type": "boolean", "description": "Adds each result's description, every image, full specifications, seller ID, reputation and MercadoLíder level, stock, star breakdown, variations and category path. Slower; leave off for the search fields only.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "price_asc", "price_desc" ], "type": "string", "description": "Order of the results, e.g. price_asc for the cheapest first.", "default": "relevance" }, "condition": { "title": "Condition", "enum": [ "any", "new", "used", "refurbished" ], "type": "string", "description": "Only new, used or refurbished items, e.g. new.", "default": "any" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Lowest price in the country's currency, e.g. 500." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Highest price in the country's currency, e.g. 5000." }, "minDiscount": { "title": "Minimum discount (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only items at least this many percent off, e.g. 20." }, "freeShippingOnly": { "title": "Free shipping only", "type": "boolean", "description": "Only items with free shipping.", "default": false }, "fullShippingOnly": { "title": "Mercado Libre Full only", "type": "boolean", "description": "Only items shipped by Mercado Libre Full (stored and shipped by Mercado Libre).", "default": false }, "officialStoresOnly": { "title": "Official stores only", "type": "boolean", "description": "Only items sold by official brand stores.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave the default. Change only if you know you need a specific proxy.", "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 }, "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 } } } } } } } } } }