Pinterest Search Scraper

Search Pinterest by keyword and export public pin URLs, images, titles, search positions and available creator or board metadata. Use the dataset for visual research and content planning. Signed-out coverage can be sparse, and a requested limit is not a guaranteed result count.

Quick start

1. Enter one or more keywords in Pinterest search keywords.
2. Start with a small limit and leave detail enrichment off.
3. Run the Actor, then open the default dataset to export JSON, CSV or Excel.

{
  "queries": ["home decor"],
  "maxResultsPerQuery": 5,
  "includePinDetails": false
}

No Pinterest login or cookies are required. Private boards, saved pins, messages and account analytics are not supported.

Prefer a video guide? This short Apify walkthrough shows you how to set up and run an Actor. It uses a different Actor, but the setup steps are the same.

Ready-to-run examples

Choose a public example to see its settings before starting a run:

• Scrape Pinterest DIY Craft Ideas

What you get

Each dataset row contains one verified public pin associated with a search keyword. Keep pinId, pinUrl, query and available image references for a visual shortlist. Creator, board, external-link and count fields can be unavailable. Source-dependent positions can contain gaps and do not measure popularity or search volume.

Who is it for?

• Creative research: collect image URLs, titles and source domains for a visual theme.
• Content planning: compare visible pins across related keywords without treating results as measured search volume or trend scores.
• Product inspiration: review public decor, fashion, craft or recipe imagery and available source links.
• Automation: pass structured rows to spreadsheets, dashboards or AI workflows through the Dataset API.

Practical workflows

Build a small visual shortlist

Example request: “Search home decor on Pinterest with maxResultsPerQuery set to 5 and includePinDetails false. Return the saved pin URLs and report incomplete queries.” Use actual input keys, then retrieve dataset rows and summary rather than assuming the requested count was fulfilled.

Retain pinId, pinUrl, query, available imageUrl and fetchedAt when moving the shortlist into your own content-planning tool. Review the linked pins and source domains rather than treating the sample as a popularity ranking. Image references remain links, not downloaded image files.

Input settings

Supply at least one nonblank keyword in queries or searchQueries. The two lists are combined, trimmed and deduplicated, with up to 100 unique keywords and 256 characters per keyword. Neither list is globally required because either can supply the search terms.

Setting and JSON key	Behavior	Default
Pinterest search keywords — queries	One or more keyword phrases, not Pinterest URLs	No API default
Search keywords alias — searchQueries	Combined with queries	Omitted
Maximum pins per keyword — maxResultsPerQuery	Upper limit, from 1 to 500. Actual coverage may be much smaller	20. Form prefill 10
Maximum pins alias — maxResults	Explicit override for maxResultsPerQuery	Omitted
Try to enrich pin details — includePinDetails	Attempt extra metadata from public pin pages. May retain the same fields when unavailable	false
Locale — locale	Session language preference	en-US
Country note — country	Used only for a selected Apify Proxy configuration without its own country. Not a search filter or output field	US
Concurrent searches — maxConcurrency	Simultaneous searches, from 1 to 5	2
Concurrent detail pages — detailConcurrency	Simultaneous optional detail pages, from 1 to 8	3
Per-attempt timeout — requestTimeoutSecs	Search-attempt budget, from 15 to 120 seconds	120
Retries per keyword — maxRequestRetries	Failed-attempt retries, from 0 to 5. Completed empty results do not trigger retries	2
Run work budget — runBudgetSeconds	Stop admitting work early enough to save output and diagnostics, from 120 to 540 seconds	540
Proxy configuration — proxyConfiguration	Optional managed or custom proxy settings. Details and limitations are in field help	Apify Proxy disabled

Omitting requestTimeoutSecs uses 120 seconds. Explicit values are preserved: saved tasks or API inputs with 45 still use 45 seconds and must be changed to 120 for the longer search budget. Shorter budgets can return fewer verified results; the longer default does not guarantee every search will fill its requested volume.

