{ "openapi": "3.0.1", "info": { "title": "Mercado Libre Market Intelligence — LATAM Niche Analyzer", "description": "Title-filtered Mercado Libre niche analytics for 18 LATAM sites. Price percentiles, top sellers and brands, demand from public sold buckets (not exact sales). Keyword or category URL. Report and CSV.", "version": "0.11", "x-build-id": "MdjRp9ad3XTwsN6Ly" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawloop~mercado-libre-market-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawloop-mercado-libre-market-intelligence", "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/crawloop~mercado-libre-market-intelligence/runs": { "post": { "operationId": "runs-sync-crawloop-mercado-libre-market-intelligence", "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/crawloop~mercado-libre-market-intelligence/run-sync": { "post": { "operationId": "run-sync-crawloop-mercado-libre-market-intelligence", "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": [ "siteId" ], "properties": { "searchQueries": { "title": "Search Queries", "type": "array", "description": "Product keywords or niches to analyze (one per line). Each query produces one market intelligence report.", "items": { "type": "string" } }, "categoryUrls": { "title": "Category URLs", "type": "array", "description": "Mercado Libre category or filtered listing URLs to analyze. Paste the URL from your browser after applying filters.", "items": { "type": "string" } }, "siteId": { "title": "Country / Site ID", "enum": [ "MLA", "MLB", "MLM", "MCO", "MLC", "MPE", "MLU", "MLV", "MEC", "MBO", "MPA", "MPY", "MRD", "MCR", "MNI", "MGT", "MHN", "MSV" ], "type": "string", "description": "Target Mercado Libre country site.", "default": "MLA" }, "maxItemsPerQuery": { "title": "Listings analyzed per query", "minimum": 5, "maximum": 500, "type": "integer", "description": "How many top search results to analyze per query (5-500). More listings = higher confidence, longer run.", "default": 50 }, "includeProductDetail": { "title": "Deep analysis (product pages)", "type": "boolean", "description": "Visit each product page to read sold counters, stock, brand, and specs. Required for demand, revenue, and brand analytics. Slower but much richer.", "default": true }, "condition": { "title": "Condition", "enum": [ "any", "new", "used", "refurbished" ], "type": "string", "description": "Filter listings by condition before analysis.", "default": "any" }, "priceMin": { "title": "Minimum Price", "minimum": 0, "type": "integer", "description": "Lower price bound in the site's local currency." }, "priceMax": { "title": "Maximum Price", "minimum": 0, "type": "integer", "description": "Upper price bound in the site's local currency." }, "officialStoresOnly": { "title": "Official Stores Only", "type": "boolean", "description": "Analyze only official store listings.", "default": false }, "includeItems": { "title": "Include listing records", "type": "boolean", "description": "Push individual analyzed listings to the dataset and CSV export.", "default": true }, "outputFormat": { "title": "Output format", "enum": [ "full", "summary_only", "items_only" ], "type": "string", "description": "full = summaries + listings + report + CSV; summary_only = summaries + report; items_only = listings + CSV.", "default": "full" }, "pdpConcurrency": { "title": "Detail page concurrency", "minimum": 1, "maximum": 15, "type": "integer", "description": "Product detail pages fetched in parallel during deep analysis.", "default": 5 }, "sessionPoolSize": { "title": "Proxy Session Pool Size", "minimum": 1, "maximum": 10, "type": "integer", "description": "Independent residential proxy sessions (IPs) used in parallel.", "default": 4 }, "cookies": { "title": "Session cookies", "type": "array", "description": "Optional Mercado Libre cookies from a logged-in browser. Needed when search pages show the login / suspicious-traffic wall." }, "sessionCookies": { "title": "Cookie header", "type": "string", "description": "Optional raw Cookie header (name=value; name2=value2) from a logged-in Mercado Libre session." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy configuration. Residential proxy in the target country is configured automatically when empty." } } }, "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 } } } } } } } } } }