{ "openapi": "3.0.1", "info": { "title": "Mercado Livre Official Store Scraper", "description": "Extract product data from Mercado Livre Brazil official stores including prices, ratings, sold quantities, seller info, badges, coupons, FULL status, and shipping details. Supports automatic pagination and proxy configuration.", "version": "1.1", "x-build-id": "I6mxMtlm2cd2y3a2x" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yasmany.casanova~mercadolivre-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yasmany.casanova-mercadolivre-store-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/yasmany.casanova~mercadolivre-store-scraper/runs": { "post": { "operationId": "runs-sync-yasmany.casanova-mercadolivre-store-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/yasmany.casanova~mercadolivre-store-scraper/run-sync": { "post": { "operationId": "run-sync-yasmany.casanova-mercadolivre-store-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", "required": [ "storeUrl" ], "properties": { "storeUrl": { "title": "Store URL", "type": "string", "description": "URL da loja oficial no MercadoLivre. Aceita qualquer formato: URL completa (https://www.mercadolivre.com.br/loja/3m), URL de listagem (https://lista.mercadolivre.com.br/loja/3m/), ou apenas o slug (ex: 3m, samsung)." }, "maxPages": { "title": "Max Pages", "minimum": 0, "maximum": 500, "type": "integer", "description": "Numero maximo de paginas para extrair. Cada pagina contem 48 produtos. 0 = todas as paginas.", "default": 0 }, "maxItems": { "title": "Max Items", "minimum": 0, "maximum": 50000, "type": "integer", "description": "Numero maximo de produtos para extrair. 0 = todos os produtos.", "default": 0 }, "requestDelay": { "title": "Request Delay (seconds)", "minimum": 0.5, "maximum": 10, "type": "number", "description": "Delay entre requests em segundos para evitar bloqueio. Valores menores = mais rapido, valores maiores = mais seguro.", "default": 3 }, "useApifyProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Usar proxy do Apify para evitar bloqueio. RECOMENDADO para execucao na plataforma Apify (o Mercado Livre bloqueia IPs de datacenter). Desative apenas para execucao local. Requer permissao de proxy no token da API.", "default": true }, "proxyCountry": { "title": "Proxy Country", "pattern": "^[A-Z]{2}$", "type": "string", "description": "Codigo do pais para o proxy (ISO 3166-1 alpha-2). Use BR para resultados em Reais e frete correto.", "default": "BR" }, "proxyGroups": { "title": "Proxy Groups", "type": "array", "description": "Grupos de proxy do Apify. RESIDENTIAL e recomendado para o Mercado Livre.", "items": { "type": "string", "enum": [ "RESIDENTIAL", "DATACENTER" ] }, "default": [ "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 } } } } } } } } } }