Keep detail enrichment off for a small first run. It cannot guarantee creator, board, count or video fields, and it does not unlock private or login-only data. The Actor has no video-only filter, popularity sort, image download, or built-in trend measurement.

Example inputs

Use the Quick start input as a small first run. Adjust the fields described above for your own data.

Output data

Each row represents a verified public pin associated with a keyword. Optional fields can be null. Results are not globally sorted across keywords. Compare query and position within each search. Recovered search positions can contain gaps where unverifiable cards were skipped.

The following is a synthetic shape-only illustration, not an observed pin or a claim that these URLs resolve:

{
  "query": "home decor",
  "position": 1,
  "pinId": "123456789",
  "pinUrl": "https://www.pinterest.com/pin/123456789/",
  "title": "Illustrative decor pin",
  "description": null,
  "imageUrl": "https://images.example.org/pin.jpg",
  "thumbnailUrl": "https://images.example.org/thumbnail.jpg",
  "creatorName": null,
  "boardName": null,
  "outboundUrl": null,
  "fetchedAt": "2026-10-25T00:00:00.000Z"
}

Fields	Meaning
query, position	Search phrase and position within that search
pinId, pinUrl	Numeric pin identity and public pin URL
title, description	Available text or image alt text
imageUrl, thumbnailUrl, dominantColor	Image references and available color. Image files are not downloaded into the dataset
creatorName, creatorUsername, creatorUrl	Available public creator information
boardName, boardUrl	Available board information
domain, outboundUrl	Available external source domain and link
repinCount, saveCount	Optional public counts. Not estimated when missing
isVideo, videoUrl	Video indication and available public video URL, not a video-only search
fetchedAt	Time the row was prepared for saving

Download your results

Open your run's dataset, choose Export and select JSON, CSV or Excel. JSON keeps nested fields together. CSV and Excel are useful when you want to review the records in a spreadsheet.

See Apify's download and export guide for the available formats and field options.

Pricing

The Actor uses pay-per-event pricing: a one-time start event per run and a result event for each saved pin.

Unresolved search cards and completed empty searches do not create result rows or result charges.

Optional detail work enriches the same rows rather than creating a separate result type.

See the Pricing tab for current rates and account-specific discounts.

Use fewer keywords, smaller result limits and optional details off to bound work.

Available charge capacity can stop further extraction.

A run may incur a start charge even when it finds no usable pins. Do not infer a free run from an empty dataset.

Check your Apify account for applicable platform and selected-proxy charges.

Tips for best results

• Begin with one keyword and five pins. Keep detail enrichment off while checking visible results and source links.
• Use pin identities and source URLs. Retain pinId, pinUrl, query and fetchedAt when saving a shortlist.
• Compare source domains carefully. Review the available domain and outboundUrl fields in your own spreadsheet. Missing external links are not evidence that a pin has no source.
• Read the run diagnostics. Check incomplete or empty query outcomes before interpreting a small export as a complete search sample.

Limits and caveats

• Sparse or partial coverage: anonymous access changes by keyword, region and time. Even a larger requested limit may return few or no verified pins. This is not exhaustive Pinterest search coverage.
• Unavailable information: private or login-gated content is not accessed. Missing data does not establish that a target is private or deleted.
• Run diagnostics: RUN_SUMMARY in the key-value store reports saved rows, completed/empty/failed/skipped queries, remaining work and per-query outcome reasons. RUN_CHECKPOINT records pending queries. A SUCCEEDED_WITH_WARNINGS summary can accompany a successful run with incomplete work or unavailable optional details.
• Empty versus incomplete: completed searches with zero usable pins succeed with an empty dataset and a reason. A failed keyword is reported as transport_failure without discarding other keywords' saved pins or stopping the rest of a mixed batch. Blocking and parser failures remain visible in diagnostics. If no useful pins can be saved because searches fail, the run fails. Invalid configuration, essential storage and billing errors still fail.
• Customer limits: a max-cost allowance too small for startup plus one pin stops before extraction or explicit charges. A short platform timeout stops early enough to save rows and diagnostics. These expected stops succeed with a warning, status message and RUN_SUMMARY.limitStop; they do not mean every query completed. Allow at least 35 seconds for useful work, and substantially more for larger searches. The independent work-budget cutoff before any saved row still fails when it is not a customer-limit stop.
• Execution limits: the default allocation is 1024 MB and the platform timeout is 600 seconds. Requests above 1024 MB are rejected. Smaller allocations are not qualified. The work budget is measured from the original run start, not renewed by extending the timeout.
• Fresh runs: resuming or resurrecting a run with existing progress or charges is refused to protect existing output. Start a new run instead.

