# Pinterest Keywords Discovery Tool (`parsebird/pinterest-keywords-discovery-tool`) Actor Discover Pinterest keyword suggestions from autocomplete data. Enter a seed keyword and extract related search phrases for SEO, trend research, content planning, ads, and Pinterest scraper workflows. Export as JSON, CSV, Excel. - **URL**: https://apify.com/parsebird/pinterest-keywords-discovery-tool.md - **Developed by:** [ParseBird](https://apify.com/parsebird) (community) - **Categories:** Social media, SEO tools, Integrations - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $0.40 / 1,000 pinterest keyword suggestions 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 Keywords Discovery Tool Pinterest Keywords Discovery Tool extracts related keyword suggestions from [Pinterest](https://www.pinterest.com/) autocomplete for a seed keyword, helping you find Pinterest search phrases for SEO, trend research, content planning, ads, and scraper workflows.
Enter one Pinterest keyword and get structured autocomplete suggestions that reveal related searches, content angles, audience interests, and long-tail keyword ideas.

ParseBird Pinterest Suite   •  Search, profile, keyword, and image data tools
 Pinterest Search Scraper
Keyword search results 		 Pinterest Profile Scraper
Profile metadata 		 Pinterest Keywords Discovery Tool
➤ You are here 		 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-keywords-discovery-tool to discover Pinterest autocomplete keyword suggestions. Example with ApifyClient: client.actor("parsebird/pinterest-keywords-discovery-tool").call(run_input={"keyword":"space"}). Inputs: keyword string required default "fashion". Output fields: keyword, type, item. 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 Keywords Discovery Tool? **Pinterest Keywords Discovery Tool** is a Pinterest keyword scraper and Pinterest API alternative for collecting autocomplete suggestions from a seed keyword. Enter a topic such as `fashion` or `space`, and the actor returns related Pinterest search phrases in a clean dataset. Use it before running a Pinterest scraper, building a content calendar, researching Pinterest SEO, or mapping long-tail search ideas. ### What can Pinterest Keywords Discovery Tool do? - Discover Pinterest autocomplete suggestions for one seed keyword. - Extract related long-tail keyword phrases such as `fashion outfits` or `space wallpaper`. - Return a simple dataset with the seed keyword, suggestion type, and suggestion text. - Run on demand or on a schedule with [Apify schedules](https://docs.apify.com/platform/schedules). - Connect keyword datasets to the [Apify API](https://docs.apify.com/api/v2), webhooks, and integrations. - Export Pinterest keyword data as JSON, CSV, Excel, HTML, XML, or RSS from Apify datasets. ### What data can you extract from Pinterest keyword suggestions? | Field | Description | |-------|-------------| | `keyword` | Original seed keyword used for discovery | | `type` | Result type, currently `suggestion` | | `item` | Pinterest autocomplete keyword suggestion | ### How to discover Pinterest keywords 1. Open [Pinterest Keywords Discovery Tool](https://apify.com/parsebird/pinterest-keywords-discovery-tool) on Apify. 2. Enter a seed `keyword`, for example `space`. 3. Run the actor. 4. Open the default dataset to review Pinterest keyword suggestions. 5. Export the results as JSON, CSV, Excel, or connect them to another workflow through the [Apify API](https://docs.apify.com/api/v2). ### Input parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `keyword` | string | **Yes** | `fashion` | Seed keyword to search for on Pinterest | ### Input / Output Example input: ```json { "keyword": "space" } ``` Example output: ```json [ { "keyword": "fashion", "type": "suggestion", "item": "fashion outfits" }, { "keyword": "fashion", "type": "suggestion", "item": "fashion brand" } ] ``` 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-keywords-discovery-tool").call(run_input={ "keyword": "space", }) 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-keywords-discovery-tool').call({ keyword: 'space', }); 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 discover Pinterest keywords? **What is the price per Pinterest keyword suggestion?** | Event | Free, Bronze, Silver | Gold | |-------|----------------------|------| | `suggestion-discovered` | $0.0006 per suggestion (**$0.60 / 1,000**) | $0.0004 per suggestion (**$0.40 / 1,000**) | Each `suggestion-discovered` event means one Pinterest keyword suggestion was extracted and pushed to the dataset. A run with 1,000 suggestions costs $0.60 on Free, Bronze, and Silver plans, or $0.40 on Gold. Apify free trial credits may cover test runs where applicable. ### Use cases - Find Pinterest SEO keywords before publishing pins, boards, or blog content. - Build seed lists for Pinterest Search Scraper runs. - Research visual trends, seasonal ideas, and audience language. - Collect keyword ideas for ads, content briefs, or spreadsheet analysis. - Feed Pinterest keyword suggestions into BI tools, databases, or automation workflows. ### How it works 1. The actor validates the seed `keyword`. 2. It requests Pinterest autocomplete suggestions with browser-like headers. 3. It deduplicates returned suggestions. 4. It pushes one dataset item per keyword suggestion. 5. It charges one PPE event per saved suggestion on the Apify platform and stops if the spending limit is reached. ### Is it legal to scrape Pinterest keyword suggestions? **Is scraping Pinterest autocomplete data legal?** Scraping publicly available web data is generally allowed in many jurisdictions, but you should review Pinterest's terms 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. - [Product Hunt Scraper](https://apify.com/parsebird/product-hunt-scraper) - Scrape product launches and maker data. ### FAQ **Can I schedule recurring Pinterest keyword discovery?** Yes. Use Apify schedules to run the actor hourly, daily, weekly, or at a custom interval. **Can I use this as a Pinterest keyword API?** Yes. Start runs and fetch datasets through the Apify API, Python client, JavaScript client, webhooks, or integrations. **Why are there fewer suggestions than expected?** Pinterest controls how many autocomplete suggestions are returned for each seed keyword. Some topics return more suggestions than others. **Can I use these suggestions with Pinterest Search Scraper?** Yes. Use suggestions from this actor as `query` values in [Pinterest Search Scraper](https://apify.com/parsebird/pinterest-search-scraper). **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 ## `keyword` (type: `string`): Enter the seed keyword to search for on Pinterest, for example fashion, space, recipes, or home decor. ## Actor input object example ```json { "keyword": "fashion" } ``` # 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 = { "keyword": "fashion" }; // Run the Actor and wait for it to finish const run = await client.actor("parsebird/pinterest-keywords-discovery-tool").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 = { "keyword": "fashion" } # Run the Actor and wait for it to finish run = client.actor("parsebird/pinterest-keywords-discovery-tool").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 '{ "keyword": "fashion" }' | apify call parsebird/pinterest-keywords-discovery-tool --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parsebird/pinterest-keywords-discovery-tool", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pinterest Keywords Discovery Tool", "description": "Discover Pinterest keyword suggestions from autocomplete data. Enter a seed keyword and extract related search phrases for SEO, trend research, content planning, ads, and Pinterest scraper workflows. Export as JSON, CSV, Excel.", "version": "1.0", "x-build-id": "aOuzcHnJ4GOYtOJ8p" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parsebird~pinterest-keywords-discovery-tool/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parsebird-pinterest-keywords-discovery-tool", "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-keywords-discovery-tool/runs": { "post": { "operationId": "runs-sync-parsebird-pinterest-keywords-discovery-tool", "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-keywords-discovery-tool/run-sync": { "post": { "operationId": "run-sync-parsebird-pinterest-keywords-discovery-tool", "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": [ "keyword" ], "properties": { "keyword": { "title": "Search Keyword", "type": "string", "description": "Enter the seed keyword to search for on Pinterest, for example fashion, space, recipes, or home decor.", "default": "fashion" } } }, "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 } } } } } } } } } } ```