{ "openapi": "3.0.1", "info": { "title": "Pinterest Search Scraper — Pins, Boards, Creators", "description": "Search Pinterest by keyword and get pins, video pins, boards or creator profiles as clean rows — images, links, source domain, reactions, follower counts and Pinterest's own topic labels. No account or API key needed.", "version": "0.1", "x-build-id": "rS29p3R48KpSUzmk7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~pinterest-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-pinterest-search", "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/xtracto~pinterest-search/runs": { "post": { "operationId": "runs-sync-xtracto-pinterest-search", "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/xtracto~pinterest-search/run-sync": { "post": { "operationId": "run-sync-xtracto-pinterest-search", "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", "required": [ "queries" ], "properties": { "mode": { "title": "What to search for", "enum": [ "pins", "videos", "boards", "users" ], "type": "string", "description": "Which kind of Pinterest result you want back. 'Pins' is the standard image feed, 'Video pins' returns only pins that have a video, 'Boards' returns whole collections, and 'Creators' returns profiles. Each mode returns its own record shape.", "default": "pins" }, "queries": { "title": "Search terms", "type": "array", "description": "One or more keywords to search Pinterest for, exactly as you would type them into the search box, for example 'home decor' or 'minimalist kitchen'. Each term is searched separately and every result says which term it came from.", "default": [ "home decor" ], "items": { "type": "string" } }, "maxItems": { "title": "Max results per search term", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many results to return for each search term. Pinterest's feed is effectively endless for popular keywords, so this is the main control on run length and cost.", "default": 100 }, "maxPagesPerQuery": { "title": "Max pages per search term", "minimum": 1, "maximum": 60, "type": "integer", "description": "A second safety limit: stop after this many pages even if the result cap has not been reached. Raise it if you ask for a lot of results and see runs stopping early.", "default": 4 }, "includePromoted": { "title": "Include promoted pins", "type": "boolean", "description": "Pinterest mixes paid, promoted pins into search results. Off by default so you only get organic results; turn it on if you are researching what advertisers are running.", "default": false }, "maxConcurrency": { "title": "Search terms in parallel", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many search terms to work on at the same time. Two is a good balance; raise it for speed on long keyword lists, lower it to one if results start coming back empty.", "default": 2 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Pinterest gets stricter as volume goes up, so Residential is recommended for long runs or large keyword lists. Short runs usually work with the proxy turned off.", "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 } } }, "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 } } } } } } } } } }