{ "openapi": "3.0.1", "info": { "title": "Pinterest Search Scraper — Pins, Boards & Users", "description": "Search Pinterest by keyword or Pinterest search URL and get pins, boards and users as one structured JSON dataset with images, links, hashtags, video flags and counts when Pinterest provides them. No login needed; works with Apify MCP and the API.", "version": "1.0", "x-build-id": "89XcnbRSOeg6CTq9h" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~pinterest-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-pinterest-search-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/khadinakbar~pinterest-search-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-pinterest-search-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/khadinakbar~pinterest-search-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-pinterest-search-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 Queries", "type": "array", "description": "Keywords, topics, niches, or hashtags to search on Pinterest (e.g. 'minimalist kitchen', 'fall outfits', 'sourdough'). Enter one or more; each term is searched separately and returns up to Max Results per selected result type. Use plain keywords, not URLs. To scrape a specific board, pin, or profile URL instead, use the pinterest-scraper actor. Required unless you provide Pinterest search URLs in startUrls.", "items": { "type": "string" } }, "startUrls": { "title": "Pinterest search URLs (optional)", "type": "array", "description": "Optional Pinterest search-result URLs to run as-is, for example https://www.pinterest.com/search/pins/?q=minimalist%20kitchen or .../search/boards/?q=wedding. The keyword and result type are read from each URL and combined with searchQueries (duplicates are merged). Pin, board and profile page URLs are not supported here and are skipped with a warning.", "items": { "type": "string" } }, "resultTypes": { "title": "📂 Result Types", "uniqueItems": true, "type": "array", "description": "Which kinds of Pinterest search results to return: 'pins' (images/videos with creator + board metadata), 'boards' (collections with pin/follower counts), 'users' (creator profiles with follower counts). Select any combination. Each selected type multiplies results and cost. Defaults to pins only if omitted.", "items": { "type": "string", "enum": [ "pins", "boards", "users" ], "enumTitles": [ "Pins", "Boards", "Users / Profiles" ] }, "default": [ "pins" ] }, "maxResults": { "title": "📊 Max Results per Query / Type", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum results to return for each search query, per result type. Example: 2 queries × pins+boards × 25 = up to 100 results. Lower values run faster and cost less; use 10–50 for research, 500+ for bulk datasets. Range 1–5000. This is a per-bucket cap, not a total cap.", "default": 50 }, "proxy": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Proxy used to reach Pinterest. Apify Residential proxy is the default and is strongly recommended — Pinterest blocks datacenter IPs. Set a country if you need geo-specific search results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }