{ "openapi": "3.0.1", "info": { "title": "Pinterest Video Downloader — MP4 + HLS Links", "description": "Download Pinterest videos: direct MP4, HLS, thumbnail, creator, duration & stats from pin URLs, pin.it links, IDs, or a search keyword. MCP/API-ready.", "version": "1.1", "x-build-id": "RROhgdMj11cR7UdsI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~pinterest-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-pinterest-video-downloader", "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/khadinakbar~pinterest-video-downloader/runs": { "post": { "operationId": "runs-sync-khadinakbar-pinterest-video-downloader", "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/khadinakbar~pinterest-video-downloader/run-sync": { "post": { "operationId": "run-sync-khadinakbar-pinterest-video-downloader", "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": { "pinUrls": { "title": "Pinterest pin URLs / links / IDs", "type": "array", "description": "One entry per Pinterest video you want to download. Accepts a full pin URL ('https://www.pinterest.com/pin/351912467391055/'), a 'pin.it' short link ('https://pin.it/abc123'), or a bare numeric pin ID ('351912467391055'). Paste many at once — each is resolved and downloaded independently. NOT a board or profile URL; use the search keyword field to collect videos from a topic instead.", "items": { "type": "string" } }, "boardOrProfileUrls": { "title": "Board or profile URLs", "type": "array", "description": "Download every video pin from a whole Pinterest board or profile. Accepts a board URL ('https://www.pinterest.com/username/board-name/') or a profile URL ('https://www.pinterest.com/username/'), up to Max results per input. Image pins are skipped automatically. NOT for individual pins — use the pin URLs field above for those.", "items": { "type": "string" } }, "searchQuery": { "title": "Search keyword (optional)", "type": "string", "description": "Free-text Pinterest search; the actor collects video pins matching it up to Max results. Example: 'cooking recipe' or 'home workout'. Leave empty when you supply exact pin URLs above. Runs in addition to any pin URLs provided." }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on the number of videos returned across all inputs. Controls cost — you are charged per video downloaded. Defaults to 50. Use a small value (1-5) for a quick test run.", "default": 50 }, "saveVideo": { "title": "Save MP4 file to storage", "type": "boolean", "description": "When enabled, the actor downloads the MP4 bytes into the run's key-value store and adds a permanent 'storedVideoUrl' to each record. When disabled (default), only the direct CDN video URLs are returned, which is faster and cheaper. Enable this if the source CDN link might expire before you fetch it.", "default": false }, "includeHls": { "title": "Include HLS stream URLs", "type": "boolean", "description": "Include the adaptive HLS (.m3u8) stream URLs alongside the direct MP4. Useful for ffmpeg/yt-dlp pipelines or when a pin has no progressive MP4. Defaults to true. Does not affect pricing.", "default": true }, "videoQuality": { "title": "Preferred MP4 quality", "enum": [ "best", "720p", "480p", "360p" ], "type": "string", "description": "Which progressive MP4 to put in the primary 'videoUrl' field. 'best' picks the highest-resolution MP4 available. Pinterest usually exposes a single 720p MP4, so 'best' and '720p' are typically identical. All available MP4 renditions are always returned in 'mp4Formats'.", "default": "best" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used to reach Pinterest's API. Defaults to Apify Datacenter proxy (US), which is sufficient. Switch to Residential if you hit rate limits on large runs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [] } } } }, "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 } } } } } } } } } }