# Pinterest Pins Scraper (`scrapers_lat/pinterest-scraper`) Actor Extract Pinterest pins by keyword, board, user, or pin URL: image, title, description, board, pinner, saves, comments, outbound link, color and dimensions. - **URL**: https://apify.com/scrapers\_lat/pinterest-scraper.md - **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community) - **Categories:** Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $7.00 / 1,000 pin scrapeds 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/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 Scraper](https://scrapers.lat/banners/pinterest-scraper.png)](https://console.apify.com/actors/i86oIN3vBeUtR5Gtu/input) ## Pinterest Pins Scraper Here is one real result, with every field the actor returns (long `destinationUrl` trimmed for readability; the actor returns the full URL): ```json { "imageUrl": "https://i.pinimg.com/originals/2c/24/91/2c24917f5d44c73a48b10de4692f3467.jpg", "title": "Cozy Reading Nook", "url": "https://www.pinterest.com/pin/225039312627881892/", "id": "225039312627881892", "description": "Neva Round Daybed in Recycled Faux Fur color: Pampas Grass Featured on Instagram @ladyofbookshire", "boardName": "Reading Room Inspo", "boardUrl": "https://www.pinterest.com/erinturnage/reading-room-inspo/", "pinnerUsername": "erinturnage", "pinnerFullName": "Erin Turnage", "pinnerProfileUrl": "https://www.pinterest.com/erinturnage/", "pinnerFollowerCount": 89, "pinnerId": "225039450038600465", "pinnerImageUrl": "https://i.pinimg.com/140x140_RS/46/96/32/469632a67f252a78aec46ea006a4b971.jpg", "pinnerIsVerified": null, "boardPinCount": 4, "boardUrlSlug": "reading-room-inspo", "destinationUrl": "https://sixpenny.com/products/neva-round-daybed-slipcover-only?currency=USD&variant=40241699946540%20[trimmed]", "domain": "sixpenny.com", "dominantColor": "#6c5942", "imageWidth": 635, "imageHeight": 1200, "images": { "170x": "https://i.pinimg.com/236x/2c/24/91/2c24917f5d44c73a48b10de4692f3467.jpg", "236x": "https://i.pinimg.com/236x/2c/24/91/2c24917f5d44c73a48b10de4692f3467.jpg", "474x": "https://i.pinimg.com/474x/2c/24/91/2c24917f5d44c73a48b10de4692f3467.jpg", "736x": "https://i.pinimg.com/736x/2c/24/91/2c24917f5d44c73a48b10de4692f3467.jpg", "orig": "https://i.pinimg.com/originals/2c/24/91/2c24917f5d44c73a48b10de4692f3467.jpg" }, "isVideo": false, "videoUrl": null, "altText": "a living room filled with furniture and a large potted plant on top of a table", "hashtags": null, "isProduct": true, "price": null, "currency": null, "availability": null, "createdAt": "Sat, 05 Nov 2022 14:37:02 +0000", "observedAt": "2026-08-10T14:33:16.154Z", "error": null, "saveCount": 38174, "commentCount": 0, "shareCount": 666, "reactionCount": 1750 } ``` The most complete Pinterest scraper available. It returns every field a pin exposes, plus the pinner profile, board context, product and image details, and engagement counts (saves, comments, shares, reactions), and lets you scrape by keyword search, board, user profile or a single pin. **📥 [Input](https://apify.com/scrapers_lat/pinterest-scraper/input-schema) · 📤 [Output](https://apify.com/scrapers_lat/pinterest-scraper/output-schema) · 💰 [Pricing](https://apify.com/scrapers_lat/pinterest-scraper/pricing) · ▶️ [Examples](https://apify.com/scrapers_lat/pinterest-scraper/examples)** ![Apify](https://img.shields.io/badge/Platform-Apify-1CE1CE?logo=apify\&logoColor=white) ![Coverage](https://img.shields.io/badge/Coverage-Pinterest-blue) ![Output](https://img.shields.io/badge/Output-JSON%20%7C%20CSV%20%7C%20Excel-orange) ![Billing](https://img.shields.io/badge/Billing-Pay%20per%20result-brightgreen) ### Table of contents - [What it does](#what-it-does) - [Quickstart](#quickstart) - [Input reference](#input-reference) - [Output reference](#output-reference) - [Example output record](#example-output-record) - [Run via API and CLI](#run-via-api-and-cli) - [Fetch results](#fetch-results) - [Billing and limits](#billing-and-limits) - [FAQ and troubleshooting](#faq-and-troubleshooting) ### What it does The actor searches Pinterest by keyword and follows any board, user profile or pin URLs you pass, then writes one normalized record per pin to the run's dataset. Each pin includes its image URLs at every size, the pinner profile, board context, the linked product and destination when the pin is a product pin, and optional engagement counts (saves, comments, shares, reactions). Turn on `includeComments` to also collect a `comments` array of top comments per pin. Provide at least one input: a list of `searchTerms`, a list of `startUrls`, or both. Missing source values are returned as `null`, never invented. ### Quickstart Open the actor, paste this into the input, and press Run. It returns up to 10 pins for the keyword `home decor`, each enriched with engagement counts. ```json { "maxItems": 10, "withDetails": true, "includeComments": false, "searchTerms": ["home decor"] } ``` Add board, user or pin URLs to `startUrls` to scrape specific sources. Turn `withDetails` off for faster runs that return only the listing fields. ### Input reference | Field | Type | Required | Default | Description | |---|---|---|---|---| | `searchTerms` | string\[] | no | `["home decor"]` | Keywords to search Pinterest for, for example `home decor`. One search per keyword. | | `startUrls` | array | no | (none) | Pinterest URLs to scrape. Supports board URLs (`pinterest.com/user/board/`), user profile URLs (`pinterest.com/user/`) and pin URLs (`pinterest.com/pin/12345/`). | | `maxItems` | integer | no | `10` | Maximum number of pins to collect across all inputs. | | `withDetails` | boolean | no | `true` | Enrich each pin with save, comment, share and reaction counts. Turn off for faster keyword, board or user runs. | | `includeComments` | boolean | no | `false` | Also include a `comments` array (top comments with text, author, likes, timestamp) when Pinterest exposes them. Requires `withDetails` on. | Provide at least one of `searchTerms` or `startUrls`. ### Output reference One dataset item per pin. Types: `string`, `integer`, `boolean`, `object`, `object[]`, or `null` when the source value is absent. | Field | Type | Description | |---|---|---| | `id` | string | Pinterest pin id (unique). | | `title` | string | Pin title. | | `url` | string | Pin URL on Pinterest. | | `description` | string | Pin description text. | | `imageUrl` | string | Original-size image URL. | | `images` | object | Image URLs keyed by size (`170x`, `236x`, `474x`, `736x`, `orig`). | | `imageWidth` | integer | Original image width in pixels. | | `imageHeight` | integer | Original image height in pixels. | | `dominantColor` | string | Dominant color hex code. | | `altText` | string | Accessibility alt text for the image, or `null`. | | `boardName` | string | Board the pin belongs to. | | `boardUrl` | string | Board URL. | | `boardUrlSlug` | string | Board slug. | | `boardPinCount` | integer | Number of pins on the board. | | `pinnerUsername` | string | Pinner username. | | `pinnerFullName` | string | Pinner display name. | | `pinnerProfileUrl` | string | Pinner profile URL. | | `pinnerFollowerCount` | integer | Pinner follower count. | | `pinnerId` | string | Pinner id. | | `pinnerImageUrl` | string | Pinner avatar URL. | | `pinnerIsVerified` | boolean | Whether the pinner is verified, or `null`. | | `destinationUrl` | string | Outbound link the pin points to, or `null`. | | `domain` | string | Domain of the destination link, or `null`. | | `isProduct` | boolean | `true` when the pin is a product pin. | | `price` | number | Product price when published, else `null`. | | `currency` | string | Product currency, or `null`. | | `availability` | string | Product availability, or `null`. | | `isVideo` | boolean | `true` when the pin is a video. | | `videoUrl` | string | Video URL when the pin is a video, else `null`. | | `hashtags` | string\[] | Hashtags on the pin, or `null`. | | `createdAt` | string | Pin creation date. | | `saveCount` | integer | Number of saves. Present when `withDetails` is on. | | `commentCount` | integer | Number of comments. Present when `withDetails` is on. | | `shareCount` | integer | Number of shares. Present when `withDetails` is on. | | `reactionCount` | integer | Number of reactions. Present when `withDetails` is on. | | `comments` | object\[] | Top comments (text, author, likes, timestamp). Present only when `includeComments` is on. | | `observedAt` | string | ISO 8601 timestamp of when the record was collected. | | `error` | string | `null` on success. On a failed input, an item with a populated `error` field is written instead. | ### Example output record Real record from a live run (input `{"searchTerms": ["home decor"], "maxItems": 10, "withDetails": true}`): ```json { "id": "225039312627881892", "title": "Cozy Reading Nook", "url": "https://www.pinterest.com/pin/225039312627881892/", "description": "Neva Round Daybed in Recycled Faux Fur color: Pampas Grass Featured on Instagram @ladyofbookshire", "boardName": "Reading Room Inspo", "pinnerUsername": "erinturnage", "pinnerFullName": "Erin Turnage", "pinnerFollowerCount": 89, "domain": "sixpenny.com", "dominantColor": "#6c5942", "imageWidth": 635, "imageHeight": 1200, "isProduct": true, "isVideo": false, "createdAt": "Sat, 05 Nov 2022 14:37:02 +0000", "saveCount": 38174, "commentCount": 0, "shareCount": 666, "reactionCount": 1750, "observedAt": "2026-08-10T14:33:16.154Z", "error": null } ``` ### Run via API and CLI Start a run and wait for it to finish, then read the dataset. Replace `` with your Apify API token. Run synchronously and get dataset items in one call: ```bash curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~pinterest-scraper/run-sync-get-dataset-items?token=%3CTOKEN%3E" \ -H "Content-Type: application/json" \ -d '{"searchTerms":["home decor"],"maxItems":25,"withDetails":true}' ``` Start a run asynchronously: ```bash curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~pinterest-scraper/runs?token=%3CTOKEN%3E" \ -H "Content-Type: application/json" \ -d '{"startUrls":[{"url":"https://www.pinterest.com/pin/225039312627881892/"}],"maxItems":50}' ``` Apify CLI: ```bash apify call scrapers_lat/pinterest-scraper \ --input '{"searchTerms":["minimalist kitchen"],"includeComments":true}' ``` ### Fetch results Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing `format`: ```bash ## JSON curl "https://api.apify.com/v2/datasets/%3CDATASET_ID%3E/items?token=%3CTOKEN%3E&clean=true&format=json" ## CSV curl "https://api.apify.com/v2/datasets/%3CDATASET_ID%3E/items?token=%3CTOKEN%3E&clean=true&format=csv" ## Paginate large datasets curl "https://api.apify.com/v2/datasets/%3CDATASET_ID%3E/items?token=%3CTOKEN%3E&offset=1000&limit=1000" ``` `` is returned as `defaultDatasetId` in the run object. Use `offset` and `limit` to page through large result sets. `clean=true` drops empty and internal fields. ### Billing and limits - **Pay per result.** You are charged per pin returned (`result` event). See the [pricing tab](https://apify.com/scrapers_lat/pinterest-scraper/pricing) for the current per-result price. - **No charge on failure.** If an input errors, the actor writes an item with a populated `error` field and does not charge for it. Empty runs cost nothing. - **Spend cap respected.** Set `maxTotalChargeUsd` on the run; once reached, the actor stops emitting and charging further billable results. - **Free Apify plans** are capped at 10 pins per run. Upgrade for higher `maxItems`. ### FAQ and troubleshooting **A run returned 0 records. Why?** The keyword matched nothing, or a URL pointed to an empty or private board or profile. Try a broader keyword or a public URL. Zero-result runs are not charged. **Can I scrape a specific board or user?** Yes. Paste the board URL (`pinterest.com/user/board/`) or profile URL (`pinterest.com/user/`) into `startUrls`. You can mix keyword searches and URLs in one run. **Why are `saveCount` and the other counts missing?** You ran with `withDetails` off. Turn it on to enrich each pin with save, comment, share and reaction counts. **How do I get comments?** Turn on `includeComments` (and keep `withDetails` on). Each pin then includes a `comments` array when Pinterest exposes them. **Why is `price` null on a product pin?** Pinterest did not publish a price for that pin. Missing source values are returned as `null`, never invented. **Is this an official Pinterest tool?** No. This actor is independent and has no affiliation with Pinterest. It reads only data that is publicly available on Pinterest. ### Related scrapers - [Instagram Scraper](https://apify.com/scrapers_lat/instagram-scraper): Instagram profiles and posts. - [Instagram Reels Scraper](https://apify.com/scrapers_lat/instagram-reels-scraper): Instagram reels with engagement. - [Behance Scraper](https://apify.com/scrapers_lat/behance-scraper): Behance creative projects. - [Dribbble Scraper](https://apify.com/scrapers_lat/dribbble-scraper): Dribbble design shots. - [DeviantArt Scraper](https://apify.com/scrapers_lat/deviantart-scraper): DeviantArt deviations. - [Douyin Scraper](https://apify.com/scrapers_lat/douyin-scraper): Douyin short videos. ### More scrapers at scrapers.lat Built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at [scrapers.lat](https://scrapers.lat). *** > Independent tool, not affiliated with Pinterest. Accesses only publicly available data. # Actor input Schema ## `maxItems` (type: `integer`): Maximum number of pins to collect across all inputs. Optional. ## `withDetails` (type: `boolean`): When on, each pin is enriched with its save count, comment count, share count and reaction count. Turn off for faster keyword/board/user runs that only need the listing fields. ## `includeComments` (type: `boolean`): When on, each detailed pin also includes a `comments` array (top comments with text, author, likes, timestamp) when Pinterest exposes them. Requires 'Fetch pin details' to be on. ## `searchTerms` (type: `array`): Keywords to search Pinterest for, e.g. "home decor". One search per keyword. ## `startUrls` (type: `array`): Pinterest URLs to scrape. Supports board URLs (pinterest.com/user/board/), user profile URLs (pinterest.com/user/), and pin URLs (pinterest.com/pin/12345/). ## Actor input object example ```json { "maxItems": 10, "withDetails": true, "includeComments": false, "searchTerms": [ "home decor" ] } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "maxItems": 10, "searchTerms": [ "home decor" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapers_lat/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 = { "maxItems": 10, "searchTerms": ["home decor"], } # Run the Actor and wait for it to finish run = client.actor("scrapers_lat/pinterest-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "maxItems": 10, "searchTerms": [ "home decor" ] }' | apify call scrapers_lat/pinterest-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapers_lat/pinterest-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/i86oIN3vBeUtR5Gtu/builds/V073jdec3XTiJccO9/openapi.json