{ "openapi": "3.0.1", "info": { "title": "Kuantum Mercado Libre Search — Listings", "description": "Search public Mercado Libre listings and extract structured product, price, and availability data with Kuantum Mercado Libre Search. Replace manual marketplace research with repeatable runs. Try it now and get your next market snapshot.", "version": "0.1", "x-build-id": "O9FCXaOtyFnNyQViK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kuantum~mercado-libre-search-owned/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kuantum-mercado-libre-search-owned", "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/kuantum~mercado-libre-search-owned/runs": { "post": { "operationId": "runs-sync-kuantum-mercado-libre-search-owned", "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/kuantum~mercado-libre-search-owned/run-sync": { "post": { "operationId": "run-sync-kuantum-mercado-libre-search-owned", "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": [ "query" ], "properties": { "site": { "title": "Site ID", "type": "string", "description": "Mercado Libre site code such as MLA, MLB, or MLM." }, "country": { "title": "Country", "type": "string", "description": "Country name or code; use instead of site." }, "query": { "title": "Search query", "type": "string", "description": "Keyword or phrase to search in public Mercado Libre listings." }, "category": { "title": "Category ID", "type": "string", "description": "Optional Mercado Libre category identifier." }, "priceMin": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Optional minimum price in the marketplace currency." }, "priceMax": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Optional maximum price in the marketplace currency." }, "condition": { "title": "Condition", "type": "string", "description": "Optional condition filter such as new or used." }, "listingType": { "title": "Listing type", "type": "string", "description": "Optional Mercado Libre listing type identifier." }, "shipping": { "title": "Shipping filter", "type": "string", "description": "Optional shipping filter value returned by the API." }, "buyingMode": { "title": "Buying mode", "type": "string", "description": "Optional buying mode filter." }, "sellerId": { "title": "Seller ID", "type": "string", "description": "Optional public seller identifier." }, "officialStoreId": { "title": "Official store ID", "type": "string", "description": "Optional official store identifier." }, "sort": { "title": "Sort", "type": "string", "description": "Sort identifier, commonly date_desc for newest first.", "default": "date_desc" }, "limit": { "title": "Results per page", "minimum": 1, "maximum": 50, "type": "integer", "description": "Number of listings requested per page.", "default": 50 }, "pages": { "title": "Pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of offset pages to retrieve.", "default": 1 }, "retries": { "title": "Retries", "minimum": 0, "maximum": 8, "type": "integer", "description": "Maximum retries for transient API failures.", "default": 3 }, "timeout": { "title": "Request timeout (ms)", "minimum": 1000, "maximum": 120000, "type": "integer", "description": "Timeout for each API request.", "default": 30000 }, "useResidentialProxy": { "title": "Use residential proxy", "type": "boolean", "description": "Route requests through Apify residential proxy infrastructure.", "default": true }, "proxyGroups": { "title": "Proxy groups", "type": "array", "description": "Apify proxy groups to use when proxying requests.", "items": { "type": "string" }, "default": [ "RESIDENTIAL" ] }, "proxySession": { "title": "Proxy session ID", "pattern": "^[A-Za-z0-9_.~]+$", "type": "string", "description": "Optional stable Apify Proxy session ID for this run. Use only letters, numbers, underscore, dot, and tilde. Do not enter proxy credentials." }, "browserStateKey": { "title": "Browser state key", "type": "string", "description": "Optional Key-Value Store key containing an authorized Playwright storageState JSON object." }, "proxyMode": { "title": "Proxy mode", "enum": [ "APIFY_RESIDENTIAL", "APIFY_DATACENTER", "CUSTOM", "NONE" ], "type": "string", "description": "Explicit proxy mode: APIFY_RESIDENTIAL, APIFY_DATACENTER, CUSTOM, or NONE.", "default": "APIFY_RESIDENTIAL" }, "customProxyUrl": { "title": "Custom proxy URL", "type": "string", "description": "Optional authenticated proxy URL used only with CUSTOM. Prefer an Apify Secret or secured input; never log this value." }, "browserProvider": { "title": "Browser provider", "enum": [ "LOCAL", "BROWSERLESS" ], "type": "string", "description": "Use local Chromium or a Browserless managed Chromium session. Browserless requires BROWSERLESS_TOKEN in the Actor environment.", "default": "LOCAL" }, "browserlessProxy": { "title": "Browserless proxy", "enum": [ "NONE", "DATACENTER", "RESIDENTIAL" ], "type": "string", "description": "Optional Browserless-managed proxy tier. This is independent of Apify Proxy.", "default": "NONE" }, "challengeRetries": { "title": "Challenge retries", "minimum": 0, "maximum": 3, "type": "integer", "description": "Maximum controlled retries after challenge or HTTP block.", "default": 3 }, "warmUpSession": { "title": "Warm up session", "type": "boolean", "description": "Visit the public marketplace homepage before search navigation.", "default": true }, "navigationDelayMinMs": { "title": "Minimum navigation delay", "minimum": 0, "maximum": 120000, "type": "integer", "description": "Minimum delay in milliseconds before navigation.", "default": 3000 }, "navigationDelayMaxMs": { "title": "Maximum navigation delay", "minimum": 0, "maximum": 120000, "type": "integer", "description": "Maximum delay in milliseconds before navigation.", "default": 7000 } } }, "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 } } } } } } } } } }