{ "openapi": "3.0.1", "info": { "title": "MercadoLibre Product & Price Scraper (LATAM)", "description": "Scrape MercadoLibre product listings and prices across 18 countries including Mexico, Argentina and Brazil. Extract title, price, currency, discount, seller, rating, stock, sold quantity and images. Export to JSON, CSV or Excel. No login needed.", "version": "0.1", "x-build-id": "6i0pqsp5XayNHB5VM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~mercadolibre-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-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/scrapers_lat~mercadolibre-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-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/scrapers_lat~mercadolibre-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-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": { "maxListings": { "title": "Max listings", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of listings to collect. Optional." }, "withDetails": { "title": "Fetch Product Details", "type": "boolean", "description": "When enabled, the actor opens each product page to add attributes, description and the full image gallery. Slower but richer.", "default": true }, "startUrl": { "title": "Search URL", "type": "string", "description": "A MercadoLibre search or listing results URL (e.g. https://listado.mercadolibre.com.ar/notebook). Filters encoded in the URL (category, condition, price, location) are respected. Takes precedence over Search Term + Country." }, "searchTerm": { "title": "Search Term", "type": "string", "description": "Keyword to search for. Used together with Country when no Search URL is provided." }, "condition": { "title": "Condition", "enum": [ "", "new", "used", "refurbished" ], "type": "string", "description": "Filter by item condition. Applied when using a Search Term (a Search URL keeps its own filters).", "default": "" }, "priceMin": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Only return items priced at or above this value (in the site's local currency). Applied when using a Search Term." }, "priceMax": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Only return items priced at or below this value (in the site's local currency). Applied when using a Search Term." }, "minDiscount": { "title": "Minimum discount %", "minimum": 1, "maximum": 90, "type": "integer", "description": "Only return items with at least this discount percentage. Applied when using a Search Term." }, "freeShipping": { "title": "Free shipping only", "type": "boolean", "description": "Only return items that ship for free. Applied when using a Search Term.", "default": false }, "fullFulfillment": { "title": "Mercado Envios FULL only", "type": "boolean", "description": "Only return items fulfilled by Mercado Envios FULL (fast, stocked in ML warehouses). Applied when using a Search Term.", "default": false }, "officialStore": { "title": "Official stores only", "type": "boolean", "description": "Only return items sold by official brand stores. Applied when using a Search Term.", "default": false }, "sort": { "title": "Sort order", "enum": [ "relevance", "price_asc", "price_desc" ], "type": "string", "description": "Result ordering. Applied when using a Search Term.", "default": "relevance" }, "country": { "title": "Country", "enum": [ "ar", "mx", "br", "co", "cl", "pe", "uy", "ve", "bo", "py", "ec", "cr", "pa", "do", "gt", "hn", "ni", "sv" ], "type": "string", "description": "MercadoLibre country site to search when using a Search Term.", "default": "ar" } } }, "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 } } } } } } } } } }