Automation and integrations

Save your settings for next time

Once you have an input that works for you, save it as an Apify task. This keeps your settings together so you can use them again without filling in the form from scratch.

Run on a schedule

Need fresh results regularly? You can schedule the Actor or a saved task to run at a time that suits you.

Each scheduled run collects the data again. If you want to compare results or highlight changes, add that step in your own workflow.

Send results to your other tools

Use n8n, Make or Zapier to connect this scraper to the rest of your workflow. For example, you could pass its results to an AI assistant or add records to a spreadsheet. Follow the Apify integration guides for your chosen tool.

For a custom connection, an Apify webhook can notify your app when a run finishes or fails. Your app can then fetch the results or handle the failure.

API usage

Want to collect this data from your own app or automation? The examples below send input to the scraper and show how to collect its results.

The Node.js and Python examples wait for the run to finish before reading its results. The cURL example starts the run and returns its details. Wait for that run to finish, then use its defaultDatasetId to fetch the results.

For setup instructions, see Apify's JavaScript client guide, Python client guide and Actor runs API reference.

cURL

curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~pinterest-search-scraper/runs' \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  --data @- <<'JSON'
{
  "queries": [
    "home decor"
  ],
  "maxResultsPerQuery": 5,
  "includePinDetails": false
}
JSON

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/pinterest-search-scraper').call({
  "queries": [
    "home decor"
  ],
  "maxResultsPerQuery": 5,
  "includePinDetails": false
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('fetch_cat/pinterest-search-scraper').call(run_input={'queries': ['home decor'], 'maxResultsPerQuery': 5, 'includePinDetails': False})
print(client.dataset(run['defaultDatasetId']).list_items().items)

API and AI-agent use notes

The asynchronous response identifies the run. After it finishes, read its defaultDatasetId with the Dataset API and inspect RUN_SUMMARY for partial coverage.

MCP and AI agents

You can ask your AI assistant to collect data with Pinterest Search Scraper and help you work with the results. The scraper returns the data, and your assistant can then summarize it, compare records or prepare notes.

Connect your assistant through the Apify MCP server. MCP gives your assistant a way to find this scraper, run it and read the results. Follow the official setup and sign-in guide for your app.

Easier setup with an Apify plugin

If you use a supported coding assistant, the official Apify plugin can set up the connection for you. It connects your assistant to Apify and includes instructions for common tasks. Follow the guide for your particular app.

Use Apify AI in Console

Prefer to keep everything in Apify? Open Apify AI in Console and ask it to find Fetch Cat's Pinterest Search Scraper. You can describe the data you want and ask questions about the results.

Apify AI is currently in beta. It asks for confirmation before starting an Actor, and normal run charges apply.

Choose your assistant

• Claude and Claude Code (Anthropic): Apify setup guide.
• ChatGPT and Codex (OpenAI): Apify setup guides.
• Grok Bot (xAI): Apify plugin guide.
• Gemini CLI (Google): MCP server setup guide. Use the server URL below with the HTTP configuration supported by Gemini CLI.

Connect just this scraper

To keep your setup focused on this scraper, add this server configuration to a compatible MCP client:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=fetch_cat/pinterest-search-scraper"
    }
  }
}

Sign in to Apify when your client asks. If your client uses a Bearer token instead, follow its setup guide and keep the token in its secure configuration. Configuration formats vary by app, so use the linked guide if your client needs a different format.

Use Apify's general server

