{ "openapi": "3.0.1", "info": { "title": "MercadoLibre Video Reel Maker", "description": "Turn MercadoLibre products into a ready-to-post vertical offers reel (MP4). Search a category and get a finished video: product photos, prices, discounts and seller, smooth transitions, branded intro/outro, your logo and optional music. Priced per video.", "version": "0.1", "x-build-id": "9fzisSrBCldm6tijp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/synthetic.ia~mercadolibre-video-reel/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-synthetic.ia-mercadolibre-video-reel", "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/synthetic.ia~mercadolibre-video-reel/runs": { "post": { "operationId": "runs-sync-synthetic.ia-mercadolibre-video-reel", "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/synthetic.ia~mercadolibre-video-reel/run-sync": { "post": { "operationId": "run-sync-synthetic.ia-mercadolibre-video-reel", "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": { "searchQuery": { "title": "Search MercadoLibre", "type": "string", "description": "Type what to search (e.g. \"zapatillas nike\"). The Actor scrapes MercadoLibre and builds the reel automatically. Takes priority; leave empty to use the sample products (or your own items / dataset)." }, "country": { "title": "Country", "enum": [ "AR", "MX", "BR", "CL", "CO", "UY", "PE", "EC", "VE", "BO", "PY", "CR", "PA", "DO", "GT", "HN", "NI", "SV" ], "type": "string", "description": "MercadoLibre marketplace to search when using Search.", "default": "AR" }, "items": { "title": "Products (inline)", "type": "array", "description": "Advanced: product objects { title, price, currency, imageUrl, discountPercent?, originalPrice?, seller? }. Used only when Search is empty. The prefilled samples let you preview the reel instantly.", "default": [ { "title": "Zapatilla Chunky Casual Oversize Liviana Negra", "price": 49620, "originalPrice": 69887.57, "discountPercent": 29, "currency": "ARS", "imageUrl": "https://http2.mlstatic.com/D_NQ_NP_892767-MLA113860789969_062026-O.webp", "seller": null }, { "title": "Zapatillas Nike Revolution 8 Para Hombre Hj9198-003", "price": 129999, "originalPrice": null, "discountPercent": null, "currency": "ARS", "imageUrl": "https://http2.mlstatic.com/D_NQ_NP_714229-MLA86884461122_072025-O.webp", "seller": null }, { "title": "Zapatillas Running Mujer Livianas Transpirables Deportivas", "price": 20962, "originalPrice": 26098.04, "discountPercent": 19, "currency": "ARS", "imageUrl": "https://http2.mlstatic.com/D_NQ_NP_761910-CBT113527682188_072026-O.webp", "seller": null }, { "title": "Zapatillas Originales Casual Dobleb Chunky Urbanas Anchas", "price": 81265, "originalPrice": 117999, "discountPercent": 31, "currency": "ARS", "imageUrl": "https://http2.mlstatic.com/D_NQ_NP_705902-MLA92805827206_092025-O.webp", "seller": "por AUCA ZAPATILLAS" } ] }, "datasetId": { "title": "Dataset ID", "type": "string", "description": "Advanced: Apify dataset ID from the MercadoLibre Scraper. Overrides Search." }, "maxProducts": { "title": "Max products in the reel", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many products to include (each is one slide)." }, "secondsPerProduct": { "title": "Seconds per product", "minimum": 1, "maximum": 8, "type": "number", "description": "How long each product is shown on screen." }, "format": { "title": "Format", "enum": [ "vertical", "square", "landscape" ], "type": "string", "description": "Aspect ratio of the output video.", "default": "vertical" }, "headline": { "title": "Headline", "type": "string", "description": "Text shown at the top of every slide." }, "logoUrl": { "title": "Logo URL (optional)", "type": "string", "description": "Direct URL to a PNG logo (transparent recommended) shown in the top corner of every slide. You are responsible for having the rights to use it." }, "musicFile": { "title": "Background music — upload a file (optional)", "type": "string", "description": "Upload an MP3/M4A you own or are licensed to use. Looped, trimmed and faded automatically." }, "musicUrl": { "title": "…or a music URL (optional)", "type": "string", "description": "Direct URL to an MP3/M4A instead of uploading. Leave empty for no music — the reel still works." }, "musicRightsConfirmed": { "title": "I have the rights to use this music", "type": "boolean", "description": "We do not provide music. Music is only added if you check this. You are solely responsible for the track you supply; no proof is required.", "default": false }, "outroText": { "title": "Outro text (optional)", "type": "string", "description": "If set, adds a closing card with this text (and your logo). Leave empty for no outro." } } }, "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 } } } } } } } } } }