{ "openapi": "3.0.1", "info": { "title": "Pinterest Profile Scraper — Bio, Links & Recent Pins", "description": "Scrape any public Pinterest profile by username — bio, website links, follower count, join date, boards and its most recent pins. Also finds profiles by keyword and enriches each one with the same detail. No login needed. Export to CSV, JSON or Excel, or run via API.", "version": "0.0", "x-build-id": "sgm9mL0fLJ1Gw7e5I" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/afanasenko~pinterest-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-afanasenko-pinterest-profile-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/afanasenko~pinterest-profile-scraper/runs": { "post": { "operationId": "runs-sync-afanasenko-pinterest-profile-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/afanasenko~pinterest-profile-scraper/run-sync": { "post": { "operationId": "run-sync-afanasenko-pinterest-profile-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", "required": [ "operationMode" ], "properties": { "operationMode": { "title": "Mode", "enum": [ "profiles", "profilePins", "findProfiles" ], "type": "string", "description": "What this run should do. Each mode has its own section below." }, "profilesUsernames": { "title": "Pinterest usernames", "type": "array", "description": "One per line. A username (nasa), an @handle (@nasa) or a profile link all work. Pin links and board links do not — they point at content, not at an account.", "default": [], "items": { "type": "string" } }, "profilesMaxItems": { "title": "Max profiles", "minimum": 0, "type": "integer", "description": "Stop after this many profiles. 0 = no limit of your own (free plan still stops at 10).", "default": 0 }, "profilePinsUsernames": { "title": "Pinterest usernames", "type": "array", "description": "One per line. Same formats as Mode 1: a username, an @handle or a profile link.", "default": [], "items": { "type": "string" } }, "profilePinsMaxItems": { "title": "Max profiles", "minimum": 0, "type": "integer", "description": "Stop after this many profiles — not pins. Each profile returns up to 10 pins. 0 = no limit of your own (free plan still stops at 10).", "default": 0 }, "findProfilesKeywords": { "title": "Keywords", "type": "array", "description": "One per line. Letters, digits and spaces only — Pinterest search rejects punctuation, hashtags, emoji and non-Latin scripts.", "default": [], "items": { "type": "string" } }, "findProfilesMaxItems": { "title": "Max profiles", "minimum": 0, "type": "integer", "description": "Stop after this many profiles across all keywords. 0 = no limit of your own (free plan still stops at 10).", "default": 0 }, "minFollowers": { "title": "Minimum followers", "minimum": 0, "type": "integer", "description": "Drop profiles below this follower count. 0 = off.", "default": 0 }, "onlyProfilesWithWebsite": { "title": "Only profiles with a website link", "type": "boolean", "description": "Keep only accounts that publish at least one outbound link on their profile.", "default": false }, "websiteDomainContains": { "title": "Website domain contains", "type": "string", "description": "Comma-separated. Keeps only profiles whose website link matches one of these, for example: shopify,etsy", "default": "" }, "excludeAdsOnlyProfiles": { "title": "Exclude ads-only profiles", "type": "boolean", "description": "Drop accounts Pinterest marks as advertising-only, which publish no organic pins.", "default": false } } }, "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 } } } } } } } } } }