Pinterest Search Scraper: Pins & Boards, No Login (Apify Actor)

npx add-mcp 'https://mcp.apify.com/?tools=cliqtomedia/pinterest-search-scraper'

Pinterest Search Scraper: Pins & Boards, No Login (cliqtomedia/pinterest-search-scraper) Actor

Scrape Pinterest search results, boards and profiles without login or cookies. Get pin title, description, image URL, outbound link, board, pinner, saves, created date and dominant color, or board stats. Clean JSON, CSV or Excel.

• URL: https://apify.com/cliqtomedia/pinterest-search-scraper.md
• Developed by: Cliqto Media (community)
• Categories: Social media, Marketing
• Features: Limited permissions
• Stats: 7 total users, 3 monthly users, 99.3% runs succeeded, 1 bookmarks
• User rating: No ratings yet

Pricing

from $1.20 / 1,000 pin or board rows

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/actors/running/actors-in-store.md#pay-per-event

What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the API section below.

Each client library has reference documentation the quickstart does not restate: JavaScript/TypeScript (npm install apify-client) and Python (pip install apify-client).

README

Pinterest Search Scraper gets pins and boards from Pinterest search, public boards and public profiles, with no login and no cookies, and saves them as clean rows: title, description, image URL, outbound link, board, pinner, saves, created date and dominant color.

It is for marketers, content teams, e-commerce sellers and trend researchers. The smallest run is one keyword, for example home office ideas, with 20 pins. It finishes in a few seconds and costs $0.034 on the Free plan.

Table of contents

• What it does
• Quick start
• Use cases
• Input
• Output
• Pricing and limits
• API, export and integrations
• Use with AI agents (MCP)
• Troubleshooting
• FAQ
• Support

What it does

The Actor reads public Pinterest pages the way a logged-out visitor sees them. It has three modes:

• search: you give keywords (or pinterest.com/search/... URLs). You get the pins, or the boards, that Pinterest shows for each keyword.
• board: you give board URLs. You get the pins of each board.
• profile: you give profile URLs or usernames. You get the pins of the profile, or its boards.

Each pin or board is one row in the Dataset. Every row also says where it came from: the keyword or URL and its position in the Pinterest results.

The Actor does not download images. It saves image links only.

Good fit

• Find popular pins and outbound shop links for a product keyword.
• Collect the boards and board stats (pins, followers) of a brand profile.
• Build a list of image URLs, titles and colors for a mood board or a dataset.

Not a fit / limits

• No login. Private boards, secret boards and your own account data are not available.
• A board gives only about 100 of its newest pins without login. The Actor tells you this in the run summary when a board has more pins.
• Pinterest decides how deep a search goes. One keyword usually gives 300–970 pins, and the number changes from day to day.
• Comments as text, related pins, board sections and video files are not collected.

Quick start

