# 📌 Pinterest Pins, Boards & Profiles Scraper (`khadinakbar/pinterest-scraper`) Actor - **URL**: https://apify.com/khadinakbar/pinterest-scraper.md - **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community) - **Categories:** Social media, SEO tools, Marketing - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 Pins, Boards & Profiles Scraper ### What does Pinterest Scraper do? Pinterest Scraper extracts structured data from Pinterest pins, boards, profiles, and search results — no login, no API key, no cookies required. Supply a keyword, a board URL, a profile URL, or individual pin links and get back a rich JSON dataset ready for analysis, AI pipelines, or export to CSV and Excel. ### Why use Pinterest Scraper? - **Faster and cheaper than the alternatives.** Pure HTTP-based extraction means no browser overhead — scrape thousands of pins at a fraction of the cost of browser-based tools. Pay only for what you scrape with PAY_PER_EVENT pricing at **$0.003/pin**. - **4 input modes in one actor.** Search by keyword, scrape a full board, pull a user's profile pins, or target individual pin URLs — combine all modes in a single run. - **Richer data than any competitor.** Every pin record includes 27 structured fields: full-resolution image URLs, video URLs, engagement metrics, creator profile stats, board follower counts, outbound links, dominant color, hashtags, product prices, and more. ### What data can Pinterest Scraper extract? | Field | Type | Description | |-------|------|-------------| | `pin_id` | string | Pinterest unique pin ID | | `title` | string | Pin title | | `description` | string | Pin description (HTML stripped) | | `pin_url` | string | Full URL to the pin | | `image_url` | string | Full-resolution image URL | | `image_width` | number | Image width in pixels | | `image_height` | number | Image height in pixels | | `dominant_color` | string | Dominant hex color of image | | `is_video` | boolean | True if pin is a video | | `video_url` | string | Direct MP4 video URL (video pins only) | | `save_count` | number | Number of saves / repins | | `comment_count` | number | Number of comments | | `hashtags` | string[] | Array of hashtag strings | | `link` | string | Outbound link URL | | `source_domain` | string | Domain of the outbound link | | `price` | string | Product price (product pins only) | | `board_name` | string | Board the pin belongs to | | `board_url` | string | Full board URL | | `board_follower_count` | number | Board follower count | | `pinner_username` | string | Creator's Pinterest username | | `pinner_display_name` | string | Creator's display name | | `pinner_follower_count` | number | Creator's follower count | | `pinner_following_count` | number | Creator's following count | | `pinner_pin_count` | number | Creator's total pin count | | `pinner_profile_url` | string | Creator's profile URL | | `created_at` | string | ISO 8601 pin creation timestamp | | `scraped_at` | string | ISO 8601 scrape timestamp | | `source_url` | string | Source URL used for this scrape | --- ### How to Scrape Pinterest — Tutorial #### Step 1: Choose your input mode **Search by keyword** — Find pins matching a topic, trend, or niche: ```json { "searchQueries": ["minimalist kitchen design", "wedding table decor"], "maxPins": 100 } ```` **Scrape a board** — Extract all pins from a specific Pinterest board: ```json { "boardUrls": ["https://www.pinterest.com/pinterest/official-news/"], "maxPins": 200 } ``` **Scrape a profile** — Pull recent pins from a user's profile: ```json { "profileUrls": ["https://www.pinterest.com/designerjane/"], "maxPins": 150 } ``` **Scrape individual pins** — Get data for specific pins by URL: ```json { "pinUrls": [ "https://www.pinterest.com/pin/241294492639523463/", "https://www.pinterest.com/pin/578538823428729456/" ] } ``` **Combine modes in one run:** ```json { "searchQueries": ["scandinavian interior design"], "boardUrls": ["https://www.pinterest.com/mydesigner/favorites/"], "maxPins": 50 } ``` #### Step 2: Configure proxy The default proxy setting (`useApifyProxy: true`) works for most use cases. For high-volume scraping or if you hit rate limits, switch to residential proxies in the proxy configuration. #### Step 3: Export your data Results export to JSON, CSV, or Excel directly from the Apify Console dataset view. You can also access results via the Apify API or connect to Google Sheets, Make, Zapier, or any data pipeline. *** ### Use Cases **Content Marketing & Trend Research** Identify which pins get the most saves in your niche. Analyze hashtags, descriptions, and image styles that drive engagement. Build a content calendar based on what's already working. **E-commerce & Competitive Analysis** Monitor competitor boards and profiles. Track product pins with pricing data. See which product images resonate with Pinterest's audience. **Influencer Discovery** Find high-follower Pinterest creators in specific niches. Filter by follower count, engagement (save count), and content style. Outbound links reveal which creators drive traffic to specific domains. **Visual AI & Dataset Building** Collect large labelled image datasets with metadata (dominant color, dimensions, hashtags) for computer vision and visual AI projects. **SEO & Keyword Research** Extract trending pin titles, hashtags, and descriptions from search results. Discover low-competition visual keywords driving Pinterest traffic. **Brand Monitoring** Track which external domains are being linked from Pinterest pins. Monitor how your brand and competitor brands appear across boards. *** ### Pricing This actor uses **PAY\_PER\_EVENT pricing** — you pay only for the data you actually scrape. No monthly fees. | Tier | Price per Pin | |------|--------------| | FREE | $0.003 | | BRONZE | $0.003 | | SILVER | $0.0023 | | GOLD | $0.0018 | | PLATINUM | $0.0012 | | DIAMOND | $0.00084 | **Cost examples:** - 100 pins = ~$0.30 (FREE tier) - 1,000 pins = ~$3.00 (FREE tier), ~$1.80 (GOLD) - 10,000 pins = ~$30.00 (FREE), ~$12.00 (PLATINUM) *** ### Input Reference | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `searchQueries` | string\[] | — | Pinterest keyword search terms | | `boardUrls` | string\[] | — | Pinterest board URLs to scrape | | `pinUrls` | string\[] | — | Individual Pinterest pin URLs | | `profileUrls` | string\[] | — | Pinterest profile URLs | | `maxPins` | integer | 50 | Max pins per query/board/profile (1–10000) | | `proxy` | object | Apify Proxy | Proxy configuration | *** ### Output Reference Each scraped pin is a JSON record with 27 fields. See the full field list above. All optional fields return `null` when not available — the output shape is always consistent. **Sample output record:** ```json { "pin_id": "241294492639523463", "title": "Modern Minimalist Kitchen", "description": "Clean lines and natural materials define this beautiful kitchen space.", "pin_url": "https://www.pinterest.com/pin/241294492639523463/", "image_url": "https://i.pinimg.com/originals/ab/cd/ef/abcdef.jpg", "image_width": 736, "image_height": 1104, "dominant_color": "#f5f0eb", "is_video": false, "video_url": null, "save_count": 4821, "comment_count": 12, "hashtags": ["minimalist", "kitchen", "homedesign"], "link": "https://myinterior.com/minimalist-kitchen", "source_domain": "myinterior.com", "price": null, "board_name": "Home Inspiration", "board_url": "https://www.pinterest.com/designerjane/home-inspiration/", "board_follower_count": 15200, "pinner_username": "designerjane", "pinner_display_name": "Jane Design Co", "pinner_follower_count": 88400, "pinner_following_count": 312, "pinner_pin_count": 2450, "pinner_profile_url": "https://www.pinterest.com/designerjane/", "created_at": "2024-11-15T12:34:00.000Z", "scraped_at": "2026-04-13T10:30:00.000Z", "source_url": "https://www.pinterest.com/search/pins/?q=minimalist+kitchen" } ``` *** ### Run via API ```bash curl -X POST "https://api.apify.com/v2/acts/khadinakbar~pinterest-scraper/runs?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "searchQueries": ["minimalist kitchen design"], "maxPins": 50 }' ``` Schedule runs, monitor status, and fetch results via the [Apify API](https://docs.apify.com/api/v2). *** ### FAQ **Does it require a Pinterest login or API key?** No. This scraper accesses Pinterest's public data without requiring an account, login, or API credentials. **How many pins can I scrape per run?** Up to 10,000 pins per query/board/profile per run. Run multiple inputs in parallel for larger datasets. **Can I scrape private boards or private accounts?** No. This scraper only accesses publicly available Pinterest content. **What if Pinterest blocks the scraper?** The actor uses Apify Proxy by default, which rotates IPs to avoid rate limits. For aggressive scraping, switch to residential proxies in the proxy configuration. **Can I run this on a schedule?** Yes. Use Apify's built-in scheduling to run the scraper hourly, daily, or weekly for ongoing trend monitoring. **Does it support video pins?** Yes. Video pins include a `video_url` field with a direct MP4 link and `is_video: true`. *** ### Related Actors - [Instagram Reels Scraper](https://apify.com/khadinakbar/instagram-reels-scraper) — Extract reels, captions, and engagement from Instagram - [TikTok Video Comments Scraper](https://apify.com/khadinakbar/tiktok-video-comments-scraper) — Scrape comments from TikTok videos - [Twitter Profile & Followers Scraper](https://apify.com/khadinakbar/twitter-profile-followers-scraper) — Extract Twitter/X profiles and followers *** ### Legal Disclaimer This actor is intended for lawful collection of publicly available data from Pinterest. Users are solely responsible for ensuring their use complies with Pinterest's Terms of Service, applicable laws, and data protection regulations including GDPR and CCPA. The author does not endorse or encourage any use that violates Pinterest's terms or applicable law. Use responsibly. # Actor input Schema ## `searchQueries` (type: `array`): Use this field when the user wants to search Pinterest by keyword, topic, niche, or hashtag. Enter one or more terms. Each query returns up to maxPins results. Do NOT use this when you have specific board or profile URLs — use boardUrls or profileUrls instead. ## `boardUrls` (type: `array`): Use this field when the user provides a specific Pinterest board URL. Scrapes all pins from the board. Format: https://www.pinterest.com/username/board-name/. Do NOT use this for keyword searches — use searchQueries instead. ## `pinUrls` (type: `array`): Use this field when the user provides individual Pinterest pin URLs. Scrapes data for each specific pin. Format: https://www.pinterest.com/pin/PIN\_ID/. Use for targeted extraction of known pins. ## `profileUrls` (type: `array`): Use this field when the user provides a Pinterest profile or username URL. Scrapes recent pins from those profiles. Format: https://www.pinterest.com/username/. Do NOT use this for boards — use boardUrls instead. ## `maxPins` (type: `integer`): Maximum number of pins to extract per search query, board, or profile. Lower values run faster and cost less. Use 25–50 for quick research; 500+ for bulk datasets. Range: 1–10000. ## `proxy` (type: `object`): Proxy settings for the scraper. Apify Proxy is recommended for reliable Pinterest access. ## Actor input object example ```json { "searchQueries": [ "minimalist kitchen design" ], "boardUrls": [ "https://www.pinterest.com/pinterest/official-news/" ], "pinUrls": [ "https://www.pinterest.com/pin/241294492639523463/" ], "profileUrls": [ "https://www.pinterest.com/pinterest/" ], "maxPins": 25, "proxy": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): All scraped Pinterest pins as structured JSON records. Export as JSON, CSV, or Excel. # 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 = { "searchQueries": [ "minimalist kitchen design" ], "boardUrls": [ "https://www.pinterest.com/pinterest/official-news/" ], "pinUrls": [ "https://www.pinterest.com/pin/241294492639523463/" ], "profileUrls": [ "https://www.pinterest.com/pinterest/" ], "maxPins": 25, "proxy": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("khadinakbar/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 = { "searchQueries": ["minimalist kitchen design"], "boardUrls": ["https://www.pinterest.com/pinterest/official-news/"], "pinUrls": ["https://www.pinterest.com/pin/241294492639523463/"], "profileUrls": ["https://www.pinterest.com/pinterest/"], "maxPins": 25, "proxy": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("khadinakbar/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 '{ "searchQueries": [ "minimalist kitchen design" ], "boardUrls": [ "https://www.pinterest.com/pinterest/official-news/" ], "pinUrls": [ "https://www.pinterest.com/pin/241294492639523463/" ], "profileUrls": [ "https://www.pinterest.com/pinterest/" ], "maxPins": 25, "proxy": { "useApifyProxy": true } }' | apify call khadinakbar/pinterest-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=khadinakbar/pinterest-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "📌 Pinterest Pins, Boards & Profiles Scraper", "version": "1.0", "x-build-id": "h9wb2JOPNfFje6dCf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~pinterest-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-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/khadinakbar~pinterest-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-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/khadinakbar~pinterest-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-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", "properties": { "searchQueries": { "title": "🔍 Search Queries", "type": "array", "description": "Use this field when the user wants to search Pinterest by keyword, topic, niche, or hashtag. Enter one or more terms. Each query returns up to maxPins results. Do NOT use this when you have specific board or profile URLs — use boardUrls or profileUrls instead.", "items": { "type": "string" } }, "boardUrls": { "title": "📋 Board URLs", "type": "array", "description": "Use this field when the user provides a specific Pinterest board URL. Scrapes all pins from the board. Format: https://www.pinterest.com/username/board-name/. Do NOT use this for keyword searches — use searchQueries instead.", "items": { "type": "string" } }, "pinUrls": { "title": "📌 Pin URLs", "type": "array", "description": "Use this field when the user provides individual Pinterest pin URLs. Scrapes data for each specific pin. Format: https://www.pinterest.com/pin/PIN_ID/. Use for targeted extraction of known pins.", "items": { "type": "string" } }, "profileUrls": { "title": "👤 Profile URLs", "type": "array", "description": "Use this field when the user provides a Pinterest profile or username URL. Scrapes recent pins from those profiles. Format: https://www.pinterest.com/username/. Do NOT use this for boards — use boardUrls instead.", "items": { "type": "string" } }, "maxPins": { "title": "📊 Max Pins per Query / Board / Profile", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of pins to extract per search query, board, or profile. Lower values run faster and cost less. Use 25–50 for quick research; 500+ for bulk datasets. Range: 1–10000.", "default": 50 }, "proxy": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Proxy settings for the scraper. Apify Proxy is recommended for reliable Pinterest access.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```