# Pinterest Board Scraper (Cheap) (`data_api/pinterest-board-scraper-cheap`) Actor Pinterest Board Downloader scrapes every pin from any public board, collecting images and metadata automatically, so you can archive boards or pull Pinterest content into research workflows without doing it by hand. - **URL**: https://apify.com/data\_api/pinterest-board-scraper-cheap.md - **Developed by:** [Data API](https://apify.com/data_api) (community) - **Categories:** Automation, Developer tools, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Board Scraper Saving a Pinterest board by hand means opening pin after pin and copying the image link, title, and source one at a time. This scraper does the whole board for you. Paste a board URL and every pin comes back as a clean row with the image link, title, description, save count, and the creator behind it, ready for a spreadsheet, a download script, or a model. It runs fast, costs little, needs no code, and you only pay for the pins you pull. ![Pinterest Board Scraper](cover.jpg) ### What you get Each pin on the board becomes one row, grouped into a few kinds of data: - **The pin itself** — `pinIdentifier`, `pinLink`, `pinHeadline`, `pinCaption`, `linkedSource`, `mainColor`, `publishedAt` - **Media** — `imageLink`, `videoLink`, `hasVideo`, `imagePixelWidth`, `imagePixelHeight` - **Board and creator** — `boardIdentifier`, `boardTitle`, `boardPath`, `creatorHandle`, `creatorName`, `savesTotal`, `collectedAt` ### Quick start 1. Open the board on Pinterest and copy its URL from the address bar. 2. Hit **Try for free** and paste the link into **Board link** (or drop several into **Board links**). 3. Choose an **Image resolution**, and set a **Page limit** or **Results limit** if you only want part of the board. 4. Press **Start**, then export your pins as JSON, CSV, Excel, or XML. ![How it works](how-it-works.jpg) ### Use cases - **Mood boards and design research** — pull a styling board into a folder of image links you can reuse or sort - **Content planning** — see which pins on a board carry the most saves before you plan your own - **Trend spotting** — track what gets pinned in your niche and how often each pin is saved - **Image datasets** — collect pin images and dimensions to train or test a vision model - **Archiving** — keep a structured copy of a board's pins, captions, and source links before they change ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `boardLink` | string | One of `boardLink` or `boardLinks` | A single Pinterest board URL to pull pins from. | | `boardLinks` | array of strings | One of `boardLink` or `boardLinks` | Several board URLs, one per line, pulled in a single run. | | `startPage` | integer | No | First page of pins to keep, counting from the top of the board (25 pins per page). Default `1`. | | `pageLimit` | integer | No | Last page to fetch; `0` walks the whole board. About 25 pins per page. Default `0`. | | `resultsLimit` | integer | No | Overall cap on pins across all boards; `0` removes the cap. Default `0`. | | `imageResolution` | string | No | Image link size: `high`, `medium`, or `low`. Default `high`. | | `timeoutSeconds` | integer | No | Seconds to wait on each Pinterest request before giving up. Default `45`. | | `proxyConfiguration` | object | No | Proxy settings for requests. Datacenter is the default; Residential blends in better. | #### Example input ```json { "boardLink": "https://www.pinterest.com/finehomedecor/living-room-ideas/", "boardLinks": [ "https://www.pinterest.com/finehomedecor/living-room-ideas/", "https://www.pinterest.com/travelmore/japan-trip/" ], "startPage": 1, "pageLimit": 3, "resultsLimit": 0, "imageResolution": "high", "timeoutSeconds": 45 } ```` ### Output Every pin on the board comes back as one row, paginated automatically up to your limit. Fields Pinterest does not publish for a given pin (a video link on a still image, for instance) come back empty rather than guessed. #### Example output ```json { "pinIdentifier": "1126449530441234567", "pinLink": "https://www.pinterest.com/pin/1126449530441234567/", "pinHeadline": "Warm minimalist living room with oak shelving", "pinCaption": "Neutral palette, layered textures, and a low oak media unit for a calm front room.", "imageLink": "https://i.pinimg.com/originals/ab/cd/ef/abcdef1234567890.jpg", "videoLink": null, "hasVideo": false, "imagePixelWidth": 736, "imagePixelHeight": 1104, "linkedSource": "https://example-decor-blog.com/living-room-tour", "mainColor": "#d8cfc4", "boardIdentifier": "987654321098765432", "boardTitle": "Living Room Ideas", "boardPath": "/finehomedecor/living-room-ideas/", "creatorHandle": "finehomedecor", "creatorName": "Fine Home Decor", "savesTotal": 2841, "publishedAt": "2025-11-03T09:24:11+00:00", "collectedAt": "2026-06-30T12:00:00.000000+00:00" } ``` #### Output fields | Field | Type | Description | |-------|------|-------------| | `pinIdentifier` | string | Pinterest's own ID for the pin | | `pinLink` | string | Full web address of the pin on Pinterest | | `pinHeadline` | string | The pin's title text | | `pinCaption` | string | The pin's description or alt text | | `imageLink` | string | Direct link to the pin image at the resolution you chose | | `videoLink` | string | Direct link to the pin video, present only on video pins | | `hasVideo` | boolean | True when the pin is a video rather than a still image | | `imagePixelWidth` | integer | Width of the original image, in pixels | | `imagePixelHeight` | integer | Height of the original image, in pixels | | `linkedSource` | string | The outbound page the pin points to | | `mainColor` | string | Dominant hex color of the pin image | | `boardIdentifier` | string | Pinterest's internal ID for the board | | `boardTitle` | string | Name of the board the pin was taken from | | `boardPath` | string | Relative URL path of the board | | `creatorHandle` | string | Username of the person who saved the pin | | `creatorName` | string | Full display name of the person who saved the pin | | `savesTotal` | integer | How many times the pin has been saved | | `publishedAt` | string | ISO 8601 timestamp of when the pin was first created | | `collectedAt` | string | ISO 8601 timestamp of when this row was captured | ### Tips for best results - **Try a small slice first.** Set `pageLimit` to 2 or 3 to confirm the output fits your pipeline before you pull the whole board. - **Match the resolution to the job.** `high` gives full-size originals for downloads; `low` keeps things light when you only need thumbnails. - **Grab a middle section with the page range.** Use `startPage` and `pageLimit` together to skip the top of a long board and keep just the pins you want. - **Pass several boards at once.** `boardLinks` runs each board in turn, while `resultsLimit` keeps the total across all of them in check. - **Raise `timeoutSeconds`** if large boards or a slower proxy tier start throwing timeouts. ### How can I use Pinterest board data? **How can I use the Pinterest Board Scraper to download every image on a board?** Paste the board URL into `boardLink`, set `imageResolution` to `high`, and run it. Each row carries an `imageLink` (and a `videoLink` on video pins), so you can feed the export straight into a download script and pull the full board in one pass. **How can I find the most-saved pins on a Pinterest board?** Pull the board, then sort the rows by `savesTotal`. Alongside `pinHeadline`, `pinLink`, and `linkedSource`, that tells you which pins resonate most before you plan your own content or study a competitor's board. **How can I build a Pinterest image dataset for research?** Drop one or more boards into `boardLinks`, set a `resultsLimit` for the volume you need, and export to CSV or JSON. You get a structured table of image links, dimensions, captions, and dominant colors that drops cleanly into a vision pipeline. **How can I archive a Pinterest board before it changes?** Run the scraper on a schedule and keep each export. Every row preserves the pin's `pinIdentifier`, `pinCaption`, `linkedSource`, and `publishedAt`, so you hold a dated snapshot of the board even after pins are edited or removed. ### Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses or private contact information. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). ### Support Questions, feature requests, or a field you'd like added? Reach out at and we'll get back to you. # Actor input Schema ## `boardLink` (type: `string`): A single Pinterest board URL to pull pins from. Reach for this when you only have one board. ## `boardLinks` (type: `array`): Several Pinterest board URLs, one per line. Use this when you want to pull pins from more than one board in a single run. ## `startPage` (type: `integer`): The earliest page of pins to save, where page 1 is the top of the board. Pair it with Page limit to grab a slice in the middle. Each page holds up to 25 pins. Default `1`. ## `pageLimit` (type: `integer`): The last page to fetch. Leave it at 0 to walk the whole board. Since a page carries up to 25 pins, a limit of 3 returns roughly 75 pins. Default `0`. ## `resultsLimit` (type: `integer`): An overall ceiling on how many pins you collect across every board. Set it to 0 to remove the cap. Works together with the page range. Default `0`. ## `imageResolution` (type: `string`): Which size of image link to return. High gives you the full-size original; low returns a small thumbnail. ## `timeoutSeconds` (type: `integer`): How long to wait on a single Pinterest request before giving up. Raise it for very large boards or slower proxies. Default `45`. ## `proxyConfiguration` (type: `object`): Pick the proxies used for requests. They keep you below rate limits and away from IP blocks. Datacenter proxies are the quickest; Residential proxies blend in better. ## Actor input object example ```json { "boardLink": "https://www.pinterest.com/finehomedecor/living-room-ideas/", "boardLinks": [ "https://www.pinterest.com/finehomedecor/living-room-ideas/", "https://www.pinterest.com/travelmore/japan-trip/" ], "startPage": 1, "pageLimit": 3, "resultsLimit": 0, "imageResolution": "high", "timeoutSeconds": 45, "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 = { "boardLink": "https://www.pinterest.com/mashaleschishin5/procreate/", "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("data_api/pinterest-board-scraper-cheap").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 = { "boardLink": "https://www.pinterest.com/mashaleschishin5/procreate/", "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("data_api/pinterest-board-scraper-cheap").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 '{ "boardLink": "https://www.pinterest.com/mashaleschishin5/procreate/", "proxyConfiguration": { "useApifyProxy": true } }' | apify call data_api/pinterest-board-scraper-cheap --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=data_api/pinterest-board-scraper-cheap", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pinterest Board Scraper (Cheap)", "description": "Pinterest Board Downloader scrapes every pin from any public board, collecting images and metadata automatically, so you can archive boards or pull Pinterest content into research workflows without doing it by hand.", "version": "0.0", "x-build-id": "heXaJg9NSn7Nhxr3c" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_api~pinterest-board-scraper-cheap/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_api-pinterest-board-scraper-cheap", "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/data_api~pinterest-board-scraper-cheap/runs": { "post": { "operationId": "runs-sync-data_api-pinterest-board-scraper-cheap", "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/data_api~pinterest-board-scraper-cheap/run-sync": { "post": { "operationId": "run-sync-data_api-pinterest-board-scraper-cheap", "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": { "boardLink": { "title": "Board link", "type": "string", "description": "A single Pinterest board URL to pull pins from. Reach for this when you only have one board." }, "boardLinks": { "title": "Board links", "type": "array", "description": "Several Pinterest board URLs, one per line. Use this when you want to pull pins from more than one board in a single run.", "items": { "type": "string" } }, "startPage": { "title": "First page to keep", "minimum": 1, "type": "integer", "description": "The earliest page of pins to save, where page 1 is the top of the board. Pair it with Page limit to grab a slice in the middle. Each page holds up to 25 pins. Default `1`.", "default": 1 }, "pageLimit": { "title": "Page limit", "minimum": 0, "type": "integer", "description": "The last page to fetch. Leave it at 0 to walk the whole board. Since a page carries up to 25 pins, a limit of 3 returns roughly 75 pins. Default `0`.", "default": 0 }, "resultsLimit": { "title": "Results limit", "minimum": 0, "maximum": 10000, "type": "integer", "description": "An overall ceiling on how many pins you collect across every board. Set it to 0 to remove the cap. Works together with the page range. Default `0`.", "default": 0 }, "imageResolution": { "title": "Image resolution", "enum": [ "high", "medium", "low" ], "type": "string", "description": "Which size of image link to return. High gives you the full-size original; low returns a small thumbnail.", "default": "high" }, "timeoutSeconds": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait on a single Pinterest request before giving up. Raise it for very large boards or slower proxies. Default `45`.", "default": 45 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Pick the proxies used for requests. They keep you below rate limits and away from IP blocks. Datacenter proxies are the quickest; Residential proxies blend in better." } } }, "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 } } } } } } } } } } ```