1. Open the Input tab.
2. Keep What to scrape = search and type a keyword in Search keywords, for example home office ideas.
3. Keep Max results per keyword or URL = 20 (the form's prefill; the API default is 50).
4. Click Start.
5. Open the Output tab and the Pins view. Check the title, imageUrl and link columns.

Expected result: 20 pin rows for the keyword in a few seconds.

Use cases

Buyer job	Input path	Output entity	Key fields	Next step
Trend and content research	mode: search, queries	pin	title, description, reactionCount, createdAt	sort by createdAt in a spreadsheet
Find shops and outbound links	mode: search, queries	pin	domain, link (when Pinterest returns it)	group by domain
Competitor or brand boards	mode: profile, urls, resultType: boards	board	name, pinCount, followerCount	compare profiles
Collect one board	mode: board, urls	pin	imageUrl, title, dominantColor	mood board, image dataset

Input

Input fields

Field	Plain name	Type	Required	Default / prefill	Allowed values	Effect	Example	Recommendation
mode	What to scrape	string	yes	default search, prefill search	search, board, profile	What to read	"search"	Pick the mode that matches your inputs
queries	Search keywords	array of strings	no*	prefill ["home office ideas"]	up to 50	Each keyword is searched separately; duplicates run once. In board or profile mode you can put username/board or usernames here too	["home office ideas"]	Use plain words, any language
urls	Pinterest URLs	array of strings	no*	none	up to 50; any Pinterest country domain	Board, profile or search URLs. @username and username/board also work	["https://www.pinterest.com/marthastewart/"]	Pin, section and non-Pinterest URLs are skipped and listed in the run summary
resultType	Results	string	no	pins	pins, boards	Pins or boards (search and profile). Board mode always gives pins. A search URL's own /pins/ or /boards/ path wins	"boards"	Use boards for board stats
maxItems	Max results per keyword or URL	integer	no	default 50, prefill 20	1–1000	Stops each keyword, board or profile after this many rows	200	You pay per saved row, so set what you need
includePinDetails	Try to add saves to search pins	boolean	no	false	true / false	Opens search pins that have a numeric ID to add saves, commentCount and a missing link	true	Most search pins now have new-style IDs (e1_…) and stay without saves. For saves use board or profile mode. Same price per row
proxyConfiguration	Proxy	object	no	{"useApifyProxy": true}	Apify Proxy or your own	Which IPs reach Pinterest	{"useApifyProxy": true}	Change only if runs get blocked (try the RESIDENTIAL group)

* Give at least one keyword or URL. Empty input stops the run with INVALID_INPUT and no requests.

Total keywords and URLs: up to 50 per run. Duplicates are removed. Wrong URLs (a pin URL, a non-Pinterest site) are marked invalid; the other inputs still run.

Interacting settings

When	Input A	Input B	Effective behavior	Cost/result effect
Board mode	mode: board	resultType	Always pins	none
Search URL with path	urls: [".../search/boards/?q=..."]	resultType: pins	The URL path (boards) wins	none
Search pins	mode: search	includePinDetails: false	saves and commentCount are null	faster
Search pins	mode: search	includePinDetails: true	One extra request per pin with a numeric ID. Since October 2026 Pinterest search returns new-style pin IDs (e1_…) that the detail lookup this Actor uses does not accept: those pins keep saves and commentCount as null and are counted in RUN_SUMMARY.counts.detailFailures	slower: about 5 pins per second

Input examples

Search pins for a keyword (the prefill)

{
  "mode": "search",
  "queries": ["home office ideas"],
  "maxItems": 20
}

Expected behavior: one search, 20 pins. Expected output: pin rows with title, imageUrl, link, boardName, createdAt.

Several keywords with pin details

{
  "mode": "search",
  "queries": ["small kitchen organization", "wedding cake ideas", "décoration salon bohème"],
  "maxItems": 100,
  "includePinDetails": true
}

Expected behavior: 3 keywords × 100 pins. Pins with a numeric ID are opened for saves; pins with new-style IDs (e1_…, most search pins since October 2026) are kept without saves and counted in RUN_SUMMARY.counts.detailFailures. For saves, use board or profile mode.

Boards of profiles

{
  "mode": "profile",
  "resultType": "boards",
  "urls": ["@marthastewart", "https://www.pinterest.co.uk/bhg/"],
  "maxItems": 300
}

Expected behavior: one board row per board of each profile, with pinCount and followerCount.

Output

Results go to the default Dataset. The Output tab has two views: Pins and Boards. A run summary is saved as RUN_SUMMARY in the Key-value store.

Output fields

Pin rows (type: "pin"):

Field	Meaning	Type	Can be empty?	Example
type	Row kind	string	no	pin
pinId	Pinterest pin ID: numeric or, for search since October 2026, new-style e1_…; both open as url	string	no	847802698648761780
url	Pin page	string	no	https://www.pinterest.com/pin/847802698648761780/
title	Pin title	string	yes	Boho Rattan Pendant Light Ideas…
description	Pin description; blank text becomes null	string	yes	Create a warm and relaxing space…
altText	Image alt text	string	yes	a living room filled with…
imageUrl	Largest image link	string	yes	https://i.pinimg.com/originals/…jpg
imageWidth, imageHeight	Image size in pixels	integer	yes	564, 1002
link	Outbound link of the pin	string	yes	https://indochinadecor.com/products/…
domain	Domain of the outbound link	string	yes	indochinadecor.com
isVideo	Pin is a video	boolean	yes	false
isPromoted	Pin is an ad	boolean	yes	false
boardId, boardName, boardUrl	Board of the pin	string	yes	Lighting ideas for boho style living room
pinnerUsername, pinnerFullName	Who saved the pin	string	yes	indochinalamp
pinnerFollowerCount	Followers of the pinner	integer	yes	190
saves	How many times the pin was saved	integer	yes: search pins need includePinDetails and a numeric pin ID	48
commentCount	Comments	integer	yes: search pins need includePinDetails and a numeric pin ID	0
reactionCount	Reactions	integer	yes	2
createdAt	When the pin was created (ISO 8601, UTC)	string	yes	2026-03-14T11:15:25.000Z
dominantColor	Main image color	string	yes	#9d8464

Board rows (type: "board"):

Field	Meaning	Type	Can be empty?	Example
boardId	Board ID	string	no	32088284784055018
url	Board page	string	no	https://www.pinterest.com/marthastewart/baby-shower-planning-and-ideas/
name	Board name	string	yes	Baby Shower Planning and Ideas
description	Board description	string	yes	From baby shower themes…
pinCount	Pins on the board	integer	yes	194
followerCount	Board followers	integer	yes: usually empty in board search, filled for profile boards	1503742
sectionCount, collaboratorCount	Sections and collaborators	integer	yes	0
isCollaborative	Group board	boolean	yes	false
ownerUsername, ownerFullName	Board owner	string	yes	marthastewart
coverImageUrl	Cover image link	string	yes	https://i.pinimg.com/474x/…jpg
createdAt	When the board was created	string	yes: usually empty in board search	2013-04-11T13:34:45.000Z

Fields in every row:

Field	Meaning	Type	Can be empty?	Example
mode	Mode of the run	string	no	search
searchQuery	Keyword of the row	string	yes (board/profile rows)	home office ideas
inputUrl	Board or profile URL of the row	string	yes (keyword rows)	https://www.pinterest.com/marthastewart/
input	Your input exactly as typed	string	no	@marthastewart
position	Position in the Pinterest results for this input, from 1	integer	no	4
fetchedAt	When the row was read	string	no	2026-10-14T11:54:57.617Z

Rows of different inputs can be mixed in the Dataset, because up to 3 inputs are read at the same time. Sort by input and position to get the Pinterest order back.

Output entities and surfaces

Situation	Where	Result shape	What to do
Normal result	Dataset, views Pins / Boards	one row per pin or board	open, export or use via API
Keyword with no results	RUN_SUMMARY	target empty, run NO_RESULTS if all are empty	check the spelling or try another keyword
Board or profile does not exist	RUN_SUMMARY	target not_found, run NOT_FOUND if none exist	check the URL
Your max total charge was reached	Dataset + RUN_SUMMARY	rows saved so far, run PARTIAL / CHARGE_LIMIT, run status Succeeded	raise the max charge or lower maxItems
Run timeout was near	Dataset + RUN_SUMMARY	rows saved so far, PARTIAL / DEADLINE_REACHED	raise the run timeout or lower maxItems
Pinterest refused or blocked after some rows	Dataset + RUN_SUMMARY	rows saved so far, PARTIAL / SOURCE_ERROR, run status Failed	run again later or use the RESIDENTIAL proxy group
Pinterest refused before any row	RUN_SUMMARY	ERROR, run status Failed	same as above

RUN_SUMMARY has status, message, counts (rows, complete, empty, not found, invalid, skipped), one targets entry per keyword or URL with its own status, and warnings (for example, a board that has more than the ~100 pins available without login).

Output example

One pin from a board run (mode: board, Martha Stewart's "Baby Shower Planning and Ideas" board; description and link shortened). Search pins look the same, but saves and commentCount are usually null:

{
  "type": "pin",
  "pinId": "e1_AfqPShxiIokPON5Bkrb3QXdJSK8aiWmECI9gI4-cnk4XlqGBCAA",
  "url": "https://www.pinterest.com/pin/e1_AfqPShxiIokPON5Bkrb3QXdJSK8aiWmECI9gI4-cnk4XlqGBCAA/",
  "title": "How to Make a Geometric Hanging Mobile Decoration",
  "description": "Follow along with our easy tutorial for a hanging abstract mobile decoration. …",
  "altText": "an image of a table with food on it and the title how to make a geometric hanging mobile decoration",
  "imageUrl": "https://i.pinimg.com/originals/22/24/85/222485d96c8714a333d90bf8d5157e5e.jpg",
  "imageWidth": 600,
  "imageHeight": 900,
  "link": "https://www.marthastewart.com/265650/the-modern-baby-shower",
  "domain": "marthastewart.com",
  "isVideo": false,
  "isPromoted": false,
  "boardId": "32088284784055018",
  "boardName": "Baby Shower Planning and Ideas",
  "boardUrl": "https://www.pinterest.com/marthastewart/baby-shower-planning-and-ideas/",
  "pinnerUsername": "marthastewart",
  "pinnerFullName": "Martha Stewart",
  "pinnerFollowerCount": null,
  "saves": 359,
  "commentCount": null,
  "reactionCount": 0,
  "createdAt": "2020-07-16T01:25:28.000Z",
  "dominantColor": "#d3d5d1",
  "mode": "board",
  "searchQuery": null,
  "inputUrl": "https://www.pinterest.com/marthastewart/baby-shower-planning-and-ideas/",
  "input": "https://www.pinterest.com/marthastewart/baby-shower-planning-and-ideas/",
  "position": 3,
  "fetchedAt": "2026-10-18T12:07:33.659Z"
}

null means Pinterest did not give this value for this pin. Values are what a logged-out visitor sees at run time.

Pricing and limits

Pricing unit

This Actor uses pay-per-event pricing. You pay:

• Actor start: $0.004 per run (one event for runs up to 1 GB memory; the default is 256 MB).
• Pin or board row: one event per row saved to the Dataset.

Store plan	Price per row	Per 1,000 rows
Free	$0.0015	$1.50
Bronze	$0.0014	$1.40
Silver	$0.0013	$1.30
Gold and higher	$0.0012	$1.20

Platform usage (compute, proxy, storage) is included; you do not pay it separately. includePinDetails does not change the price per row.

Every run pays the start event, $0.004, also a run with no rows (all keywords empty, all boards or profiles not found, or invalid input). Empty, not found, invalid and skipped inputs add no rows and are not charged. If your max total charge is reached, the Actor stops, keeps the rows it saved and does not save more.

Cost examples (Free plan)

Scenario	Input scope	Rows	Charge	Run time in our tests
Prefill	1 keyword × 20	20	$0.004 + $0.030 = $0.034	2–6 s
Small	1 keyword × 100	100	$0.004 + $0.150 = $0.154	10–20 s (estimate)
Three keywords	3 keywords × 100	300	$0.004 + $0.450 = $0.454	about 1 min (estimate)
Large (timeout 600 s)	10 keywords × 1000	about 9,000	$0.004 + about $13.50	about 5 min
Nothing found	50 profiles that do not exist	0	$0.004	about 30 s

Limits

• Up to 50 keywords and URLs per run, up to 1,000 rows each. Our largest test: 10 keywords × 1000 gave 9,097 rows in about 5 minutes with no blocks.
• Search depth is set by Pinterest: usually 300–970 pins per keyword.
• Boards: about 100 newest pins without login.
• Up to 3 inputs at a time and up to 4 requests to Pinterest at a time.
• The default run timeout is 300 seconds. For more than about 2,000 rows, raise the timeout in the run options.

API, export and integrations

• API: start the Actor with POST https://api.apify.com/v2/acts/cliqtomedia~pinterest-search-scraper/runs and the input JSON. Read rows from the run's default Dataset.
• Export: download the Dataset as JSON, CSV, Excel, XML or HTML from the Output tab or the Dataset API.
• Scheduling: use an Apify schedule to collect the same keywords every day or week. Each run is a fresh snapshot, not a diff.
• No-code: connect the Dataset to Google Sheets, Make, Zapier or n8n with Apify integrations.

Use with AI agents (MCP)

• MCP server URL with only this Actor: https://mcp.apify.com?tools=cliqtomedia/pinterest-search-scraper. See Apify MCP server.
• Smallest useful input: {"mode": "search", "queries": ["home office ideas"], "maxItems": 20}.
• Key output fields: title (pin title), imageUrl (image link), link (outbound shop or blog link), saves (popularity, when Pinterest provides it), boardName (where the pin is saved).
• A 20-row run takes a few seconds and costs $0.034 on the Free plan. Keep maxItems small and read RUN_SUMMARY.status before you use the rows.

Troubleshooting

saves is empty

Symptom: saves and commentCount are null for search pins. Reason: Pinterest search results do not include these numbers, and search pins with new-style IDs (e1_…) cannot be opened for details. Action: use board or profile mode, where pins include saves. includePinDetails helps only for search pins with a numeric ID.

A board gives fewer pins than it has

Symptom: a board shows 500 pins, but you get about 100. Reason: without login Pinterest shows only about 100 newest pins of a board. RUN_SUMMARY.warnings says so. Action: search for the board topic with keywords to get more pins.

Fewer search results than maxItems

Symptom: target status complete, but fewer rows than you asked for. Reason: Pinterest ended the search results. The depth changes from day to day. Action: add related keywords.

Run status is Failed with SOURCE_ERROR or ERROR

Symptom: the run failed and RUN_SUMMARY.status is PARTIAL with SOURCE_ERROR, or ERROR. Reason: Pinterest refused requests (for example, too many requests or a block). This is not an empty result. Action: rows saved before the error stay in the Dataset. Run again later, or set the proxy group to RESIDENTIAL.

FAQ

Do I need a Pinterest account or cookies?

No. The Actor reads only what a logged-out visitor sees. Do not put cookies or passwords in the input.

Does it download images?

No. It saves image links (imageUrl, coverImageUrl). You can download them later with your own tool.

Why do I get different pins than yesterday?

Pinterest changes search results all the time and shows logged-out visitors different results. Each run is a snapshot of that moment.

Is the output the same as other Pinterest scrapers?

The rows are flat: one level, no nested objects. If you move from another Pinterest Actor, map the field names using the tables above.

Can I scrape comments, related pins or board sections?

Not in this version. You get reactionCount in every pin row. commentCount comes only from pin details, which work for search pins with a numeric ID.

Support

For bugs, questions or feature requests, open an issue on the Issues tab of this Actor. Add the run ID, the mode and the error text from RUN_SUMMARY. Do not send tokens, cookies or passwords.

Changelog

This Actor's version history is a separate document: https://apify.com/cliqtomedia/pinterest-search-scraper/changelog.md

Actor input Schema

mode (type: string):

search: keywords or pinterest.com/search URLs. board: board URLs (pinterest.com/username/board-name/). profile: profile URLs or usernames.

queries (type: array):

Search mode: up to 50 keywords, e.g. home office ideas. Each keyword is searched separately; duplicates are searched once. In board or profile mode you may put board paths (username/board) or usernames here instead of URLs.

urls (type: array):

Board URLs (https://www.pinterest.com/username/board-name/), profile URLs (https://www.pinterest.com/username/) or search URLs (https://www.pinterest.com/search/pins/?q=...). Any Pinterest country domain works. Pin, section and non-Pinterest URLs are skipped and listed in RUN_SUMMARY.

resultType (type: string):

pins: one row per pin. boards: one row per board (board search results, or the boards of a profile). Board mode always returns pins. A search URL's own /pins/ or /boards/ path wins over this setting.

maxItems (type: integer):

Stop each keyword, board or profile after this many rows (1–1000). You pay per saved row.

includePinDetails (type: boolean):

Pinterest search pages do not include the saves count, outbound link for some pins, or comment count. When on, the Actor opens search pins that have a numeric ID to fill these fields (one extra request per pin, same price per row). Most search pins now have new-style IDs (e1_…) that this lookup does not accept; they keep these fields empty. For saves, use board or profile mode.

proxyConfiguration (type: object):

Apify Proxy is used by default so Pinterest sees ordinary visitor IPs. Change only if Pinterest blocks runs (try the RESIDENTIAL group).

Actor input object example

{
  "mode": "search",
  "queries": [
    "home office ideas"
  ],
  "resultType": "pins",
  "maxItems": 20,
  "includePinDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Actor output Schema

pins (type: string):

Pin rows as a table.

boards (type: string):

Board rows as a table.

runSummary (type: string):

Status, per-input results, counts, warnings and request statistics.

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

import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "queries": [
        "home office ideas"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("cliqtomedia/pinterest-search-scraper").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

from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "queries": ["home office ideas"],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("cliqtomedia/pinterest-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

CLI example

echo '{
  "mode": "search",
  "queries": [
    "home office ideas"
  ],
  "maxItems": 20
}' |
apify call cliqtomedia/pinterest-search-scraper --silent --output-dataset

MCP server setup

{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,cliqtomedia/pinterest-search-scraper"
        }
    }
}

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an Authorization: Bearer <APIFY_API_TOKEN> header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/12PzKzuTzvp0lBiVj/builds/ymPtH6jVc4JPAISdm/openapi.json