# Pinterest Data Scraper (Cheap) (`data_api/pinterest-data-scraper-cheap`) Actor Pinterest Data Extractor scrapes pin images, descriptions, and IDs from any board or profile, so content teams can collect Pinterest data without copying it by hand. - **URL**: https://apify.com/data\_api/pinterest-data-scraper-cheap.md - **Developed by:** [Data API](https://apify.com/data_api) (community) - **Categories:** Social media, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 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/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 Data Scraper ![Pinterest Data Scraper](cover.jpg) Scrolling Pinterest by hand to gather pins is slow, and the data you actually want — image links, captions, who posted it, which board it sits on, how many people saved it — is buried in the page. This scraper pulls it straight from the source. Type a keyword (or a list of them), and it reads Pinterest's own search responses and hands back every pin as a clean row: full image links in five sizes, the caption, the creator and their follower count, the board, save and like counts, plus video links when a pin has one. Run one term to test, or queue a dozen and let it collect thousands of pins in a single pass. ### What you get Every pin comes back as one row with a steady set of columns, so results drop neatly into a sheet or database. The fields split into a few groups: - **Pin** — `pinIdentifier`, `pinLink`, `pinHeadline`, `pinCaption`, `publishedDate`, `mainColor`, `destinationUrl` - **Media** — `imageLink`, `imageVariants` (170x through original), `hasVideo`, `videoLink` - **Creator** — `creatorId`, `creatorHandle`, `creatorName`, `creatorFollowers`, `creatorProfileUrl` - **Board** — `boardIdentifier`, `boardTitle`, `boardLink` - **Engagement and context** — `savesTotal`, `likesTotal`, `commentsTotal`, `sponsored`, `matchedTerm`, `collectedAt` ### Quick start 1. Click **Try for free** and open the input form. 2. Type a keyword into **Single search term**, or paste a batch into **List of search terms** (one per line). 3. Set **Maximum pins** to cap the run, and add a residential proxy under the Proxy section. 4. Press **Start**, then export the pins as JSON, CSV, Excel, or XML once it finishes. ![How it works](how-it-works.jpg) ### Use cases - **Content research** — gather trending pins for any keyword without scrolling for hours - **SEO and link tracking** — see which pins point back to your domain or a competitor's via `destinationUrl` - **Competitor analysis** — find which boards and creators own a keyword - **Image dataset building** — collect image links in every size from 170x up to the original - **Creator and influencer research** — pull handles, display names, and follower counts in bulk - **Trend tracking** — re-run the same keyword on a schedule and watch save counts move ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `searchTerm` | string | One of `searchTerm` or `searchTerms` | Single keyword to look up, for example `minimalist kitchen`. The actor builds the search URL for you. | | `searchTerms` | array of strings | One of `searchTerm` or `searchTerms` | Several keywords, one per line. Pins from every keyword land in the same dataset. | | `pinLimit` | integer | No | Ceiling on pins gathered across all keywords. Default `50`, max `1000`. | | `customProxyUrl` | string | No | Your own residential proxy URL such as `http://user:pass@host:port`. When set, it takes priority over the Apify proxy settings. | | `proxyConfiguration` | object | No | Apify proxy settings, used only when `customProxyUrl` is blank. Defaults to Residential, which Pinterest requires. | #### Example input ```json { "searchTerms": ["minimalist kitchen", "garden lighting", "street fashion"], "pinLimit": 300, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` ### Output Each pin becomes one record. Every field below is present on every row, so your dataset stays rectangular and predictable. #### Example output ```json { "pinIdentifier": "292452569572809169", "pinLink": "https://www.pinterest.com/pin/292452569572809169/", "pinHeadline": "", "pinCaption": "Bright minimalist kitchen with warm oak shelving", "publishedDate": "Mon, 03 Nov 2025 07:46:12 +0000", "imageLink": "https://i.pinimg.com/originals/0b/d6/e9/0bd6e9...jpg", "imageVariants": { "170x": "https://i.pinimg.com/170x/0b/d6/e9/0bd6e9...jpg", "236x": "https://i.pinimg.com/236x/0b/d6/e9/0bd6e9...jpg", "474x": "https://i.pinimg.com/474x/0b/d6/e9/0bd6e9...jpg", "736x": "https://i.pinimg.com/736x/0b/d6/e9/0bd6e9...jpg", "orig": "https://i.pinimg.com/originals/0b/d6/e9/0bd6e9...jpg" }, "mainColor": "#6c5d56", "destinationUrl": "https://www.instagram.com/reel/DMPX6u3pAN0/", "hasVideo": true, "videoLink": "https://v1.pinimg.com/videos/iht/hls/8f/03/99/8f0399...m3u8", "creatorId": "292452706960849245", "creatorHandle": "studioloomdesign", "creatorName": "Studio Loom", "creatorFollowers": 11, "creatorProfileUrl": "https://www.pinterest.com/studioloomdesign/", "boardIdentifier": "292452638242391545", "boardTitle": "Kitchen Ideas 2025", "boardLink": "https://www.pinterest.com/studioloomdesign/kitchen-ideas-2025/", "savesTotal": 316, "likesTotal": 42, "commentsTotal": 0, "sponsored": false, "matchedTerm": "minimalist kitchen", "collectedAt": "2026-06-29T10:23:45.000000+00:00" } ``` #### Output fields | Field | Type | Description | |-------|------|-------------| | `pinIdentifier` | string | Numeric Pinterest ID for the pin | | `pinLink` | string | Address of the pin's page | | `pinHeadline` | string | Pin headline, often blank | | `pinCaption` | string | Caption or body text under the pin | | `publishedDate` | string | Date the pin went live (RFC 2822) | | `imageLink` | string | Sharpest image available, original or 736x | | `imageVariants` | object | All image sizes: 170x, 236x, 474x, 736x, orig | | `mainColor` | string | Leading hex color of the image | | `destinationUrl` | string | Outbound web address the pin links to | | `hasVideo` | boolean | True when the pin carries a video | | `videoLink` | string | HLS or MP4 stream address, video pins only | | `creatorId` | string | Pinterest account ID of the creator | | `creatorHandle` | string | Pinterest username of the creator | | `creatorName` | string | Display name of the creator | | `creatorFollowers` | integer | Follower count of the creator | | `creatorProfileUrl` | string | Link to the creator's profile | | `boardIdentifier` | string | ID of the board the pin sits on | | `boardTitle` | string | Name of the board | | `boardLink` | string | Address of the board | | `savesTotal` | integer | Times the pin has been saved or repinned | | `likesTotal` | integer | Likes on the pin | | `commentsTotal` | integer | Comments on the pin | | `sponsored` | boolean | True when the pin is a promoted placement | | `matchedTerm` | string | Search keyword that surfaced the pin | | `collectedAt` | string | ISO 8601 timestamp of when the row was captured | ### Tips for best results - **Keep the proxy on Residential.** Pinterest blocks datacenter IPs at the network level, so the connection never lands. Either paste a residential proxy into `customProxyUrl` or leave `proxyConfiguration` on its Residential default. - **Start with one keyword.** Run a single term and a low `pinLimit` first to confirm the proxy works before you queue a big batch. - **Use `pinLimit` to control spend.** It caps the total pins across every keyword, so set it low for tests and raise it for full runs. - **Seeing zero pins?** That almost always means the proxy slipped to Datacenter. Switch it back to Residential and rerun. - **Video pins fill in `videoLink`.** Image pins leave it blank, so filter on `hasVideo` when you only want one kind. ### How can I use Pinterest pin data? **How can I use the Pinterest Data Scraper to research trending content for a niche?** Queue a handful of keywords in `searchTerms` and the scraper returns every matching pin with its caption, image link, board, and save count. Sort by `savesTotal` to see what is resonating, and check `matchedTerm` to compare how each keyword performs — a quick read on what your audience is pinning right now. **How can I scrape Pinterest pins to build an image dataset?** Each pin ships with `imageLink` for the best-quality file plus `imageVariants` holding every size from 170x to the original. Set `pinLimit` to the volume you need, run your keywords, and export the links to JSON or CSV to feed a download script or a training pipeline. **How can I track Pinterest creators and the boards behind a keyword?** The output pairs each pin with `creatorHandle`, `creatorName`, `creatorFollowers`, and `creatorProfileUrl`, alongside `boardTitle` and `boardLink`. Group the rows by creator or board to see who dominates a topic, then follow the profile links to dig deeper — useful for influencer outreach or competitor mapping. **How can I monitor Pinterest engagement over time?** Run the same keyword on Apify's scheduler and the scraper stamps every row with `collectedAt` along with `savesTotal`, `likesTotal`, and `commentsTotal`. Compare runs to watch how a pin's saves climb, which is handy for measuring a campaign or spotting content that is starting to take off. ### 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 ## `searchTerm` (type: `string`): One keyword to look up on Pinterest, for example 'minimalist kitchen' or 'street fashion'. The actor turns it into a search URL for you. ## `searchTerms` (type: `array`): Queue up several keywords at once. Add one keyword per line and the pins from every keyword land in the same dataset. ## `pinLimit` (type: `integer`): Upper bound on pins gathered across every keyword in the run. Defaults to 50 and tops out at 1000. ## `customProxyUrl` (type: `string`): Paste a residential proxy URL such as http://user:pass@host:port. When filled in, it wins over the Apify proxy settings below. Works with Webshare, BrightData, and similar services. ## `proxyConfiguration` (type: `object`): Only kicks in when the proxy URL above is left blank. Falls back to Apify Residential proxies by default. ## Actor input object example ```json { "searchTerm": "minimalist kitchen", "searchTerms": [ "minimalist kitchen" ], "pinLimit": 50, "customProxyUrl": "http://username:password@p.webshare.io:80", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "searchTerm": "minimalist kitchen", "searchTerms": [ "minimalist kitchen", "garden lighting" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("data_api/pinterest-data-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 = { "searchTerm": "minimalist kitchen", "searchTerms": [ "minimalist kitchen", "garden lighting", ], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("data_api/pinterest-data-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 '{ "searchTerm": "minimalist kitchen", "searchTerms": [ "minimalist kitchen", "garden lighting" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call data_api/pinterest-data-scraper-cheap --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=data_api/pinterest-data-scraper-cheap", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pinterest Data Scraper (Cheap)", "description": "Pinterest Data Extractor scrapes pin images, descriptions, and IDs from any board or profile, so content teams can collect Pinterest data without copying it by hand.", "version": "0.0", "x-build-id": "QfN4wsbIEMncJGtgs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_api~pinterest-data-scraper-cheap/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_api-pinterest-data-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-data-scraper-cheap/runs": { "post": { "operationId": "runs-sync-data_api-pinterest-data-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-data-scraper-cheap/run-sync": { "post": { "operationId": "run-sync-data_api-pinterest-data-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": { "searchTerm": { "title": "Single search term", "type": "string", "description": "One keyword to look up on Pinterest, for example 'minimalist kitchen' or 'street fashion'. The actor turns it into a search URL for you." }, "searchTerms": { "title": "List of search terms", "type": "array", "description": "Queue up several keywords at once. Add one keyword per line and the pins from every keyword land in the same dataset.", "items": { "type": "string" } }, "pinLimit": { "title": "Maximum pins", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Upper bound on pins gathered across every keyword in the run. Defaults to 50 and tops out at 1000.", "default": 50 }, "customProxyUrl": { "title": "Your own proxy URL", "type": "string", "description": "Paste a residential proxy URL such as http://user:pass@host:port. When filled in, it wins over the Apify proxy settings below. Works with Webshare, BrightData, and similar services." }, "proxyConfiguration": { "title": "Apify proxy settings", "type": "object", "description": "Only kicks in when the proxy URL above is left blank. Falls back to Apify Residential proxies by default." } } }, "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 } } } } } } } } } } ```