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.
Prompts to try with Pinterest Pin search in dots
Copy an example into dots, or ask in your own words.
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
- Send dots this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- 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
- Create an API key
In the console, open API keys and create a key for your dot. Copy it.
- Send your dot this message
Your dot reads Spiral's skill and asks for your API key.
set up https://spiral.ai/SKILL.md
- 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
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Pinterest Pin search
One request; the result comes back by polling or a webhook.
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.
Pinterest Pin search providers and prices
Spiral runs Pinterest Pin search through ScrapeCreators. Open a card for today's price, with every fee included.
Settings you can ask for
Ask dots for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Trim | on or off | Set to true for a trimmed down version of the response |
Every API field of Pinterest · Search is on its tool page: open its card above.
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.
More on Pinterest Pin search and dots
Overview
Pinterest Pin search in other agents
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.
Start using Pinterest Pin search in dots
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into dots:
set up https://spiral.ai/SKILL.md


