# Pinterest Intelligence (`botflowtech/pinterest-intelligence`) Actor - **URL**: https://apify.com/botflowtech/pinterest-intelligence.md - **Developed by:** [BotFlowTech](https://apify.com/botflowtech) (community) - **Categories:** Social media, Marketing - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 pinterest results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Pinterest Intelligence — Pins, Profiles, Boards & Influencer Discovery > *"The most comprehensive Pinterest scraper on Apify. Search trending pins, discover niche influencers, monitor competitor boards, and extract full profile analytics."* --- ### What It Does This actor supports **four powerful modes**, each targeting a different Pinterest intelligence use case: #### 1. `search` — Trending Pin Search Search any keyword on Pinterest and extract trending pins sorted by engagement. Get save counts, creator details, source URLs, and a computed virality score for every pin. Ideal for content research, trend discovery, and niche validation. #### 2. `profile` — Full Profile Scraper Scrape a complete Pinterest profile: follower count, monthly views, pin count, board count, bio, website URL, verified status, top boards, and up to 5,000 recent pins with full engagement metrics. #### 3. `board` — Board Intelligence Extract every pin from a specific Pinterest board with complete engagement data. Track competitor boards, monitor brand content calendars, or build curated pin datasets. #### 4. `influencers` — Influencer Discovery Search a niche keyword, then automatically visit every creator's profile who appears in the results. Returns a ranked list of influencers sorted by monthly views, including follower counts, average pin saves, top pin URL, website, and visible contact email. The highest-value mode for brand marketers. --- ### Use Cases | Industry / Role | How They Use It | |---|---| | **E-commerce brands** | Find trending product pins in their niche to model their own content | | **Marketing agencies** | Discover Pinterest influencers for brand partnership outreach | | **SEO / content teams** | Research what visual content goes viral on Pinterest by keyword | | **Competitor monitoring** | Track a competitor's board and pin cadence over time | | **AI / ML teams** | Collect large labeled image datasets from Pinterest for training | | **Affiliate marketers** | Find high-save pins in their niche to model content after | | **Market researchers** | Gauge consumer interest in topics by measuring pin save volumes | --- ### Input Reference | Field | Type | Default | Description | |---|---|---|---| | `mode` | string (enum) | `"search"` | Operating mode: `search`, `profile`, `board`, or `influencers` | | `keywords` | string[] | `[]` | Keywords to search. Used in `search` and `influencers` modes | | `profileUrls` | string[] | `[]` | Pinterest profile URLs. Used in `profile` mode | | `boardUrls` | string[] | `[]` | Pinterest board URLs. Used in `board` mode | | `maxPins` | integer | `100` | Max pins to extract per search/profile/board (max 5,000) | | `maxProfiles` | integer | `50` | Max influencer profiles to visit in `influencers` mode (max 500) | | `country` | string (enum) | `"us"` | Country locale for trending content: `us`, `uk`, `ca`, `au`, `in`, `de`, `fr`, `br`, `es`, `it`, `mx` | | `includeVideos` | boolean | `true` | Whether to include video pins | | `minSaves` | integer | `0` | Filter: only return pins with at least this many saves (e.g. `1000` for viral-only) | --- ### Example Inputs #### Mode: Search ```json { "mode": "search", "keywords": ["yoga for beginners", "morning routine"], "maxPins": 200, "minSaves": 500, "country": "us" } ```` #### Mode: Profile ```json { "mode": "profile", "profileUrls": [ "https://www.pinterest.com/joannagaines/", "https://www.pinterest.com/minimalistbaker/" ], "maxPins": 50 } ``` #### Mode: Board ```json { "mode": "board", "boardUrls": [ "https://www.pinterest.com/joannagaines/farmhouse-decor/", "https://www.pinterest.com/buzzfeedtasty/easy-weeknight-dinners/" ], "maxPins": 300 } ``` #### Mode: Influencers ```json { "mode": "influencers", "keywords": ["home decor", "interior design"], "maxProfiles": 30, "country": "us" } ``` *** ### Example Output #### Pin Result (Search / Board mode) ```json { "type": "pin", "pinId": "714305099326578432", "title": "Morning Yoga Flow for Beginners — 15 Minutes", "description": "Start your morning with this gentle 15-minute yoga flow. Perfect for beginners. No equipment needed. #yoga #morningroutine #wellness", "pinUrl": "https://www.pinterest.com/pin/714305099326578432/", "imageUrl": "https://i.pinimg.com/originals/a3/b2/c1/a3b2c1d4e5f6a7b8c9d0e1f2a3b4c5d6.jpg", "videoUrl": null, "sourceUrl": "https://www.yogawithadriene.com", "saves": 45821, "comments": 312, "creatorUsername": "yogaadriene", "creatorDisplayName": "Yoga With Adriene", "creatorFollowers": 2100000, "creatorMonthlyViews": 8750000, "boardName": "Morning Routines", "tags": ["yoga"], "pinType": "image", "isPromoted": false, "viralityScore": 2.194, "scrapedAt": "2026-04-03T08:00:00.000Z" } ``` #### Influencer Result (Influencers mode) ```json { "type": "influencer", "creatorUsername": "modernminimalhome", "creatorDisplayName": "Ashley Chen — Modern Minimal", "creatorFollowers": 847000, "creatorMonthlyViews": 12400000, "avgPinSaves": 3850, "topPinUrl": "https://www.pinterest.com/pin/823401987234501234/", "profileUrl": "https://www.pinterest.com/modernminimalhome/", "websiteUrl": "https://modernminimalhome.com", "email": "ashley@modernminimalhome.com", "bio": "Interior designer & content creator. DM for collabs: ashley@modernminimalhome.com", "tags": ["home decor"], "scrapedAt": "2026-04-03T08:00:00.000Z" } ``` *** ### Output Fields Reference | Field | Type | Description | |---|---|---| | `type` | string | Always `"pin"`, `"profile"`, or `"influencer"` | | `pinId` | string | Pinterest numeric pin ID | | `title` | string | Pin title | | `description` | string | Pin description / caption | | `pinUrl` | string | Full Pinterest pin URL | | `imageUrl` | string | Highest-resolution image URL | | `videoUrl` | string | Video URL (MP4/HLS), only for video pins | | `sourceUrl` | string | The external website the pin links to | | `saves` | number | Number of saves/repins — primary engagement metric | | `comments` | number | Number of comments | | `creatorUsername` | string | Creator's Pinterest username | | `creatorDisplayName` | string | Creator's display name | | `creatorFollowers` | number | Creator's follower count | | `creatorMonthlyViews` | number | Creator's monthly views on Pinterest | | `boardName` | string | Name of the board this pin belongs to | | `tags` | string\[] | Topic/category tags | | `pinType` | string | `"image"`, `"video"`, `"story"`, or `"idea"` | | `isPromoted` | boolean | Whether this is a paid/promoted pin | | `viralityScore` | number | Computed as `(saves × 10 + comments × 5) / max(1, followers)`. Higher = more viral relative to audience | | `bio` | string | Profile bio (profile/influencer type) | | `websiteUrl` | string | Website linked on profile | | `followingCount` | number | Number of accounts followed | | `pinCount` | number | Total pins on profile | | `boardCount` | number | Total boards on profile | | `profileImageUrl` | string | Profile picture URL | | `isVerified` | boolean | Whether the account is verified | | `topBoards` | object\[] | Top boards with name, URL, pin count | | `recentPins` | object\[] | Last N pins with full pin data | | `nicheCategories` | string\[] | Inferred niche categories (e.g. `["fitness", "wellness"]`) | | `avgPinSaves` | number | Influencer's average saves per pin | | `topPinUrl` | string | URL of influencer's highest-performing pin | | `email` | string | Contact email if visible in profile bio | | `scrapedAt` | string | ISO 8601 timestamp of when this item was extracted | *** ### Pricing **$3.00 per 1,000 results** (pay-per-result model). | Run type | Approx. cost | |---|---| | 100 pins (default) | ~$0.30 | | 1,000 pins | ~$3.00 | | 50 influencer profiles | ~$0.15 | | Full profile with 500 pins | ~$1.50 | *** ### Tips for Best Results 1. **Use specific keywords** — `"keto meal prep for beginners"` will return more focused results than `"food"`. Long-tail keywords have higher-saves pins because they attract dedicated audiences. 2. **Set `minSaves` to filter for viral content** — For trend research, set `minSaves: 1000` to see only pins that have already proven viral. For niche research, try `minSaves: 100`. 3. **Influencer mode works best with niche keywords** — `"minimalist home decor"` will find more actionable influencers than `"decor"`. The more specific the keyword, the more relevant the influencer list. 4. **Use `country` to get region-specific trends** — Pinterest trends differ significantly by region. Use `"in"` (India) or `"br"` (Brazil) for emerging market research. 5. **Board mode for competitor monitoring** — Save your competitor's board URLs and run this actor weekly with `maxPins: 50` to see their latest published content. Compare virality scores over time. 6. **Chain modes for deep research** — First run `influencers` mode to get top creator usernames, then run `profile` mode on those usernames to get their full board and pin data. *** ### Technical Notes - Extracts data primarily from Pinterest's embedded page JSON (`window.__PWS_INITIAL_STRING__`) — the same data Pinterest's own app uses, providing more reliable and complete data than DOM parsing alone. - Falls back to DOM selectors when embedded JSON is not available. - Implements infinite scroll automation to load full pin grids up to `maxPins`. - Detects login walls gracefully and skips rather than crashing. - Rotates desktop user agents across Chrome, Firefox, Safari, and Edge fingerprints. - Uses Apify residential proxies by default to avoid IP-level blocks. - Maximum concurrency is capped at 3 to avoid triggering rate limits. *** ### License Apache 2.0 # Actor input Schema ## `mode` (type: `string`): What to scrape: search pins by keyword, scrape a profile, scrape a board, or discover influencers in a niche. ## `keywords` (type: `array`): Keywords to search on Pinterest. Used in 'search' and 'influencers' modes. Example: \["yoga", "home decor", "keto recipes"] ## `profileUrls` (type: `array`): Pinterest profile URLs to scrape. Used in 'profile' mode. Example: \["https://www.pinterest.com/username/"] ## `boardUrls` (type: `array`): Pinterest board URLs to scrape. Used in 'board' mode. Example: \["https://www.pinterest.com/username/board-name/"] ## `maxPins` (type: `integer`): Maximum number of pins to extract per search/board/profile. ## `maxProfiles` (type: `integer`): Maximum number of influencer profiles to return in influencers mode. ## `country` (type: `string`): Country context for trending content (affects locale and trending results). ## `includeVideos` (type: `boolean`): Whether to include video pins in the results. ## `minSaves` (type: `integer`): Only return pins with at least this many saves/repins. Use to filter for viral content (e.g. set to 1000 for high-engagement pins only). ## Actor input object example ```json { "mode": "search", "keywords": [], "profileUrls": [], "boardUrls": [], "maxPins": 100, "maxProfiles": 50, "country": "us", "includeVideos": true, "minSaves": 0 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("botflowtech/pinterest-intelligence").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("botflowtech/pinterest-intelligence").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call botflowtech/pinterest-intelligence --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=botflowtech/pinterest-intelligence", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pinterest Intelligence", "version": "0.1", "x-build-id": "N81SE5OCI68wdSen8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/botflowtech~pinterest-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-botflowtech-pinterest-intelligence", "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/botflowtech~pinterest-intelligence/runs": { "post": { "operationId": "runs-sync-botflowtech-pinterest-intelligence", "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/botflowtech~pinterest-intelligence/run-sync": { "post": { "operationId": "run-sync-botflowtech-pinterest-intelligence", "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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "profile", "board", "influencers" ], "type": "string", "description": "What to scrape: search pins by keyword, scrape a profile, scrape a board, or discover influencers in a niche.", "default": "search" }, "keywords": { "title": "Keywords", "type": "array", "description": "Keywords to search on Pinterest. Used in 'search' and 'influencers' modes. Example: [\"yoga\", \"home decor\", \"keto recipes\"]", "items": { "type": "string" }, "default": [] }, "profileUrls": { "title": "Profile URLs", "type": "array", "description": "Pinterest profile URLs to scrape. Used in 'profile' mode. Example: [\"https://www.pinterest.com/username/\"]", "items": { "type": "string" }, "default": [] }, "boardUrls": { "title": "Board URLs", "type": "array", "description": "Pinterest board URLs to scrape. Used in 'board' mode. Example: [\"https://www.pinterest.com/username/board-name/\"]", "items": { "type": "string" }, "default": [] }, "maxPins": { "title": "Max Pins", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of pins to extract per search/board/profile.", "default": 100 }, "maxProfiles": { "title": "Max Profiles (Influencer mode)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of influencer profiles to return in influencers mode.", "default": 50 }, "country": { "title": "Country / Region", "enum": [ "us", "uk", "ca", "au", "in", "de", "fr", "br", "es", "it", "mx" ], "type": "string", "description": "Country context for trending content (affects locale and trending results).", "default": "us" }, "includeVideos": { "title": "Include Video Pins", "type": "boolean", "description": "Whether to include video pins in the results.", "default": true }, "minSaves": { "title": "Minimum Saves (Repins)", "minimum": 0, "type": "integer", "description": "Only return pins with at least this many saves/repins. Use to filter for viral content (e.g. set to 1000 for high-engagement pins only).", "default": 0 } } }, "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 } } } } } } } } } } ```