{ "openapi": "3.0.1", "info": { "title": "Pinterest Business Leads & Email Finder", "description": "Find businesses on Pinterest by keyword and export their public contact email, phone, website, street address, followers and monthly views. Built for outreach to photographers, designers, shops and creators. No login or cookies. Pay only for profiles you get.", "version": "1.0", "x-build-id": "sAAhiVMYhGA7ws2Og" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axlymxp~pinterest-business-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axlymxp-pinterest-business-leads", "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-business-leads/runs": { "post": { "operationId": "runs-sync-axlymxp-pinterest-business-leads", "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-business-leads/run-sync": { "post": { "operationId": "run-sync-axlymxp-pinterest-business-leads", "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": "Niche or business keywords to search Pinterest profiles for, e.g. \"wedding photographer\", \"interior designer london\", \"bakery\". Each keyword returns up to ~1,000 profiles (Pinterest's own limit).", "default": [ "wedding photographer", "interior designer" ], "items": { "type": "string" } }, "profiles": { "title": "Profiles to enrich (optional)", "type": "array", "description": "Pinterest usernames or profile URLs to look up directly, e.g. \"https://www.pinterest.com/marthastewart/\" or \"marthastewart\".", "items": { "type": "string" } }, "maxLeads": { "title": "Max leads", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop after this many rows in total. You are charged per row.", "default": 100 }, "maxProfilesPerQuery": { "title": "Max profiles checked per keyword", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many search results to look up per keyword (Pinterest returns at most ~1,000).", "default": 200 }, "onlyWithContact": { "title": "Only profiles with an email or phone", "type": "boolean", "description": "Skip profiles that show neither a contact email nor a phone. Skipped profiles are not charged.", "default": false }, "requireEmail": { "title": "Only profiles with an email", "type": "boolean", "description": "Skip profiles without a public contact email.", "default": false }, "businessOnly": { "title": "Business accounts only", "type": "boolean", "description": "Skip personal accounts (only business accounts can show contact details).", "default": true }, "minFollowers": { "title": "Minimum followers", "minimum": 0, "type": "integer", "description": "Skip profiles with fewer followers.", "default": 0 }, "addressCountries": { "title": "Business address countries (optional)", "type": "array", "description": "Keep only businesses whose profile address is in these countries (2-letter codes, e.g. US, GB). Only businesses that show an address can match, so this filter removes most rows.", "items": { "type": "string" } }, "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 } } } } } } } } } }