# Pinterest Search Scraper | Pins, Images & Outbound Links (`genial_candlestand/pinterest-search-scraper`) Actor

Get Pinterest pins by keyword: original image URL, title, description, outbound link and website, reactions, publish date, author with followers, board, video stream and rank. Many keywords per run, any language, link/ads/reactions filters, no login.

- **URL**: https://apify.com/genial_candlestand/pinterest-search-scraper.md
- **Developed by:** [Flowo](https://apify.com/genial_candlestand) (community)
- **Categories:** Social media, SEO tools, AI
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.82 / 1,000 pins

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](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Pinterest Search Scraper | Pins, Images & Outbound Links

![Pinterest Search Scraper | Pins, Images & Outbound Links](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/pinterest-com-post-content-search-by-keyword-banner-724111d4.png)

Run Pinterest keyword searches and get one row per pin with the original image URL, title, description, alt text, the outbound link and its website, reactions count, publish date, the author with follower count, and the board. Every row also records the keyword and the rank where Pinterest showed the pin. You can search many keywords in one run, in any language, with no login or cookies.

### What does Pinterest Search Scraper do?

You give it a list of keywords. For each keyword it runs Pinterest's own search, pages through the results (up to 1,000 pins per keyword, or until Pinterest runs out at about 500–600), and saves each pin as a flat row. Content marketers, Pinterest managers, e-commerce and SEO teams, designers and AI agents use it to see which pins rank for a topic and which websites they link to.

You can search all pins or video pins only. Optional filters keep only pins with an outbound link, drop promoted pins (ads), or keep pins with a minimum number of reactions.

### How to scrape Pinterest search results

![Pinterest Search Scraper output example: Image, Title, Keyword, Rank, Reactions](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/pinterest-com-post-content-search-by-keyword-output-e626598f.png)

![How Pinterest Search Scraper works: Queries Pinterest's own web-app search JSON for each keyword; Pages through results 25 pins at a time until your limit or the end; Retries a blocked page on a new p](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/pinterest-com-post-content-search-by-keyword-how-c38a1ec8.png)

1. Open the actor in Apify Console and click **Try for free**.
2. Type your keywords into **Search keywords**, one per line (for example `minimalist living room` and `sourdough bread`).
3. Choose **Search for**: all pins or video pins only.
4. Set **Max pins per keyword** (default 100) and, if needed, **Max pins in total**.
5. Turn on any filters: only pins with an outbound link, exclude promoted pins, min reactions.
6. Click **Start**. When the run finishes, download the pins as JSON, CSV or Excel, or read them through the API.

### How much does it cost to scrape Pinterest?

Price per event by Apify plan:

| Event | Free | Bronze | Silver | Gold and above |
|---|---|---|---|---|
| Pin | $2.60 per 1,000 | $2.34 per 1,000 | $2.08 per 1,000 | $1.82 per 1,000 |
| Actor start | $0.00005 | $0.00005 | $0.00005 | $0.00005 |

A test run with the API example input below returned 100 rows in 13 s.

You pay per pin saved to the dataset (the `pin` event), plus a tiny Actor start event of $0.00005. Pins removed by your filters and duplicate pins are **not charged**. If a run finds nothing, you pay only the start event.

| Scenario | Pin events | Cost on the Free plan |
|---|---|---|
| 2 keywords × 100 pins (the default input) | 200 | about $0.52 |
| 10 keywords × 100 pins | 1,000 | about $2.60 |
| 1 keyword, deep pull (about 580 pins Pinterest shows) | ~580 | about $1.51 |
| 20 keywords × 250 pins | 5,000 | about $13.00 |

Paid Apify plans get a lower price per pin; see the table above.

### Input

![Pinterest Search Scraper input example: Search keywords, Search for, Max pins per keyword, Only pins with an outbound link, Exclude promoted pins (ads), Min reactions](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/pinterest-com-post-content-search-by-keyword-input-a1fe1815.png)

| Field | What it does |
|---|---|
| `queries` | **Required.** Keywords, one per line, up to 300 characters each. Any language and hashtags work. Keywords only, not URLs. |
| `searchType` | `pins` (default, the normal search) or `videos` (video pins only). |
| `maxItemsPerQuery` | Pins per keyword after filters, 1–1000, default 100. |
| `maxItems` | Optional cap on pins across all keywords. |
| `onlyWithLink` | Keep only pins that link to an external website. |
| `excludePromoted` | Drop promoted pins (ads). |
| `minReactions` | Keep only pins with at least this many reactions. |
| `proxyConfiguration` | Proxy settings; Apify datacenter proxy by default. |

Example input — find which websites get organic Pinterest traffic for a topic:

```json
{
  "queries": ["sourdough bread"],
  "onlyWithLink": true,
  "excludePromoted": true,
  "maxItemsPerQuery": 300
}
```

### What data can you extract from Pinterest?

| Field | Description |
|---|---|
| `query`, `position` | The keyword that found the pin and its 1-based rank in Pinterest's results |
| `id` | Pinterest pin id (logged-out `e1_…` form) |
| `url` | The Pinterest search page where the pin was found |
| `title`, `description`, `altText` | Pin title, the author's description, image alt text |
| `imageUrl`, `imageWidth`, `imageHeight`, `dominantColor` | Original image, its size and dominant colour |
| `isVideo`, `videoUrl`, `videoDurationMs` | Video flag, HLS stream URL (`.m3u8`) and duration |
| `outboundUrl`, `domain` | The external link of the pin and its website |
| `reactionsCount` | Total reactions shown on the pin |
| `publishedAt` | When the pin was created (ISO 8601) |
| `author`, `authorUsername`, `authorUrl`, `authorFollowersCount`, `authorVerified` | The pinner, their profile, follower count and verified flag |
| `boardName`, `boardUrl` | The board the pin is saved to |
| `isPromoted` | Whether the pin is a paid promoted pin |
| `tags` | Pinterest topics of the pin, when given |
| `scrapedAt` | When the row was scraped |

A real row from a run (shortened):

```json
{
  "id": "e1_AfqPShx879NkofSiGQzScATb_ewgvu-U2NEJH9XUwoy24OXTulbb",
  "url": "https://www.pinterest.com/search/pins/?q=sourdough%20bread",
  "query": "sourdough bread",
  "position": 1,
  "title": "Beginner’s Sourdough Bread",
  "altText": "a close up of a loaf of bread on a plate with the words beginner's sourdough bread",
  "imageUrl": "https://i.pinimg.com/originals/4a/0d/a5/4a0da51e59eb6d7ed378d230e0862600.jpg",
  "imageWidth": 1000,
  "imageHeight": 1800,
  "dominantColor": "#d5c093",
  "isVideo": false,
  "outboundUrl": "https://www.iheartnaptime.net/sourdough-bread/",
  "domain": "iheartnaptime.net",
  "reactionsCount": 249,
  "publishedAt": "2024-07-18T15:49:04.000Z",
  "author": "I Heart Naptime | Easy Family-Friendly Recipes",
  "authorUsername": "iheartnaptime",
  "authorFollowersCount": 4431075,
  "authorVerified": true,
  "boardName": "I HEART NAPTIME RECIPES",
  "isPromoted": false,
  "scrapedAt": "2026-11-04T21:51:14.242Z"
}
```

### Use cases

- **Content and trend research:** pull the top pins for several topics at once and compare titles, images and reactions by rank.
- **Traffic-source discovery:** with `onlyWithLink` and `excludePromoted`, see which websites and blogs Pinterest sends organic traffic to for a keyword.
- **Video research:** collect video pins for a topic with their stream URL and duration.
- **Moodboards:** gather original-size images with dominant colours for a style or theme.
- **AI agents:** get "top Pinterest pins for X" as structured JSON from one tool call.

### Limitations

- **No save or repin counts.** Pinterest's logged-out search gives only reactions, so the actor returns `reactionsCount` and no saves.
- **No working per-pin link.** Logged-out pin ids are obfuscated `e1_…` ids that do not open on `/pin/…`, so `url` is the search page where the pin was found.
- **About 500–600 unique pins per keyword** is the most Pinterest shows; above that you get what exists and a warning in the log.
- Board and profile search are not included.
- There is no country or language setting: tests showed they do not change Pinterest's results.
- Optional fields can be empty: many pins have no title, description or outbound link, and `tags` is often empty.

### Tips and troubleshooting

- **Fewer pins than requested?** Pinterest ran out for that keyword, or your filters removed many pins. The log says how many pins were kept and scanned.
- `onlyWithLink` with keywords whose pins rarely link out (for example `кошка`) can return few rows; the actor keeps paging up to 40 pages per keyword.
- Filters work with both search types and can be combined. Pins they drop are free.
- The same keyword twice is searched once. The same pin found by two different keywords appears once per keyword, so you can compare rankings.
- Pass keywords, not URLs: for a Pinterest search URL, put its `q=` value in `queries`.
- If runs get blocked, switch the proxy to the Apify RESIDENTIAL group.

### API, MCP and integrations

Run the actor from your code with the same JSON input as in Console. Your API token is in [Console → Settings → API & Integrations](https://console.apify.com/settings/integrations).

**Python** (`pip install apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("genial_candlestand/pinterest-search-scraper").call(run_input={
    "queries": ["minimalist living room", "sourdough bread"],
    "maxItemsPerQuery": 50,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

**Node.js** (`npm install apify-client`):

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('genial_candlestand/pinterest-search-scraper').call({
    "queries": ["minimalist living room", "sourdough bread"],
    "maxItemsPerQuery": 50,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

**HTTP** — one request runs the actor and returns the results (runs up to 5 minutes; longer ones: [run asynchronously](https://docs.apify.com/api/v2/act-runs-post)):

```bash
curl -X POST "https://api.apify.com/v2/acts/genial_candlestand~pinterest-search-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries":["minimalist living room","sourdough bread"],"maxItemsPerQuery":50}'
```

**AI agents (MCP).** Add the actor as a tool of the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp). Claude Code:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=genial_candlestand/pinterest-search-scraper"
```

Claude Desktop, Cursor or VS Code: `{"mcpServers": {"apify": {"url": "https://mcp.apify.com?tools=genial_candlestand/pinterest-search-scraper"}}}`. Then ask, for example:

- "Find the top 100 Pinterest pins for minimalist living room and list their titles, images and reactions"
- "Which websites do organic Pinterest pins for sourdough bread link to? Skip promoted pins"
- "Get 50 Pinterest video pins for dog training with their video URLs and durations"

**Integrations.** Run it on a schedule with [Apify Schedules](https://docs.apify.com/platform/schedules) and send the results to Google Sheets, Slack, Zapier, Make, n8n or your webhook — see [Apify integrations](https://docs.apify.com/platform/integrations).

### FAQ

**Do I need a Pinterest account or API key?**<br>
No. The actor uses Pinterest's public web search without login, cookies or a browser.

**Can I search in languages other than English?**<br>
Yes. Cyrillic, Chinese/Japanese characters, accents and hashtags like `#wedding` are searched exactly as typed.

**Why are there no saves?**<br>
Pinterest does not include save counts in logged-out search results. The actor gives the reactions count instead and does not fill a saves field with empty values.

**How is it different from other Pinterest search actors?**<br>
It takes many keywords per run, goes up to 1,000 pins per keyword, and puts `query` and `position` in every row. It has filters for outbound links, promoted pins and minimum reactions, and pins dropped by filters are not charged. The price is $2.60 per 1,000 pins on the Free plan, against $3.99 for the most used Pinterest search actor.

**Is it legal to scrape Pinterest?**<br>
The actor collects only data that Pinterest shows publicly in its search results. You are responsible for how you use it, including copyright on images and data-protection rules for author names and profiles. If unsure, ask a lawyer.

### Also useful

- [Google Trends Scraper](https://apify.com/genial_candlestand/google-trends-scraper) — check how search interest for your Pinterest keywords changes over time and by region
- [Google Trending Now Scraper](https://apify.com/genial_candlestand/google-trending-now-scraper) — find trending searches by country to pick new Pinterest topics
- [YouTube Channel Scraper](https://apify.com/genial_candlestand/youtube-channel-details-videos-scraper) — compare creators on YouTube: subscribers, videos, Shorts and views
- [Google News Scraper](https://apify.com/genial_candlestand/google-news-articles-search-scraper) — follow news articles on the same topics you research on Pinterest

# Actor input Schema

## `queries` (type: `array`):

Keywords to search on Pinterest, one per line, as you would type them in the Pinterest search box. Any language and hashtags work, up to 300 characters each. Every row says which keyword found the pin. Keywords only, not URLs.

## `searchType` (type: `string`):

All pins = the normal Pinterest search (mostly images, a few videos). Video pins only = video pins with the stream URL and duration. Applies to every keyword.

## `maxItemsPerQuery` (type: `integer`):

Stop after this many pins for each keyword, counted after filters. Pinterest shows at most about 500–600 unique pins per keyword; if it runs out earlier you get what exists and a warning in the log.

## `maxItems` (type: `integer`):

Optional cap on all pins of the run across all keywords. Keywords run up to 3 at a time, so later keywords may get fewer or no pins once the cap is reached. Leave empty for no total cap.

## `onlyWithLink` (type: `boolean`):

Keep only pins that link to an external website (recipes, shops, blogs). Useful for finding which sites get Pinterest traffic. Dropped pins are free.

## `excludePromoted` (type: `boolean`):

Drop paid promoted pins from the results. Dropped pins are free.

## `minReactions` (type: `integer`):

Keep only pins with at least this many reactions. 0 keeps all. Pinterest search shows no save counts, so filter by reactions instead. Dropped pins are free.

## `proxyConfiguration` (type: `object`):

Proxy for requests to Pinterest. The default Apify datacenter proxy works; switch to the RESIDENTIAL group only if runs get blocked.

## Actor input object example

```json
{
  "queries": [
    "minimalist living room",
    "sourdough bread"
  ],
  "searchType": "pins",
  "maxItemsPerQuery": 100,
  "onlyWithLink": false,
  "excludePromoted": false,
  "minReactions": 0,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset with all pins

## `overview` (type: `string`):

Pins in the overview table view

# 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

```javascript
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 = {
    "queries": [
        "minimalist living room",
        "sourdough bread"
    ]
};

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

```python
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 = { "queries": [
        "minimalist living room",
        "sourdough bread",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("genial_candlestand/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

```bash
echo '{
  "queries": [
    "minimalist living room",
    "sourdough bread"
  ]
}' |
apify call genial_candlestand/pinterest-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,genial_candlestand/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/WKwTu4DvVpV0Gsmcd/builds/zOsW1SWGdXM0lhVI9/openapi.json
