{ "openapi": "3.0.1", "info": { "title": "Pinterest Scraper: Pins, Boards, Profiles & Videos", "description": "Scrape public Pinterest pins, boards, profiles, images and video links by keyword or URL. No login needed. Pay per delivered record, no start fee. Independent tool, not affiliated with Pinterest.", "version": "0.1", "x-build-id": "gdbu2K0fNdywSZzrk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zapticx~pinterest-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zapticx-pinterest-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/zapticx~pinterest-scraper/runs": { "post": { "operationId": "runs-sync-zapticx-pinterest-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/zapticx~pinterest-scraper/run-sync": { "post": { "operationId": "run-sync-zapticx-pinterest-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": { "startUrls": { "title": "Pinterest URLs", "type": "array", "description": "Pin, board, profile or pin.it short links. The type of each URL is detected automatically, and you can mix types in one run.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchQueries": { "title": "Search keywords", "type": "array", "description": "Keywords to search on Pinterest. Each keyword runs separately, and keywords share Max records evenly.", "items": { "type": "string" } }, "searchType": { "title": "Search for", "enum": [ "pins", "videos" ], "type": "string", "description": "Search all pins, or only video pins.", "default": "pins" }, "maxItems": { "title": "Max records", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most records to save in this run, across all URLs and keywords and all record types. This is also your cost ceiling.", "default": 100 }, "scrapePins": { "title": "Save pins", "type": "boolean", "description": "Save the pins found on boards and profiles. Turn off to collect only board or profile details.", "default": true }, "scrapeBoards": { "title": "Save board details", "type": "boolean", "description": "Save a record for each board URL, and for each board listed on a profile URL.", "default": true }, "scrapeProfileDetails": { "title": "Save profile details", "type": "boolean", "description": "Save a record with the bio, website and counts for each profile URL.", "default": true }, "maxBoardsPerProfile": { "title": "Max boards per profile", "minimum": 0, "maximum": 1000, "type": "integer", "description": "How many of a profile's boards to save. Set 0 to skip them.", "default": 25 }, "enrichPinDetails": { "title": "Add full details to profile pins", "type": "boolean", "description": "Fetch each profile pin's own page to add comment counts and other fields missing from the profile feed. Slower. Does not apply to search or board pins.", "default": false }, "includeVideoMetadata": { "title": "Include video details", "type": "boolean", "description": "Add video links, duration, size and thumbnail to video pins.", "default": true }, "includeImageVariants": { "title": "Include every image size", "type": "boolean", "description": "List every image size Pinterest offers for each pin. Turn off for a smaller dataset.", "default": true }, "maxConcurrency": { "title": "Concurrent requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many requests run at once.", "default": 3 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for each Pinterest reply.", "default": 30 }, "maxRetries": { "title": "Max retries", "minimum": 0, "maximum": 5, "type": "integer", "description": "How many times to retry a failed request.", "default": 2 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Connection route. Leave as it is unless you have a reason to change it." } } }, "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 } } } } } } } } } }