# Pinterest Pin, Board & Profile Scraper (`brilliant_gum/pinterest-scraper`) Actor Scrape Pinterest pins, boards, and user profiles via the internal Pinterest API. Supports search (pins/boards), board feed, and user profile modes. Extracts full pin details including image URLs, save counts, rich pin data, hashtags, pinner info, and more. Includes analytics: top domains, trendin... - **URL**: https://apify.com/brilliant\_gum/pinterest-scraper.md - **Developed by:** [Yuliia Kulakova](https://apify.com/brilliant_gum) (community) - **Categories:** Social media, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $30.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 Scraper — Pins, Boards & Profiles [![Pinterest Scraper](https://i.imgur.com/Qfvzimi.png)](https://apify.com/store) Scrape Pinterest at scale. Search pins by keyword, discover boards, or analyze any public profile. Extract high-res images, save counts, hashtags, video URLs, rich pin data, pinner info, and more. ### What can this scraper do? - **Search pins** by any keyword — get images, saves, comments, hashtags, and original source links - **Search boards** — find boards by topic with pin counts, follower counts, and owner info - **Scrape user profiles** — collect all boards and pins from any public Pinterest account - **Built-in analytics** — automatic stats summary: top domains, trending hashtags, saves distribution, video ratio, and more ### Why use Pinterest Scraper? | Use case | How it helps | |----------|-------------| | Content research | Find trending pins and hashtags in your niche | | Brand monitoring | Track pins linking to your domain | | Competitor analysis | Analyze competitor profiles and their top-performing pins | | Visual trend analysis | Discover trending styles via color and category analytics | | Influencer research | Find top pinners and engagement metrics | | Market research | Understand what content performs best by category | ### Output data #### Pin data Each pin includes all available metadata: | Field | Description | |-------|-------------| | Pin ID & URL | Unique identifier and direct link | | Title & description | Full text content of the pin | | Image URL | High-resolution image (up to original size) | | Saves & comments | Engagement metrics including reactions | | Original link & domain | Source website the pin links to | | Video URL | For video pins — all quality levels | | Rich pin data | Article title, site name for rich pins | | Pinner info | Username, followers, verified status | | Board name & URL | Which board the pin belongs to | | Hashtags & auto-tags | Pinterest-detected tags and user hashtags | | Category & date | Content category and creation date | | Dominant color | Primary color from the image | #### Board data | Field | Description | |-------|-------------| | Board ID, name & URL | Board identification | | Description | Board description | | Pin count | Total pins on the board | | Follower count | Board followers | | Cover image | Board cover image URL | | Owner info | Username, display name, followers, verified status | #### Built-in analytics Every run can include an automatic analytics summary: - Top source domains across all pins - Saves distribution histogram - Trending hashtags - Category breakdown - Video vs static pin ratio - Rich pin percentage - Top pinners in your result set ### Scraping modes | Mode | What it does | Input | |------|-------------|-------| | `search_pins` | Search for pins by keyword | `queries` | | `search_boards` | Search for boards by keyword | `queries` | | `user_profile` | Scrape all boards and pins from a user | `usernames` | ### Filters & sorting | Filter | Description | |--------|-------------| | Minimum saves | Only include pins with N+ saves | | Domain filter | Only pins linking to a specific domain | | Video filter | Include or exclude video pins | | Date filter | Only pins created after a specific date | | Sort by | Relevance, recent, or popular | ### How much does it cost? Pinterest Scraper uses a **pay-per-result** model at **$0.03 per result** (pin or board). No monthly fees — you only pay for the data you collect. | Results | Cost | |---------|------| | 100 pins | $3.00 | | 500 pins | $15.00 | | 1,000 pins | $30.00 | | 10,000 pins | $300.00 | Platform costs (compute + proxy) are included in the per-result price. ### Input examples #### Search pins by keyword ```json { "mode": "search_pins", "queries": ["minimalist home office", "desk setup ideas"], "maxItems": 100, "sortBy": "popular", "minSaves": 500 } ```` #### Find boards by topic ```json { "mode": "search_boards", "queries": ["vegan recipes", "healthy meal prep"], "maxItems": 50 } ``` #### Brand monitoring — find pins linking to your website ```json { "mode": "search_pins", "queries": ["handmade jewelry", "artisan necklace"], "maxItems": 200, "filterByDomain": "etsy.com", "sortBy": "recent" } ``` #### Competitor analysis — full profile scrape ```json { "mode": "user_profile", "usernames": ["nasa", "nike"], "maxItems": 300, "includeAnalytics": true } ``` ### Tips for best results 1. **Start small** — test with `maxItems: 25` to verify your filters before scaling up 2. **Use specific queries** — more specific keywords yield more relevant results 3. **Domain filter** — great for tracking which of your pages are being pinned 4. **Combine modes** — use `search_pins` for discovery, then `user_profile` for deep dives on interesting pinners 5. **Popular sort** — use `sortBy: "popular"` with `minSaves` to find only high-performing content ### Limitations - Only public Pinterest data is accessible (no private boards or profiles) - Pinterest may rate-limit requests — the scraper handles this with automatic retries and residential proxies - Analytics summary is included as the last record in the dataset (field `type: "analytics"`) # Actor input Schema ## `mode` (type: `string`): Choose what to scrape. • search\_pins — keyword search for pins • search\_boards — keyword search for boards • user\_profile — boards and pins from specific Pinterest usernames ## `queries` (type: `array`): Search keywords for 'search\_pins' and 'search\_boards' modes. Each query runs independently. ## `usernames` (type: `array`): Pinterest usernames for 'user\_profile' mode. Do not include '@'. Example: \["nasa", "nike"] ## `maxItems` (type: `integer`): Maximum number of pins (or boards) to collect per query or username. 0 means no limit. ## `minSaves` (type: `integer`): Only include pins with at least this many saves. Leave at 0 for no filter. ## `filterByDomain` (type: `string`): Only include pins whose original link comes from this domain. Useful for brand monitoring. Example: "apple.com" or "nytimes.com" ## `includeVideo` (type: `boolean`): When false, video pins are skipped. When true (default), video pins are included with their video URL extracted. ## `dateFrom` (type: `string`): Only include pins created on or after this date. Format: YYYY-MM-DD. Example: "2024-01-01" ## `sortBy` (type: `string`): Sort order for search results. 'relevance' is Pinterest's default ranking. Only applies to search modes. ## `includeAnalytics` (type: `boolean`): After scraping, compute and push an analytics record: top domains, saves distribution, category distribution, trending hashtags, and dominant color analysis across pin images. ## `proxyConfiguration` (type: `object`): Apify proxy settings. Residential proxies are strongly recommended for reliable Pinterest access. ## Actor input object example ```json { "mode": "search_pins", "queries": [ "minimalist home decor", "vegan recipes" ], "usernames": [ "nasa", "nike" ], "maxItems": 25, "minSaves": 0, "filterByDomain": "apple.com", "includeVideo": true, "dateFrom": "2024-01-01", "sortBy": "relevance", "includeAnalytics": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "mode": "search_pins", "queries": [ "minimalist home decor" ], "maxItems": 25 }; // Run the Actor and wait for it to finish const run = await client.actor("brilliant_gum/pinterest-scraper").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 = { "mode": "search_pins", "queries": ["minimalist home decor"], "maxItems": 25, } # Run the Actor and wait for it to finish run = client.actor("brilliant_gum/pinterest-scraper").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 '{ "mode": "search_pins", "queries": [ "minimalist home decor" ], "maxItems": 25 }' | apify call brilliant_gum/pinterest-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=brilliant_gum/pinterest-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pinterest Pin, Board & Profile Scraper", "description": "Scrape Pinterest pins, boards, and user profiles via the internal Pinterest API. Supports search (pins/boards), board feed, and user profile modes. Extracts full pin details including image URLs, save counts, rich pin data, hashtags, pinner info, and more. Includes analytics: top domains, trendin...", "version": "1.0", "x-build-id": "jBzU8ncKaaTEvuXgv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/brilliant_gum~pinterest-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-brilliant_gum-pinterest-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/brilliant_gum~pinterest-scraper/runs": { "post": { "operationId": "runs-sync-brilliant_gum-pinterest-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/brilliant_gum~pinterest-scraper/run-sync": { "post": { "operationId": "run-sync-brilliant_gum-pinterest-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": [ "mode" ], "properties": { "mode": { "title": "Scraping Mode", "enum": [ "search_pins", "search_boards", "user_profile" ], "type": "string", "description": "Choose what to scrape.\n• search_pins — keyword search for pins\n• search_boards — keyword search for boards\n• user_profile — boards and pins from specific Pinterest usernames", "default": "search_pins" }, "queries": { "title": "Search Queries", "type": "array", "description": "Search keywords for 'search_pins' and 'search_boards' modes. Each query runs independently.", "items": { "type": "string" }, "default": [] }, "usernames": { "title": "Pinterest Usernames", "type": "array", "description": "Pinterest usernames for 'user_profile' mode. Do not include '@'. Example: [\"nasa\", \"nike\"]", "items": { "type": "string" }, "default": [] }, "maxItems": { "title": "Max Items Per Query / Username", "minimum": 0, "maximum": 50000, "type": "integer", "description": "Maximum number of pins (or boards) to collect per query or username. 0 means no limit.", "default": 100 }, "minSaves": { "title": "Minimum Saves (Repins)", "minimum": 0, "type": "integer", "description": "Only include pins with at least this many saves. Leave at 0 for no filter.", "default": 0 }, "filterByDomain": { "title": "Filter by Source Domain", "type": "string", "description": "Only include pins whose original link comes from this domain. Useful for brand monitoring. Example: \"apple.com\" or \"nytimes.com\"" }, "includeVideo": { "title": "Include Video Pins", "type": "boolean", "description": "When false, video pins are skipped. When true (default), video pins are included with their video URL extracted.", "default": true }, "dateFrom": { "title": "Created After (ISO Date)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only include pins created on or after this date. Format: YYYY-MM-DD. Example: \"2024-01-01\"" }, "sortBy": { "title": "Sort Results By", "enum": [ "relevance", "recent", "popular" ], "type": "string", "description": "Sort order for search results. 'relevance' is Pinterest's default ranking. Only applies to search modes.", "default": "relevance" }, "includeAnalytics": { "title": "Include Analytics Summary", "type": "boolean", "description": "After scraping, compute and push an analytics record: top domains, saves distribution, category distribution, trending hashtags, and dominant color analysis across pin images.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy settings. Residential proxies are strongly recommended for reliable Pinterest access.", "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 } } } } } } } } } } ```