Spiral gives your agent every tool with one account. Browse the tools →

Codex · Social Media

How to Use Pinterest Pin search in Codex

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 Codex

Copy an example into Codex, or ask in your own words.

Use Pinterest Pin search for 'IKEA KALLAX record storage' and create a JSON reference file in this project containing Pin IDs, descriptions, Pin URLs, image URLs, and destination domains.

Pinterest Pin searchCodex
Try asking
  • Use Pinterest Pin search for 'Portland rain garden design' and create a Markdown research brief in this project, grouping the returned destination links by domain.

  • Use Pinterest Pin search for 'LEGO botanical display ideas' and build a local index of returned Pin titles, descriptions, board names, and links.

  • Use Pinterest Pin search for 'King Arthur Baking sourdough bread' and save a CSV of Pin URLs and destination links, removing duplicate destination URLs.

  • Use Pinterest Pin search for 'Patagonia jacket repair' and compare the returned Pin IDs with this project's saved results. Write a report linking to Pins absent from the saved collection.

How to set up Pinterest Pin search in Codex

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

Use Spiral's MCP server

  1. Add the hosted server
    codex mcp add spiral --url https://api.spiral.ai/mcp
  2. Sign in

    Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.

    codex mcp login spiral

Use the Spiral skill

  1. Send Codex 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 the Spiral CLI

  1. 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

  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.

    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: Codex 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.

ScrapeCreatorsSocial Media
Pinterest · Search
scrapecreators/pinterest-search

Settings you can ask for

Ask Codex for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Trimon 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 Codex?

Build a searchable reference index from Pinterest Pin descriptions, image links, boards, and destination domains. A coding agent can organize the returned metadata in project files and compare Pin IDs across saved searches.

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.

Questions about Pinterest Pin search in Codex

Can Codex use Pinterest Pin search?

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

How much does Pinterest Pin search cost in Codex?

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 Codex plan is separate.

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

No. Spiral runs Pinterest Pin search on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

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

About two minutes: add the hosted server, then sign in.

Does Codex wait while Pinterest Pin search runs?

Pinterest Pin search runs in the background. Codex 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.

Get started

Start using Pinterest Pin search in Codex

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Codex:

Set up Codex

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options