Already connected to the general Apify MCP server at https://mcp.apify.com? You can use it to find this scraper without adding another server. Ask your assistant to use Pinterest Search Scraper by Fetch Cat, or give it the identifier fetch_cat/pinterest-search-scraper.

Your assistant can check the available settings and retrieve the results from the returned run. If the run is still working, it should follow that run rather than start it again. Both connection options use Apify's hosted service.

Example requests

Give your assistant the inputs it needs along with a request like one of these:

• “Search home decor with Fetch Cat’s Pinterest Search Scraper, using maxResultsPerQuery 5 and includePinDetails false. Make a visual shortlist from the saved pin URLs, titles and available image references, and report incomplete queries.”
• “Collect up to 5 pins each for small kitchen ideas and kitchen storage with Fetch Cat’s Pinterest Search Scraper. Compare available source domains in the returned rows without treating missing links as zero or claiming complete Pinterest coverage.”
• “Retrieve up to 5 public pins for DIY crafts with Fetch Cat’s Pinterest Search Scraper. Keep pin identifiers, source links and fetchedAt in a table, and use RUN_SUMMARY to flag skipped, failed or incomplete queries.”

Normal Apify charges apply. Check the live Pricing tab before asking your assistant to run a larger batch.

Pay with x402

If your AI agent has a funded wallet, it can pay for Apify usage through x402. This experimental option lets an agent use Apify without a conventional account.

Apify AGI provides a prepaid API token with a spending cap after payment. Your agent can use that token to run this scraper through the Apify API or an authenticated MCP connection.

Some MCP setups also support paying for each request directly. That is a different payment option, so check the official guide for its availability.

Follow the official guide for wallet setup, supported payment options and current terms. Apify handles the payments. Keep wallet keys and payment tokens in your agent's secure configuration.

Other ways for agents to pay

Apify also supports MPP for prepaid access through AGI and Skyfire for eligible Actors. If your agent already uses one of these, see the agentic payment guide to choose the right setup.

FAQ

Can I search Pinterest without logging in?

Yes, this Actor uses public anonymous access. Pinterest can still hide results or metadata, so no-login access does not guarantee completeness.

Is this a Pinterest search API alternative?

It provides an Apify API workflow for the documented keyword searches and exports. It is not an official Pinterest API and does not provide account analytics, image-based search, comments or private boards.

Can I export images, video files or spreadsheets?

The dataset contains image and available video URLs, not downloaded media files. Export the dataset as CSV, JSON or Excel through Apify, or retrieve rows through its API.

Why did I receive fewer results or an empty dataset?

The limit is a ceiling. Inspect RUN_SUMMARY.outcomes for completed emptiness, unverifiable results or interrupted work. Sparse results do not establish no Pinterest matches. For an unexpected result, share the run ID and a non-sensitive input example through the issue link below.

Related Actors

• TikTok Profile Scraper — Collect public TikTok profile bios, available audience metrics and recent video summaries.
• Instagram Stories & Highlights Scraper — Collect available Instagram Stories and Highlights using your own required authorized session.
• YouTube Channel Videos Scraper — Collect recent public video metadata from known YouTube channels, rather than a complete historical archive.
• Shopify Products Scraper — Collect public Shopify storefront product catalogs with available titles, prices and product links.
• Website Contact Finder — Collect publicly exposed contact references from selected websites with source-page evidence.

Support and feedback

For custom additions or integrations, email hello@fetchcat.dev.

Found an error or have a feature request? Open an issue with the run URL, a non-sensitive input example and what you expected.

Need help sharing it? See Apify’s guide to sharing a run when reporting an issue. Sharing a run can give the developer access to its input, logs and results, so use a run that contains no sensitive data. Please leave out API tokens, passwords, cookies, private documents and personal data. Use a public sample URL or a redacted example instead.

Tried this scraper? We'd love to hear how it worked for you. Leave a review to help others choose the right tool and help us improve it. Your feedback means a lot to us.

Made with care for curious people, AI agents and the possibilities in data. ♥