# Pinterest Scraper Goat (`goat255/pinterest-scraper`) Actor Bulk Pinterest pin extraction by pin URL, keyword search, board or username, with no API key and no login. Get image and video URLs, title, description, outbound link, board, pinner and engagement stats. Ideal for trend research, competitor analysis and content ideation. One clean row per pin. - **URL**: https://apify.com/goat255/pinterest-scraper.md - **Developed by:** [Goutam Soni](https://apify.com/goat255) (community) - **Categories:** Social media, Lead generation, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 pins 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 Scraper Extract Pinterest pins in bulk by pin URL, keyword, board, or username. No Pinterest account, no API key, and no login required. The scraper returns a clean, consistent record for every pin: image and video URLs, title, description, outbound link, board, pinner, engagement stats, and creation date. ### What it does Give it any mix of four source types and it walks each one for you, paginating until it reaches your per-source cap: - **Pin detail** - hand it a pin URL or ID and get the full pin record. - **Keyword search** - search any term and collect matching pins. - **Board pins** - point it at a board URL and pull that board's pins. - **User pins** - give it a username and pull that profile's pins. ### Input | Field | Type | Description | |---|---|---| | `pinUrls` | array | Pin links or numeric IDs. `https://www.pinterest.com/pin/1234567890/` or `1234567890`. | | `searchQueries` | array | Keywords to search. Example: `home office setup`. | | `boardUrls` | array | Board links. Example: `https://www.pinterest.com/example_user/home-office-ideas/`. | | `usernames` | array | Profile handles. Example: `example_user`. | | `maxItemsPerSource` | integer | Cap on pins per source (per query, board, or username). Default 100. | | `concurrency` | integer | How many sources to scrape in parallel. Default 5. | | `proxyConfig` | object | Apify proxy. RESIDENTIAL is the default and recommended option. | Provide at least one of `pinUrls`, `searchQueries`, `boardUrls`, or `usernames`. #### Example input ```json { "searchQueries": ["home office setup", "minimalist kitchen"], "boardUrls": ["https://www.pinterest.com/example_user/home-office-ideas/"], "usernames": ["example_user"], "maxItemsPerSource": 100, "concurrency": 5, "proxyConfig": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` ### Output Each pin is one dataset record with this stable shape: ```json { "ok": true, "source": "search", "query": "home office setup", "id": "1234567890", "url": "https://www.pinterest.com/pin/1234567890/", "title": "Sleek desk setup for a modern home office", "description": "Compact, stylish workspace inspiration.", "imageUrl": "https://i.pinimg.com/originals/aa/bb/cc/example.png", "videoUrl": null, "dominantColor": "#80644e", "link": "https://example.com/article", "board": { "id": "987654321", "name": "Home office ideas" }, "pinner": { "username": "example_user", "fullName": "Jane Doe" }, "stats": { "saves": 42, "comments": 3, "reactions": 12 }, "createdAt": "2026-05-29T21:04:57.000Z" } ``` Every field is always present. Unknown values are `null`. ### Use cases - Build mood boards and design inspiration datasets from search terms. - Track a board or profile's pins over time. - Collect product pins and their outbound links for ecommerce research. - Analyze visual trends by dominant color, title, and engagement. ### Notes - Pins that cannot be reached are returned with `ok: false` and a short reason (`not_found`, `upstream_unavailable`, `upstream_rate_limit`, or `login_required`) so a partial run never silently drops a source. - RESIDENTIAL proxy is strongly recommended for reliable results at scale. ### Pricing This actor uses pay per event: - **pin** - charged per pin returned. No run start fee, you pay only for the pins you get. ### FAQ #### Do I need a Pinterest account or API key? No. This actor reads public Pinterest content without any login or API key. #### What can it scrape? Pins by URL, keyword search results, a board's pins, and a user's pins, with images, titles, links, and stats. #### How many pins can I get? You set the limit with maxItemsPerSource. The actor walks pagination until your maximum is reached. #### Can it scrape secret or private boards? No. Only public pins and boards are supported. #### Can I export the data? Yes. Results export to JSON, CSV, Excel, or your own integrations. **Found this useful?** [Leave a quick review](https://apify.com/goat255/pinterest-scraper/reviews). It takes a few seconds and it genuinely helps other people find the actor. # Actor input Schema ## `pinUrls` (type: `array`): Specific pin links or numeric IDs to fetch. Either form works: https://www.pinterest.com/pin/1234567890/ or 1234567890. ## `searchQueries` (type: `array`): Keywords to search pins for. Example: home office setup, minimalist kitchen. ## `boardUrls` (type: `array`): Board links to pull pins from. Example: https://www.pinterest.com/example\_user/home-office-ideas/. ## `usernames` (type: `array`): Profile handles to pull pins from. Example: example\_user. ## `maxItemsPerSource` (type: `integer`): Cap on pins returned per source (per query, board, or username). Pages are walked until this cap is reached or the source is exhausted. ## `concurrency` (type: `integer`): How many sources to scrape in parallel. Default 5. Higher = faster but more proxy load. ## `proxyConfig` (type: `object`): Apify proxy. RESIDENTIAL is the default and recommended option for the most reliable results. ## Actor input object example ```json { "pinUrls": [], "searchQueries": [ "home office setup" ], "boardUrls": [], "usernames": [], "maxItemsPerSource": 100, "concurrency": 5, "proxyConfig": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `pins` (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 = { "pinUrls": [], "searchQueries": [ "home office setup" ], "boardUrls": [], "usernames": [], "proxyConfig": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("goat255/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 = { "pinUrls": [], "searchQueries": ["home office setup"], "boardUrls": [], "usernames": [], "proxyConfig": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("goat255/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 '{ "pinUrls": [], "searchQueries": [ "home office setup" ], "boardUrls": [], "usernames": [], "proxyConfig": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call goat255/pinterest-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=goat255/pinterest-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pinterest Scraper Goat", "description": "Bulk Pinterest pin extraction by pin URL, keyword search, board or username, with no API key and no login. Get image and video URLs, title, description, outbound link, board, pinner and engagement stats. Ideal for trend research, competitor analysis and content ideation. One clean row per pin.", "version": "0.1", "x-build-id": "VMWQOW31j8cSVCFEB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/goat255~pinterest-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-goat255-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/goat255~pinterest-scraper/runs": { "post": { "operationId": "runs-sync-goat255-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/goat255~pinterest-scraper/run-sync": { "post": { "operationId": "run-sync-goat255-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": { "pinUrls": { "title": "Pin URLs or IDs (pin detail mode)", "type": "array", "description": "Specific pin links or numeric IDs to fetch. Either form works: https://www.pinterest.com/pin/1234567890/ or 1234567890.", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries (keyword mode)", "type": "array", "description": "Keywords to search pins for. Example: home office setup, minimalist kitchen.", "items": { "type": "string" } }, "boardUrls": { "title": "Board URLs (board pins mode)", "type": "array", "description": "Board links to pull pins from. Example: https://www.pinterest.com/example_user/home-office-ideas/.", "items": { "type": "string" } }, "usernames": { "title": "Usernames (user pins mode)", "type": "array", "description": "Profile handles to pull pins from. Example: example_user.", "items": { "type": "string" } }, "maxItemsPerSource": { "title": "Max items per source", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Cap on pins returned per source (per query, board, or username). Pages are walked until this cap is reached or the source is exhausted.", "default": 100 }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many sources to scrape in parallel. Default 5. Higher = faster but more proxy load.", "default": 5 }, "proxyConfig": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy. RESIDENTIAL is the default and recommended option for the most reliable results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```