[Integrations](https://spiral.ai/integrations) › [dots](https://spiral.ai/integrations/dots) › [Pinterest Pin search](https://spiral.ai/integrations/dots/pinterest-pin-search)

# How to Use Pinterest Pin search in dots

Find Pinterest Pins by keyword, with descriptions, images, destination links, and board details. Use it to collect visual references or discover publishers behind recipe, product, and design ideas.

|  |  |
| --- | --- |
| Model | Pinterest Pin search |
| Available through | ScrapeCreators |
| Category | Social Media |
| Price | Up to $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Pinterest Pin search in dots

- Every Monday, use Pinterest Pin search for 'IKEA KALLAX home office' and report Pins absent from previous runs, including descriptions and destination links.
- Every Friday, use Pinterest Pin search for 'LEGO botanical display' and summarize newly encountered Pin descriptions with links to each example.
- Once a week, use Pinterest Pin search for 'Portland rain garden design' and report destination domains that were absent from earlier results.
- Every Tuesday, use Pinterest Pin search for 'King Arthur Baking sourdough' and add newly encountered recipe links to a running reading list, keeping a Pinterest link beside each.
- On the first day of each month, use Pinterest Pin search for 'Patagonia clothing repair' and compare the returned Pin IDs with the previous run. Summarize additions with their descriptions and links.

## How to set up Pinterest Pin search in dots

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send dots this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for your dot. Copy it.

2. **Send your dot this message**: Your dot reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give your dot the key**: When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Pinterest Pin search**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "scrapecreators",
    "model": "scrapecreators/pinterest-search",
    "input": {
      "query": "Italian Pot Roast"
    }
  }'
```

Then paste one of the prompts above: dots finds Pinterest Pin search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/dots

## Pinterest Pin search tools and prices

- [Pinterest · Search](https://spiral.ai/tools/scrapecreators/scrapecreators/pinterest-search) (ScrapeCreators): Up to $0.0013 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| trim |  | — | Set to true for a trimmed down version of the response |
| cursor |  | — | Cursor |

## What can you do with Pinterest Pin search in dots?

Produce a weekly digest of Pins newly encountered in searches for a brand, product, or design topic. A scheduled agent can compare returned Pin IDs and destination domains with earlier runs and link each addition.

### Prepare a visual research brief

Search for a specific design topic, then assemble Pin links, descriptions, and image references into a brief for a designer.

### Find recipe publishers

Search a dish or ingredient combination and group returned destination links by domain to build a publisher reading list.

### Review public brand references

Search a brand and product category, then separate results by destination domain to review how those products appear in Pinterest ideas.

### Plan seasonal editorial topics

Compare Pin titles and descriptions across specific seasonal searches, then propose article ideas with links to the examples behind each suggestion.

### Discover specialist publications

Search narrow topics such as Portland rain gardens or Japanese joinery and collect the linked websites for further editorial research.

### Monitor changes in returned results

Repeat a fixed set of searches and compare Pin IDs and destination domains with previous runs to report additions to the collected results.

### Build a searchable reference index

Organize returned Pin metadata by topic, board name, and destination domain so a team can revisit useful references without repeating its research.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All dots guides](https://spiral.ai/integrations/dots)

## Pinterest Pin search in other agents

- [Amp](https://spiral.ai/integrations/amp/pinterest-pin-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/pinterest-pin-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/pinterest-pin-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/pinterest-pin-search)
- [Cline](https://spiral.ai/integrations/cline/pinterest-pin-search)
- [Codex](https://spiral.ai/integrations/codex/pinterest-pin-search)
- [Cursor](https://spiral.ai/integrations/cursor/pinterest-pin-search)
- [Devin](https://spiral.ai/integrations/devin/pinterest-pin-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/pinterest-pin-search)
- [Gemini](https://spiral.ai/integrations/gemini/pinterest-pin-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/pinterest-pin-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/pinterest-pin-search)
- [goose](https://spiral.ai/integrations/goose/pinterest-pin-search)
- [Grok](https://spiral.ai/integrations/grok/pinterest-pin-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/pinterest-pin-search)
- [Hermes](https://spiral.ai/integrations/hermes/pinterest-pin-search)
- [Instinct](https://spiral.ai/integrations/instinct/pinterest-pin-search)
- [Manus](https://spiral.ai/integrations/manus/pinterest-pin-search)
- [Muse](https://spiral.ai/integrations/muse/pinterest-pin-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/pinterest-pin-search)
- [n8n](https://spiral.ai/integrations/n8n/pinterest-pin-search)
- [Notion](https://spiral.ai/integrations/notion/pinterest-pin-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/pinterest-pin-search)
- [opencode](https://spiral.ai/integrations/opencode/pinterest-pin-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/pinterest-pin-search)
- [Raycast](https://spiral.ai/integrations/raycast/pinterest-pin-search)
- [VS Code](https://spiral.ai/integrations/vscode/pinterest-pin-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/pinterest-pin-search)
- [Zapier](https://spiral.ai/integrations/zapier/pinterest-pin-search)

## More dots guides

- [Pinterest Pin details](https://spiral.ai/integrations/dots/pinterest-pin-details)
- [Pinterest account boards](https://spiral.ai/integrations/dots/pinterest-account-boards)
- [Pillar creator storefront](https://spiral.ai/integrations/dots/pillar-creator-storefront)
- [Pinterest board pins](https://spiral.ai/integrations/dots/pinterest-board-pins)
- [Oriane Search TikTok videos](https://spiral.ai/integrations/dots/oriane-search-tiktok-videos)
- [Pinterest creator profile](https://spiral.ai/integrations/dots/pinterest-creator-profile)

## Questions about Pinterest Pin search in dots

**Can dots use Pinterest Pin search?**

Yes. Add Spiral to dots as an MCP server, and dots can find and run Pinterest Pin search like any built-in tool.

**How much does Pinterest Pin search cost in dots?**

Up to $0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your dots plan is separate.

**Do I need a ScrapeCreators account to use Pinterest Pin search in dots?**

You need no ScrapeCreators account. dots uses one Spiral API key for every tool, and Spiral runs Pinterest Pin search on its own ScrapeCreators account.

**How long does it take to set up Pinterest Pin search in dots?**

About two minutes: create an API key, then send your dot this message, then give your dot the key.

**Does dots wait while Pinterest Pin search runs?**

Pinterest Pin search runs in the background. dots starts the run, checks on it and gives you the json when it's ready.

**Can Pinterest search find private boards or profiles?**

Private boards are visible only to their owner and invited collaborators. Private profiles also stay out of Pinterest search results and external search engines.

**How fresh are the search results?**

ScrapeCreators says it fetches the latest available Pinterest information when you make a request. That describes retrieval freshness, not when a returned Pin was originally created.

**Can I retrieve another page of Pins?**

Yes. The documented search response includes a continuation cursor, and the endpoint supports using that cursor to request another page.

**How can I make broad Pinterest searches more useful?**

Add descriptive words to the original topic. Pinterest's own search guides work this way, turning a broad search into another search with an additional suggested term.

**Does public visibility grant permission to collect or reuse Pinterest content?**

Public visibility does not establish permission: Pinterest restricts unauthorized automated access, including scraping without express prior permission. People who post content also retain their rights to it.

