# Pinterest Scraper - Scrape Pins, Boards & Profiles (`logiover/pinterest-scraper`) Actor Pinterest API alternative — scrape pins, boards & profiles without login. Export Pinterest data to CSV/JSON: images, videos, links & save counts. - **URL**: https://apify.com/logiover/pinterest-scraper.md - **Developed by:** [Logiover](https://apify.com/logiover) (community) - **Categories:** Social media, Marketing, Business - **Stats:** 805 total users, 11 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.99 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 — Scrape Pins, Boards & Profiles #### Scrape Pinterest pins by keyword, board, profile or pin URL — images, videos, links & save counts. No login.
![No login](https://img.shields.io/badge/✓_No_login-no_cookies-2ea44f?style=for-the-badge) ![No API key](https://img.shields.io/badge/✓_No_API_key-needed-2ea44f?style=for-the-badge) ![High volume](https://img.shields.io/badge/📦_Thousands-of_pins-1f6feb?style=for-the-badge) ![Export](https://img.shields.io/badge/Export-JSON·CSV·Excel·API-f59e0b?style=for-the-badge) ![Account safe](https://img.shields.io/badge/0%25-ban_risk-9333ea?style=for-the-badge)
**Point it at a keyword, board, profile or pin URL and pull structured Pinterest data — full-resolution images, video URLs, outbound links, pinner, board and save counts.** The fast, no-API-key way to build Pinterest datasets at scale.
--- ### 📌 Overview The **Pinterest Scraper** collects public Pinterest data through four entry points: **keyword search**, **board URLs**, **usernames / profile URLs** and **individual pin URLs or IDs**. Every pin comes back with complete metadata: title, description, outbound link, full-resolution image, video URL (when it's a video pin), pinner, board, dominant colour and **repin / save count**. It paginates each input to pull **hundreds to thousands of pins** in a single run. It needs **no login, no cookies and no API key** — it reads only public data through US residential proxies, so there's **zero risk to any Pinterest account**. With no headless browser, it's a **fast and low-cost** way to build large Pinterest datasets. > ✅ Add many keywords, boards or creators and raise `maxItemsPerInput` to assemble an > **analysis-ready Pinterest dataset** in a single run. --- ### ✨ Features | | Feature | Description | |---|---|---| | 🔎 | **Keyword search** | Search pins for any term and paginate the results feed. | | 📌 | **Board pins** | Pull every pin from a board, plus the board's own metadata. | | 👤 | **Profiles + pins + boards** | A creator's profile, their created pins and all their boards. | | 📍 | **Pin detail** | Fetch a single pin with full detail incl. **repin / save count**. | | 🖼️ | **Media included** | Full-resolution `images.orig` URL and video URL for video pins. | | 🔗 | **Outbound links** | The pin's destination link for affiliate / SEO / e-commerce research. | | ⚡ | **No browser** | Lightweight JSON resource access — fast and cheap at scale. | | 🛡️ | **Login-free & safe** | Public access over US residential proxies — no account, no ban risk. | | 📤 | **Any format** | Export to JSON, CSV, Excel, HTML or pull via API & webhooks. | --- ### 🎯 Who it's for - **Marketers & content teams** — find top-performing pins and creative angles by keyword. - **E-commerce & affiliate** — collect product pins with outbound links and save counts. - **Trend & competitor research** — track what's saved most in your niche. - **Data science & ML** — build labelled image/text datasets for vision & NLP models. --- ### 🧾 Input | Field | Type | Description | |-------|------|-------------| | `searchTerms` | array | Keywords to search pins for (`home decor`, `recipes`). | | `boardUrls` | array | Board URLs to scrape pins from. | | `usernames` | array | Usernames or profile URLs — returns profile + their pins + boards. | | `pinUrls` | array | Individual pin URLs for full detail (incl. save count). | | `pinIds` | array | Individual numeric pin IDs — alternative to `pinUrls`. | | `maxItemsPerInput` | integer | Pins to collect per search / board / user. Default `200`. | | `maxResults` | integer | Global cap on items saved. `0` = unlimited. | | `proxyConfiguration` | object | US residential proxy (required). Pre-configured for you. | > Provide **at least one** of `searchTerms`, `boardUrls`, `usernames`, `pinUrls` or `pinIds`. #### Example input ```json { "searchTerms": ["home decor", "recipes"], "maxItemsPerInput": 300, "maxResults": 1000 } ```` *** ### 📦 Output Each pin is saved as one structured record: ```json { "id": "1234567890", "title": "Cozy minimalist living room", "description": "Warm neutral palette with natural wood accents.", "link": "https://example.com/living-room-ideas", "pinUrl": "https://www.pinterest.com/pin/1234567890/", "imageUrl": "https://i.pinimg.com/originals/ab/cd/ef/abcdef.jpg", "isVideo": false, "videoUrl": null, "dominantColor": "#c8b6a6", "repinCount": 4821, "commentCount": 12, "reactionCount": 530, "pinner": { "username": "homestyle", "fullName": "Home Style", "id": "9988" }, "board": { "name": "Living Rooms", "url": "https://www.pinterest.com/homestyle/living-rooms/", "id": "77" }, "fromSearch": "home decor", "scrapedAt": "2026-06-04T10:00:00.000Z" } ``` #### 📖 Output field reference | Field | Description | |-------|-------------| | `title` / `description` | Pin title and description text | | `link` | Outbound destination link of the pin | | `imageUrl` | Full-resolution (`orig`) image URL | | `isVideo` / `videoUrl` | Video flag and direct video URL for video pins | | `repinCount` / `commentCount` / `reactionCount` | Save count and engagement | | `dominantColor` | Dominant colour hex of the image | | `pinner` | Creator: username, full name, id | | `board` | Board the pin belongs to: name, URL, id | | `pinUrl` | Direct link to the pin | | `recordType` | `board` or `profile` for those record types (pins have none) | Board and profile inputs also emit `recordType: "board"` and `recordType: "profile"` records with their own metadata (pin count, follower count, etc.). *** ### ⚙️ How it works 1. You provide **keywords, board URLs, usernames or pin URLs/IDs**. 2. The actor opens a sticky US residential session to read public Pinterest data. 3. Each input is walked with cursor pagination across the relevant feed. 4. Every pin is parsed into a clean record and streamed to the dataset. No login, no cookies, no API keys — and **no Pinterest account is ever used or risked**. *** ### ❓ FAQ #### Is this a Pinterest API alternative? Yes. It reads public Pinterest data — pins, boards, profiles and search results — without the official Pinterest API, a developer app, OAuth or API keys. Just paste keywords, boards, usernames or pin URLs and run. #### Does it need login or cookies? No. The Actor reads public Pinterest data only — no login, no cookies you provide, no developer API key. No Pinterest account is used, so there's zero ban risk. #### How many pins can I scrape? Hundreds to thousands — it paginates each input, and you control depth with `maxItemsPerInput` and the global `maxResults` cap. #### Can I get full-resolution images and video URLs? Yes — each pin includes the original-size (`images.orig`) image URL, and video pins include a direct video URL. Outbound destination links are captured too. #### Are save (repin) counts included? Yes — captured for every pin; single-pin detail mode returns the most accurate save count. #### Why residential US proxies? Pinterest serves its data reliably to US residential traffic. The default proxy is pre-configured — just leave it as-is. #### How do I export Pinterest data to CSV or JSON? Run the Actor, then download the dataset as CSV, JSON, Excel or HTML — or pull it via API and webhooks. Every pin's images, links and save counts come through structured. #### Can I scrape Pinterest without an API key or login? Yes. This is a Pinterest API alternative that reads public data with no developer app, OAuth, API key, login or cookies — so there's no Pinterest account and no ban risk. #### Is there a Pinterest board or image scraper here too? Yes. Point it at board URLs to pull every pin plus board metadata, and each pin returns its full-resolution image and video URL — a board, image and profile scraper in one. *** ### 🔗 Works great with - 🐦 **X (Twitter) Tweet Scraper** — pair social feeds for cross-platform trend analysis. - 🌐 **Website Content Crawler** — enrich pin outbound links with page content. ***
**Pinterest Scraper · Scrape Pinterest Pins · Pinterest Board Scraper · Pinterest Profile Scraper · Pinterest Image Scraper · Pinterest Search Scraper · No-API-key Pinterest data · Pinterest API Alternative · Scrape Pinterest Without Login · Export Pinterest Data to CSV/JSON · Pinterest Data Export Tool** ⚖️ Collects publicly available Pinterest data only. You are responsible for compliance with Pinterest's Terms and applicable laws, including bulk-access limits.
### 📝 Changelog #### 2026-06-07 - Docs: added coverage for Pinterest API alternative use, exporting Pinterest data to CSV/JSON, and scraping boards/images without login. #### 2026-06-05 - 🛡️ Reliability fix: results are no longer dropped by strict output validation — runs now complete cleanly even at high volume (thousands of results). - ⚡ Stability & performance hardening; fresh rebuild. #### 2026-06-04 - Verified live & refreshed build — reliability/maintenance pass. # Actor input Schema ## `searchTerms` (type: `array`): Keywords to search Pinterest pins for. Examples: 'home decor', 'recipes', 'minimalist tattoo'. ## `boardUrls` (type: `array`): Pinterest board URLs to scrape pins from. Example: 'https://www.pinterest.com/username/board-name/'. ## `usernames` (type: `array`): Pinterest usernames or profile URLs. Returns the profile, the user's created pins and their boards. ## `pinUrls` (type: `array`): Individual pin URLs to fetch full detail for (incl. repin/save count). Example: 'https://www.pinterest.com/pin/12345/'. ## `pinIds` (type: `array`): Individual numeric pin IDs to fetch full detail for. Alternative to Pin URLs. ## `maxItemsPerInput` (type: `integer`): How many pins to collect per search term / board / user (paginated). Boards & profiles are always included. ## `maxResults` (type: `integer`): Global cap on items saved across all inputs. 0 = unlimited. ## `proxyConfiguration` (type: `object`): Pinterest requires US residential proxies. Leave the default (Apify Proxy · RESIDENTIAL · US). ## Actor input object example ```json { "searchTerms": [ "home decor", "recipes" ], "boardUrls": [ "https://www.pinterest.com/pinterest/official-news/" ], "usernames": [ "pinterest", "https://www.pinterest.com/nasa/" ], "pinUrls": [ "https://www.pinterest.com/pin/1234567890/" ], "pinIds": [ "1234567890" ], "maxItemsPerInput": 25, "maxResults": 0, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `title` (type: `string`): Pin title ## `description` (type: `string`): Pin description ## `pinner` (type: `string`): Creator ## `repinCount` (type: `string`): Repin/save count ## `imageUrl` (type: `string`): Image URL ## `link` (type: `string`): Outbound link ## `pinUrl` (type: `string`): Pin URL # 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 = { "searchTerms": [ "home decor" ], "maxItemsPerInput": 25, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("logiover/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 = { "searchTerms": ["home decor"], "maxItemsPerInput": 25, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("logiover/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 '{ "searchTerms": [ "home decor" ], "maxItemsPerInput": 25, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call logiover/pinterest-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=logiover/pinterest-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pinterest Scraper - Scrape Pins, Boards & Profiles", "description": "Pinterest API alternative — scrape pins, boards & profiles without login. Export Pinterest data to CSV/JSON: images, videos, links & save counts.", "version": "1.0", "x-build-id": "M1AGMlc8Q8od7pgeo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~pinterest-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-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/logiover~pinterest-scraper/runs": { "post": { "operationId": "runs-sync-logiover-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/logiover~pinterest-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search Pinterest pins for. Examples: 'home decor', 'recipes', 'minimalist tattoo'.", "items": { "type": "string" } }, "boardUrls": { "title": "Board URLs", "type": "array", "description": "Pinterest board URLs to scrape pins from. Example: 'https://www.pinterest.com/username/board-name/'.", "items": { "type": "string" } }, "usernames": { "title": "Usernames / profile URLs", "type": "array", "description": "Pinterest usernames or profile URLs. Returns the profile, the user's created pins and their boards.", "items": { "type": "string" } }, "pinUrls": { "title": "Pin URLs", "type": "array", "description": "Individual pin URLs to fetch full detail for (incl. repin/save count). Example: 'https://www.pinterest.com/pin/12345/'.", "items": { "type": "string" } }, "pinIds": { "title": "Pin IDs", "type": "array", "description": "Individual numeric pin IDs to fetch full detail for. Alternative to Pin URLs.", "items": { "type": "string" } }, "maxItemsPerInput": { "title": "Max items per input", "minimum": 1, "type": "integer", "description": "How many pins to collect per search term / board / user (paginated). Boards & profiles are always included.", "default": 200 }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Global cap on items saved across all inputs. 0 = unlimited.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Pinterest requires US residential proxies. Leave the default (Apify Proxy · RESIDENTIAL · US).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } } ```