# Pinterest Scraper - Pins, Boards, Profiles & Search (`cryptosignals/pinterest-scraper`) Actor Extracts Pinterest pins, boards, and search results. Returns pin images, descriptions, save counts, board names, and creator profiles. - **URL**: https://apify.com/cryptosignals/pinterest-scraper.md - **Developed by:** [CryptoSignals Agent](https://apify.com/cryptosignals) (community) - **Categories:** Social media, E-commerce, Lead generation - **Stats:** 4 total users, 1 monthly users, 92.2% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $10.00 / 1,000 result scrapeds 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 Scraper — Pins, Boards, Profiles & Search Extract data from Pinterest at scale — **no API key needed**. Search for pins by keyword, scrape entire boards, extract profile information, or get details from individual pins. Export results to **JSON, CSV, Excel**, or connect directly to your workflow via **Zapier or Make.com** integration. ### Why Use Pinterest Scraper? Pinterest is one of the largest visual discovery platforms with over 450 million monthly active users. Whether you're doing market research, tracking visual trends, monitoring competitors, or building a dataset for machine learning — this scraper gives you structured data from Pinterest without the complexity of the official API. **No API key needed.** No Pinterest developer account required. Just configure your input, run the actor, and download your data. ### Features - **Search pins** by keyword with language filtering - **Scrape boards** — extract all pins from any public Pinterest board - **Scrape profiles** — get user information and their pins - **Pin details** — extract full metadata from individual pins - **Multi-language support** — search in English, German, French, Spanish, and 20+ more languages - **Configurable limits** — control how many items to return (up to 500 per run) - **JSON & CSV export** — download results in JSON, CSV, Excel, XML, or RSS - **Zapier / Make.com integration** — connect to 5,000+ apps via webhooks and integrations - **Scheduled runs** — set up recurring scrapes to track trends over time - **No rate limit worries** — the actor handles pagination and throttling automatically - **No API key needed** — zero setup, no developer account required ### Input Schema | Field | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | `action` | string | Yes | `"search"` | What to scrape: `search`, `board`, `profile`, or `pin` | | `query` | string | For search | — | Keyword to search for (required when action is `search`) | | `url` | string | For board/profile/pin | — | Pinterest URL of the board, profile, or pin | | `maxItems` | integer | No | `50` | Maximum number of items to return (1–500) | | `language` | string | No | `"en"` | Language code for search results (e.g., `en`, `de`, `fr`, `es`) | #### Action Types - **`search`** — Search Pinterest for pins matching a keyword. Requires `query`. - **`board`** — Scrape all pins from a Pinterest board. Requires `url` (e.g., `https://www.pinterest.com/username/board-name/`). - **`profile`** — Scrape a user's profile information and pins. Requires `url` (e.g., `https://www.pinterest.com/username/`). - **`pin`** — Get detailed information about a single pin. Requires `url` (e.g., `https://www.pinterest.com/pin/123456789/`). ### Output Schema Each result contains structured data depending on the action type. Here's a sample output for a **search** result: ```json { "id": "17099673582268820", "type": "pin", "title": "Minimalist Home Office Setup", "description": "Clean workspace inspiration with natural lighting", "link": "https://example.com/article", "domain": "example.com", "imageUrl": "https://i.pinimg.com/originals/ab/cd/ef/abcdef123456.jpg", "allImages": { "170x": "https://i.pinimg.com/170x/ab/cd/ef/abcdef123456.jpg", "236x": "https://i.pinimg.com/236x/ab/cd/ef/abcdef123456.jpg", "474x": "https://i.pinimg.com/474x/ab/cd/ef/abcdef123456.jpg", "736x": "https://i.pinimg.com/736x/ab/cd/ef/abcdef123456.jpg", "orig": "https://i.pinimg.com/originals/ab/cd/ef/abcdef123456.jpg" }, "saveCount": 1250, "commentCount": 23, "pinUrl": "https://www.pinterest.com/pin/17099673582268820/", "pinner": { "name": "Jane Doe", "username": "janedoe" }, "board": { "name": "Home Office Ideas", "url": "/janedoe/home-office-ideas/" } } ```` #### Profile Result Sample ```json { "id": "12345", "type": "user", "username": "janedoe", "fullName": "Jane Doe", "about": "Interior design enthusiast", "followerCount": 15000, "followingCount": 500, "pinCount": 5000, "boardCount": 45, "profileImage": "https://i.pinimg.com/...", "profileUrl": "https://www.pinterest.com/janedoe/", "boards": [] } ``` ### Code Examples #### Python ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") ## Search for pins run = client.actor("cryptosignals/pinterest-scraper").call(run_input={ "action": "search", "query": "home office design ideas", "maxItems": 100, "language": "en" }) ## Fetch results for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(f"Pin: {item['title']} | Saves: {item.get('saveCount', 'N/A')}") print(f"Image: {item.get('imageUrl', '')}") print("---") ``` ```python ## Scrape a Pinterest board and export to CSV run = client.actor("cryptosignals/pinterest-scraper").call(run_input={ "action": "board", "url": "https://www.pinterest.com/pinterest/pin-of-the-week/", "maxItems": 200 }) ## Download as CSV dataset = client.dataset(run["defaultDatasetId"]) items = dataset.list_items().items print(f"Scraped {len(items)} pins from the board") ``` #### JavaScript ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN' }); // Search for pins const run = await client.actor('cryptosignals/pinterest-scraper').call({ action: 'search', query: 'sustainable fashion', maxItems: 50, language: 'en' }); // Fetch results const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach(item => { console.log(`Pin: ${item.title} | Saves: ${item.saveCount}`); console.log(`Image: ${item.imageUrl}`); }); ``` ```javascript // Scrape a user profile const profileRun = await client.actor('cryptosignals/pinterest-scraper').call({ action: 'profile', url: 'https://www.pinterest.com/designmilk/', maxItems: 100 }); const { items: profilePins } = await client.dataset(profileRun.defaultDatasetId).listItems(); console.log(`Found ${profilePins.length} pins from this profile`); ``` ### Use Cases #### Market Research & Trend Analysis Track visual trends across industries. Search for keywords related to your market and analyze which types of content get the most saves. Identify emerging design trends, color palettes, and product styles before they go mainstream. #### Competitive Analysis Monitor competitor Pinterest boards to understand their content strategy. Track how often they pin, what boards they maintain, and which of their pins perform best. #### E-commerce Product Research Find trending products and styles on Pinterest. Scrape boards related to your product category to understand what consumers are saving and sharing. #### Content Curation & Inspiration Build datasets of visual inspiration for design projects. Scrape boards organized by theme, style, or color palette. Export images with metadata for mood boards and creative briefs. #### Social Media Marketing Analyze top-performing pins in your niche to understand what content resonates. Track save counts and engagement over time to create data-driven content strategies. #### Machine Learning & AI Training Collect labeled image datasets from Pinterest for computer vision projects. Use pin descriptions and board names as labels for image classification, style transfer, or recommendation systems. #### Academic Research Study visual culture, design trends, and user behavior on social platforms. Collect structured data for quantitative analysis of visual content sharing patterns. ### Integrations This actor works seamlessly with the Apify platform ecosystem: - **Zapier** — Trigger workflows when new data is scraped. Send Pinterest data to Google Sheets, Slack, email, or 5,000+ apps. - **Make.com (Integromat)** — Build complex automation workflows with Pinterest data as a trigger or data source. - **Google Sheets** — Export results directly to Google Sheets for collaborative analysis. - **Webhooks** — Send results to any HTTP endpoint in real-time. - **API** — Access results programmatically via the Apify API in any language. - **Scheduled runs** — Set up daily, weekly, or hourly scraping schedules. ### FAQ #### Do I need a Pinterest API key? No. This scraper works without any Pinterest API key or developer account. Just provide your Apify API token and configure the input. #### How many pins can I scrape? Each run can return up to 500 items. For larger datasets, run the actor multiple times with different queries or use Apify's scheduling feature. #### Can I export to CSV or JSON? Yes. Results are stored in an Apify dataset that can be exported to JSON, CSV, Excel (XLSX), XML, or RSS with a single click. You can also download results programmatically via the API. #### Does the scraper work with private boards? No. The scraper only accesses publicly available content on Pinterest. Private boards and pins are not accessible. #### How often should I scrape? For trending topics, consider running daily or weekly. Use Apify's scheduling feature to automate recurring scrapes. #### Can I filter search results by date? Pinterest's search doesn't support date filtering directly. However, you can post-process the data to filter by the `created_at` timestamp in the output. #### What happens if Pinterest blocks the scraper? The actor includes built-in retry logic and request throttling. If you experience issues, try reducing `maxItems` or running at different times. #### Can I use this with Zapier or Make.com? Yes! Apify has native integrations with both Zapier and Make.com (formerly Integromat). You can trigger Zaps or Make scenarios whenever a scraping run completes. #### What output formats are available? You can download results in JSON, CSV, Excel (XLSX), XML, HTML, or RSS format. The API also supports direct streaming of results. #### Is there a free trial? Apify offers a free tier with $5 of monthly platform usage, which is enough for small scraping jobs. The actor itself has no additional cost. ### Legal & Compliance This actor scrapes only **publicly available data** from Pinterest. It does not access private accounts, private boards, or any content that requires authentication. **Important considerations:** - Comply with Pinterest's Terms of Service and your local data protection laws (GDPR, CCPA, etc.) when using scraped data. - Do not use this tool for spam, harassment, or any illegal purpose. - Scraped data should be used responsibly. If you collect personal information, ensure you have a lawful basis for processing it. - The actor does not download or store images on Apify's servers — it only extracts metadata and image URLs. - For commercial use, consult your legal team regarding compliance with applicable regulations. - Pinterest content may be subject to copyright. Respect the intellectual property rights of content creators. This tool is intended for legitimate purposes such as market research, academic study, competitive analysis, and data journalism. ### Pricing This actor runs on the Apify platform. You pay only for compute and proxy usage — there are no additional fees for the actor itself. Apify offers a free tier with $5 of monthly usage, which is enough for small scraping jobs. ### Limitations - Public content only — cannot access private boards or pins - Pinterest may change their internal structure without notice — the actor includes fallback extraction methods - Maximum 500 items per run - Rate limiting is handled automatically with built-in retries ### Using proxies Pinterest aggressively blocks scraping attempts — it detects datacenter IPs, enforces strict rate limits, and serves login walls or empty responses to suspected bots. Residential proxies rotate through real household IPs that Pinterest treats as normal user traffic. [ThorData](https://thordata.partnerstack.com/partner/0a0x4nzjr3ky) offers 200M+ residential IPs with session persistence, which helps maintain consistent access to Pinterest's dynamic content. # Actor input Schema ## `action` (type: `string`): What to scrape from Pinterest ## `query` (type: `string`): Keyword to search for (required when action is search) ## `maxItems` (type: `integer`): Maximum number of items to return ## Actor input object example ```json { "action": "search", "query": "photography", "maxItems": 5 } ``` # 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 = { "action": "search", "query": "photography", "maxItems": 5 }; // Run the Actor and wait for it to finish const run = await client.actor("cryptosignals/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 = { "action": "search", "query": "photography", "maxItems": 5, } # Run the Actor and wait for it to finish run = client.actor("cryptosignals/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 '{ "action": "search", "query": "photography", "maxItems": 5 }' | apify call cryptosignals/pinterest-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=cryptosignals/pinterest-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pinterest Scraper - Pins, Boards, Profiles & Search", "description": "Extracts Pinterest pins, boards, and search results. Returns pin images, descriptions, save counts, board names, and creator profiles.", "version": "1.0", "x-build-id": "xsjOFTwfeCaKv1YIV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cryptosignals~pinterest-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cryptosignals-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/cryptosignals~pinterest-scraper/runs": { "post": { "operationId": "runs-sync-cryptosignals-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/cryptosignals~pinterest-scraper/run-sync": { "post": { "operationId": "run-sync-cryptosignals-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": [ "action" ], "properties": { "action": { "title": "Action", "enum": [ "search", "board", "profile", "pin" ], "type": "string", "description": "What to scrape from Pinterest", "default": "search" }, "query": { "title": "Search Query", "type": "string", "description": "Keyword to search for (required when action is search)", "default": "photography" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of items to return", "default": 10 } } }, "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 } } } } } } } } } } ```