{ "openapi": "3.0.1", "info": { "title": "Pinterest Pins Scraper", "description": "Pinterest Pins Scraper extracts the latest pins from public Pinterest profiles and boards. Get up to 25 recent pins per profile or board from Pinterest's public RSS feeds, no login required.", "version": "0.0", "x-build-id": "CsillSRv3tuWqsSDJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdatatools~pinterest-pins-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdatatools-pinterest-pins-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/webdatatools~pinterest-pins-scraper/runs": { "post": { "operationId": "runs-sync-webdatatools-pinterest-pins-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/webdatatools~pinterest-pins-scraper/run-sync": { "post": { "operationId": "run-sync-webdatatools-pinterest-pins-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": { "profiles": { "title": "Profiles", "type": "array", "description": "Enter Pinterest usernames or profile URLs to scrape the latest pins from, e.g. \"nasa\" or https://www.pinterest.com/nasa/. Each profile returns up to 25 pins (Pinterest's public RSS feed caps at 25).", "default": [ "nasa" ], "items": { "type": "string" } }, "boards": { "title": "Boards", "type": "array", "description": "Enter Pinterest board URLs to scrape the latest pins from, e.g. https://www.pinterest.com/nasa/space-exploration/. Each board returns up to 25 pins (Pinterest's public RSS feed caps at 25).", "default": [], "items": { "type": "string" } }, "maxPinsPerSource": { "title": "Max pins per source", "minimum": 1, "maximum": 25, "type": "integer", "description": "Enter the maximum number of pins to return per profile or board, e.g. 25. Pinterest's public RSS feed only ever returns the latest 25 pins, so this cannot go above 25.", "default": 25 }, "profile": { "title": "Single profile (alias)", "type": "string", "description": "Enter a single Pinterest username or profile URL as an alternative to the profiles list, e.g. nasa. Merged into profiles.", "default": "" }, "username": { "title": "Single username (alias)", "type": "string", "description": "Same as \"profile\" — enter a single Pinterest username, e.g. nasa. Merged into profiles.", "default": "" }, "url": { "title": "Single URL (alias)", "type": "string", "description": "Enter a single Pinterest profile or board URL. Classified automatically by URL depth: https://www.pinterest.com/nasa/ is a profile, https://www.pinterest.com/nasa/space-exploration/ is a board.", "default": "" }, "urls": { "title": "URLs (alias)", "type": "array", "description": "Enter a list of Pinterest profile and/or board URLs, mixed freely. Each one is classified automatically by URL depth (1 path segment = profile, 2 = board).", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (alias)", "type": "array", "description": "Apify-convention list of start URLs, e.g. [{\"url\": \"https://www.pinterest.com/nasa/\"}]. Plain strings also work. Classified the same way as \"urls\".", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } }