# Pinterest Search Scraper (`parsebird/pinterest-search-scraper`) Actor Scrape Pinterest search results by keyword. Extract pin IDs, titles, pinner profiles, follower counts, creation dates, content type, and HD image URLs. Use scheduling, API access, integrations, and JSON, CSV, Excel exports. - **URL**: https://apify.com/parsebird/pinterest-search-scraper.md - **Developed by:** [ParseBird](https://apify.com/parsebird) (community) - **Categories:** Social media, Automation, Integrations - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.50 / 1,000 pinterest search 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 Search Scraper Pinterest Search Scraper extracts structured pin data from [Pinterest](https://www.pinterest.com/) search results by keyword, including pin IDs, titles, pinner profiles, creation dates, content type, and image URLs.
Search Pinterest by query, filter for all pins or videos, and export clean search result data for trend research, content discovery, monitoring, or integrations.

ParseBird Pinterest Suite   •  Search, profile, keyword, and image data tools
 Pinterest Search Scraper
➤ You are here 		 Pinterest Profile Scraper
Profile metadata 		 Pinterest Keywords Discovery Tool
Keyword discovery 		 Pinterest Image Downloader
Image URLs
##### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ```text Use Apify Actor parsebird/pinterest-search-scraper to scrape Pinterest search results. Example with ApifyClient: client.actor("parsebird/pinterest-search-scraper").call(run_input={"query":"wallpaper","filter":"all","limit":20}). Inputs: query string required default "wallpaper"; filter string enum "all" or "videos" default "all"; limit integer 20-10000 default 20. Output fields: id, title, pinner{id, username, fullName, avatarURL, followers}, date{formatted, initial}, type, imageURL, searchQuery, searchFilter, scrapedAt. API docs: https://docs.apify.com/api/client/python/ and https://docs.apify.com/api/client/js/. Token: https://console.apify.com/account/integrations. ```` ### What is Pinterest Search Scraper? **Pinterest Search Scraper** is a Pinterest scraper and Pinterest API alternative for collecting search result data without manually copying pins from the website. Enter a query such as `wallpaper`, choose all pins or videos, and the actor returns a structured dataset ready for analysis. Use it for Pinterest data extraction workflows where you need repeatable exports, API access, scheduling, or integrations through [Apify](https://apify.com/). ### What can Pinterest Search Scraper do? - Scrape Pinterest search results by keyword. - Filter for all search results or video results where Pinterest returns that scope. - Extract pinner profile details, follower counts, dates, content type, and image URLs. - Run on demand or on a schedule with [Apify schedules](https://docs.apify.com/platform/schedules). - Access results through the Apify API, webhooks, and integrations. - Download datasets as JSON, CSV, Excel, XML, RSS, or HTML from Apify storage. ### What data can you extract from Pinterest search? | Field | Description | |-------|-------------| | `id` | Unique identifier for the Pinterest pin | | `title` | Pin title or description text returned by Pinterest | | `pinner.id` | Unique identifier for the pinner | | `pinner.username` | Pinterest username | | `pinner.fullName` | Display name of the pinner | | `pinner.avatarURL` | URL of the pinner avatar image | | `pinner.followers` | Follower count returned for the pinner | | `date.formatted` | Pin creation date normalized to `YYYY-MM-DD` when available | | `date.initial` | Raw date string returned by Pinterest | | `type` | Content type returned by Pinterest, commonly `pin` | | `imageURL` | Best available image URL for the pin | ### How to scrape Pinterest search results 1. Open [Pinterest Search Scraper](https://apify.com/parsebird/pinterest-search-scraper) on Apify. 2. Enter a `query`, for example `wallpaper`. 3. Choose `filter`: `all` for general pins or `videos` for video search results. 4. Set `limit` between 20 and 10,000. 5. Run the actor and open the dataset. 6. Export the results as JSON, CSV, Excel, or connect them to your workflow through the [Apify API](https://docs.apify.com/api/v2). ### Input parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `query` | string | **Yes** | `wallpaper` | Pinterest search term to scrape | | `filter` | string | No | `all` | Search type: `all` or `videos` | | `limit` | integer | No | `20` | Maximum results to return, from 20 to 10,000 | | `proxyConfiguration` | object | No | Apify Proxy enabled | Proxy settings for cloud runs | ### Input / Output Example input: ```json { "query": "wallpaper", "filter": "all", "limit": 20 } ``` Example output: ```json [ { "id": "159314905561864531", "title": "530 Mobile wallpapers ideas in 2024 | mobile wallpaper, phone wallpaper, iphone wallpaper", "pinner": { "id": "159315042976717963", "username": "celee722", "fullName": "Hanahaki", "avatarURL": "https://i.pinimg.com/75x75_RS/81/ba/de/81badebd16fae4dab326118aaf65a96e.jpg", "followers": 2 }, "date": { "formatted": "2024-08-19", "initial": "Mon, 19 Aug 2024 04:13:09 +0000" }, "type": "pin", "imageURL": "https://i.pinimg.com/originals/1b/16/f2/1b16f2064966cabcbf58e62ecb157dbf.jpg" } ] ``` Download results in JSON, CSV, Excel, HTML, XML, or RSS from the Apify dataset. ### Python API example ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("parsebird/pinterest-search-scraper").call(run_input={ "query": "wallpaper", "filter": "all", "limit": 20, }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) ``` ### JavaScript API example ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' }); const run = await client.actor('parsebird/pinterest-search-scraper').call({ query: 'wallpaper', filter: 'all', limit: 20, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` See Apify's official [Python client](https://docs.apify.com/api/client/python/) and [JavaScript client](https://docs.apify.com/api/client/js/) documentation for more options. ### How much does it cost to scrape Pinterest? **What is the price per Pinterest search result?** | Event | Free, Bronze, Silver | Gold | |-------|----------------------|------| | `result-scraped` | $0.0029 per result (**$2.90 / 1,000**) | $0.0025 per result (**$2.50 / 1,000**) | Each `result-scraped` event means one Pinterest search result was extracted and pushed to the dataset. A run with 1,000 results costs $2.90 on Free, Bronze, and Silver plans, or $2.50 on Gold. Apify free trial credits may cover test runs where applicable. ### Use cases - Track Pinterest trends for keywords, aesthetics, products, or campaign themes. - Build content research datasets from Pinterest search results. - Monitor pinners and visual content around a market category. - Collect image URLs and metadata for editorial planning or competitive research. - Feed Pinterest search data into spreadsheets, BI tools, databases, or automation workflows. ### How it works 1. The actor validates the query, filter, and limit. 2. It requests Pinterest search data with browser-like headers and optional Apify Proxy support. 3. It paginates while Pinterest returns more results and the limit has not been reached. 4. It deduplicates pins by ID and normalizes pinner, date, type, and image fields. 5. It pushes each result to the default Apify dataset and charges one PPE event per saved result on the Apify platform. ### Is it legal to scrape Pinterest? **Is scraping Pinterest legal?** Scraping publicly available web data is generally allowed in many jurisdictions, but you should review Pinterest's terms, avoid collecting private or sensitive information, and make sure your use case complies with applicable laws. For more background, read Apify's guide: [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/). ### Other Pinterest scrapers / Related Actors | Actor | Status | Best for | |-------|--------|----------| | [Pinterest Search Scraper](https://apify.com/parsebird/pinterest-search-scraper) | Available | Keyword search results, pins, pinners, and image URLs | | [Pinterest Profile Scraper](https://apify.com/parsebird/pinterest-profile-scraper) | Available | Public profile metadata by username | | [Pinterest Keywords Discovery Tool](https://apify.com/parsebird/pinterest-keywords-discovery-tool) | Available | Pinterest keyword and autocomplete research | | [Pinterest Image Downloader](https://apify.com/parsebird/pinterest-image-downloader) | Available | Pinterest pin image URLs and media variants | More ParseBird actors: - [YouTube Search Scraper](https://apify.com/parsebird/youtube-search-scraper) - Extract structured YouTube search results. - [Unsplash Image Scraper](https://apify.com/parsebird/unsplash-image-scraper) - Collect image search data from Unsplash. - [Dribbble Designers Scraper](https://apify.com/parsebird/dribbble-designers-scraper) - Extract designer profile data. - [Product Hunt Scraper](https://apify.com/parsebird/product-hunt-scraper) - Scrape product launches and maker data. ### FAQ **Can I schedule recurring Pinterest searches?** Yes. Use Apify schedules to run the actor hourly, daily, weekly, or at a custom interval. **Can I use this as a Pinterest scraper API?** Yes. Start runs and fetch datasets through the Apify API, Python client, JavaScript client, webhooks, or integrations. **Why did a run return no results?** Pinterest may block direct anonymous requests from some networks. Keep Apify Proxy enabled, retry the run, or lower the limit while testing. **Does it support videos?** Yes. Set `filter` to `videos`. Availability depends on what Pinterest returns for the query. **Where can I report issues or request fields?** Open the Issues tab on the actor page and include your input example, run ID, and the fields you expected. # Actor input Schema ## `query` (type: `string`): Enter the Pinterest search term, for example wallpaper, interior design, recipes, or tattoo ideas. ## `filter` (type: `string`): Choose whether to return all pin results or video pin results when Pinterest supports the filter for the query. ## `limit` (type: `integer`): Maximum number of Pinterest search results to return. ## `proxyConfiguration` (type: `object`): Use Apify Proxy for cloud runs if Pinterest blocks direct anonymous requests. ## Actor input object example ```json { "query": "wallpaper", "filter": "all", "limit": 20, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `dataset` (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 = { "query": "wallpaper", "filter": "all", "limit": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("parsebird/pinterest-search-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 = { "query": "wallpaper", "filter": "all", "limit": 20, } # Run the Actor and wait for it to finish run = client.actor("parsebird/pinterest-search-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 '{ "query": "wallpaper", "filter": "all", "limit": 20 }' | apify call parsebird/pinterest-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parsebird/pinterest-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pinterest Search Scraper", "description": "Scrape Pinterest search results by keyword. Extract pin IDs, titles, pinner profiles, follower counts, creation dates, content type, and HD image URLs. Use scheduling, API access, integrations, and JSON, CSV, Excel exports.", "version": "1.0", "x-build-id": "YwSUR3s1jf1cSYKY8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parsebird~pinterest-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parsebird-pinterest-search-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/parsebird~pinterest-search-scraper/runs": { "post": { "operationId": "runs-sync-parsebird-pinterest-search-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/parsebird~pinterest-search-scraper/run-sync": { "post": { "operationId": "run-sync-parsebird-pinterest-search-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", "required": [ "query" ], "properties": { "query": { "title": "Query", "type": "string", "description": "Enter the Pinterest search term, for example wallpaper, interior design, recipes, or tattoo ideas.", "default": "wallpaper" }, "filter": { "title": "Search Type", "enum": [ "all", "videos" ], "type": "string", "description": "Choose whether to return all pin results or video pin results when Pinterest supports the filter for the query.", "default": "all" }, "limit": { "title": "Max Results", "minimum": 20, "maximum": 10000, "type": "integer", "description": "Maximum number of Pinterest search results to return.", "default": 20 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Use Apify Proxy for cloud runs if Pinterest blocks direct anonymous requests.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```