{ "openapi": "3.0.1", "info": { "title": "Pinterest Scraper - Pins, Boards & Profiles", "description": "Scrape Pinterest pins, video pins, boards and profiles from keyword search or Pinterest URLs. Get image and video URLs, outbound links, saves, repins, shares, product prices, followers and monthly views. No login or cookies needed.", "version": "1.0", "x-build-id": "LFhgOdtyhzVwbWtw4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axlymxp~pinterest-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axlymxp-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/axlymxp~pinterest-scraper/runs": { "post": { "operationId": "runs-sync-axlymxp-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/axlymxp~pinterest-scraper/run-sync": { "post": { "operationId": "run-sync-axlymxp-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": { "searchQueries": { "title": "Search keywords", "type": "array", "description": "Keywords to search on Pinterest, e.g. \"boho bedroom\" or \"wedding cake\". Pinterest returns up to ~1,000 results per keyword.", "default": [ "boho bedroom" ], "items": { "type": "string" } }, "searchType": { "title": "Search for", "enum": [ "pins", "videos", "boards", "users" ], "type": "string", "description": "What the keyword search returns.", "default": "pins" }, "startUrls": { "title": "Pinterest URLs", "type": "array", "description": "Pin, profile, board or search URLs, e.g. https://www.pinterest.com/pin/123/, https://www.pinterest.com/marthastewart/, https://www.pinterest.com/marthastewart/recipes/. pin.it short links work too.", "items": { "type": "string" } }, "maxItems": { "title": "Max rows in total", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many rows across all keywords and URLs. You are charged per row.", "default": 200 }, "maxItemsPerQuery": { "title": "Max rows per keyword", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Per keyword or search URL (Pinterest returns at most ~1,000).", "default": 100 }, "includePinDetails": { "title": "Full pin details", "type": "boolean", "description": "Open every pin for saves, repins, shares, comment count, hashtags, topic tags and product price (one extra request and a small extra charge per pin). Pin URLs always return full details.", "default": false }, "profileContent": { "title": "From profile URLs, also get", "type": "array", "description": "What to collect for each profile URL besides the profile row.", "items": { "type": "string", "enum": [ "created_pins", "saved_pins", "boards" ], "enumTitles": [ "Pins the user created", "Pins the user saved", "Boards" ] }, "default": [ "created_pins" ] }, "maxPinsPerProfile": { "title": "Max pins or boards per profile / board", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Cap for each profile list (created pins, saved pins, boards) and each board's pins. Pinterest shows logged-out visitors up to ~350 created pins and ~25 pins per board.", "default": 50 }, "skipPromoted": { "title": "Skip promoted pins", "type": "boolean", "description": "Leave out ads that Pinterest mixes into search results.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Pinterest works without a proxy; add one only if you see repeated request failures." } } }, "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 } } } } } } } } } }