{ "openapi": "3.0.1", "info": { "title": "Pinterest Videos Scraper | Video Downloader, MP4 Links, Stats", "description": "Pinterest video scraper and downloader: direct MP4 links, HLS streams, duration, captions, saves, repins, comments, shares, creator and board for every video pin. Search by keyword or paste board, profile and pin links or pin ids. 20 videos in 6 seconds, 41 fields each, no Pinterest account.", "version": "1.0", "x-build-id": "F5x8RptKIojo0MBOf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/silentflow~pinterest-videos-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-silentflow-pinterest-videos-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/silentflow~pinterest-videos-scraper/runs": { "post": { "operationId": "runs-sync-silentflow-pinterest-videos-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/silentflow~pinterest-videos-scraper/run-sync": { "post": { "operationId": "run-sync-silentflow-pinterest-videos-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": { "searchQueries": { "title": "🔎 Keywords", "type": "array", "description": "Words to search in Pinterest's video tab, one keyword per line: easy dinner recipes, diy home decor, nail art. Pinterest serves up to about 180 videos per keyword, ranked as on the site; add more keywords to collect more.", "items": { "type": "string" } }, "startUrls": { "title": "🔗 Pinterest links", "type": "array", "description": "Links copied from Pinterest, one per line, on any Pinterest country domain:Boards and profiles mix videos with images: only the videos become rows. A pin without a video is skipped and counted in the run log.", "items": { "type": "string" } }, "pinIds": { "title": "🆔 Pin ids", "type": "array", "description": "Pin ids, one per line, such as 989525349381756600 (the number in a pin link, or the id column of an earlier run). Each id gives one row with fresh saves, shares and comments, so a watchlist of videos refreshes in one run.", "items": { "type": "string" } }, "maxItems": { "title": "🔢 Max videos", "minimum": 1, "type": "integer", "description": "Stop after this many videos, across keywords, links and ids. The cap is shared evenly between keywords and links, so a second keyword is not crowded out by the first. 20 videos take a few seconds, 100 well under a minute.", "default": 50 }, "minDurationSeconds": { "title": "⏱️ Shortest video (seconds)", "minimum": 0, "maximum": 3600, "type": "integer", "description": "Skip videos shorter than this, such as 15 to drop very short loops. Leave at 0 to keep every length. Videos left out are not delivered and do not count toward Max videos.", "default": 0 }, "maxDurationSeconds": { "title": "⏱️ Longest video (seconds)", "minimum": 0, "maximum": 3600, "type": "integer", "description": "Skip videos longer than this, such as 60 for short-form clips only. Leave at 0 for no upper limit.", "default": 0 }, "excludePromoted": { "title": "🚫 Leave out promoted pins", "type": "boolean", "description": "Promoted pins (ads) found through a keyword, board or profile are flagged in the isPromoted column. Turn this on to leave them out entirely.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }