# Pinterest Scraper - Pins, Boards, Profiles & Keyword Search (`nexuscortex/pinterest-scraper`) Actor

Pinterest scraper and unofficial Pinterest API. Scrape pins by keyword, board, profile or pin URL without login: original images, video URLs, outbound links and domains, saves, reactions and Pinterest SEO keywords. Export to JSON, CSV or Excel.

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

## Pricing

from $2.00 / 1,000 results

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 Scraper & Unofficial Pinterest API - Pins, Boards, Profiles & Keyword Search

Scrape public Pinterest pins by **keyword**, **board URL**, **profile URL** or **single pin URL**, and get clean, flat rows ready for spreadsheets: original-resolution image, outbound product/blog link with its domain, video file URLs, saves, reactions, comment counts, Pinterest's own SEO keywords for the pin, pinner and board details.

No Pinterest account, cookies or API key needed. The Actor only reads what any visitor can see without logging in, over plain HTTP (no browser), so it is fast and cheap: roughly 600+ pins per minute in our tests.

Use it as a **Pinterest search scraper**, **Pinterest board scraper**, **Pinterest image and video URL extractor** or an **unofficial Pinterest API** from your code, Make, Zapier, n8n or Google Sheets.

### How to scrape Pinterest

1. Click **Try for free** (or **Start**) on this page.
2. Enter search keywords, or paste Pinterest board, profile or pin URLs.
3. Set **Maximum results** to cap the size and cost of the run. Optionally keep only pins that link to certain domains.
4. Run the Actor, then download the pins as JSON, CSV or Excel, or read them through the Apify API.

### What makes it useful

- **E-commerce and link research**: every pin carries `link` (tracking parameters such as `utm_*`, `fbclid`, `gclid` and Pinterest's `epik` removed; on Etsy also its `ref`/`click_key` click tracking) and `linkDomain`. Filter with *Only pins with an outbound link* or *Only pins linking to these domains* (for example `etsy.com`, `amazon.com`, your own shop) and **skipped pins are not charged**.
- **Pinterest SEO keywords**: for search results, `keywords` holds the keyword phrases Pinterest itself has annotated the pin with, which is a quick way to see how pins in a niche are described.
- **Keyword expansion**: turn on *Expand keywords* to also search Pinterest's autocomplete suggestions for each keyword (long-tail ideas) in the same run. Results are de-duplicated across keywords.
- **Cross-source de-duplication**: the same pin is only returned once per run, even if it shows up in several keywords or boards.
- **Original media**: `imageUrl` points to the `originals` file. Video pins include an MP4 URL, an HLS URL, duration and thumbnail.
- **Related pins**: for a pin URL, optionally also return the "more like this" pins.
- **Ads are skipped**: promoted pins are not returned.

### Use cases

- Find which blogs and shops Pinterest users save from in a niche, and which pins get the most saves and reactions
- Monitor which pins link to your website or a competitor's domain
- Build mood boards and image datasets with titles, alt text and dominant colors
- Collect keyword ideas and descriptions that Pinterest associates with a topic
- Export all pins of a public board or brand profile for audits

### Input

| Field | Description |
|---|---|
| `searchQueries` | Keywords to search, one per line |
| `startUrls` | Board, profile, search or pin URLs (numeric pin ids only) |
| `maxItems` | Total cap on dataset items for the run (default 50). This is also your maximum spend |
| `maxItemsPerSource` | Cap per keyword or URL (default 100) |
| `expandKeywords` | Also search the first N autocomplete suggestions per keyword (0-10) |
| `relatedPinsPerPin` | For pin URLs, also return N related pins |
| `onlyPinsWithLink` | Keep only pins with an outbound link |
| `linkDomains` | Keep only pins linking to these domains |
| `dedupeImages` | Also drop different pins that reuse exactly the same image |
| `includeSourceSummary` | Add one `board` / `profile` row per board or profile URL |
| `proxyConfiguration` | Apify Proxy settings (default: Apify Proxy) |

Example:

```json
{
    "searchQueries": ["minimalist living room", "wedding cake"],
    "startUrls": [
        { "url": "https://www.pinterest.com/nike/" },
        { "url": "https://www.pinterest.com/kschroer/wedding-table-decorations/" }
    ],
    "maxItems": 100,
    "maxItemsPerSource": 25,
    "onlyPinsWithLink": false,
    "proxyConfiguration": { "useApifyProxy": true }
}
```

### Output

One row per pin. Example (shortened):

```json
{
    "type": "pin",
    "id": "516084438595318488",
    "pinUrl": "https://www.pinterest.com/pin/516084438595318488/",
    "title": "Patri Guijarro x Nike United",
    "description": "Behind the scenes with Patri Guijarro on set for Nike United.",
    "createdAt": "2026-10-22T19:05:56.000Z",
    "mediaType": "image",
    "imageUrl": "https://i.pinimg.com/originals/63/32/a0/6332a03c49a9350233bdaadfe68b5a5b.jpg",
    "imageWidth": 693,
    "imageHeight": 1039,
    "link": "https://www.nike.com/w/nike-united-2n0uw?cp=92288538222_osoc_",
    "linkDomain": "nike.com",
    "saves": 4,
    "reactions": 0,
    "comments": 0,
    "keywords": [],
    "hashtags": [],
    "pinnerUsername": "nike",
    "boardName": "Look of Football (Soccer)",
    "boardUrl": "https://www.pinterest.com/nike/look-of-football-soccer/",
    "source": { "type": "profile", "value": "https://www.pinterest.com/nike/" }
}
```

Other fields: `altText`, `imageUrl736`, `dominantColor`, `videoUrl`, `videoHlsUrl`, `videoDurationSec`, `videoThumbnailUrl`, `isUpload`, `isShoppable`, `pinnerName`, `pinnerUrl`, `boardId`, `boardPinCount`, `imageSignature`, `scrapedAt`. A real sample is in `samples/output.json`.

#### Which fields are available for which source

| Field | Keyword search | Board | Profile | Pin URL / related |
|---|---|---|---|---|
| Image, title, description, link, domain, pinner, board | yes | yes | yes | yes |
| `keywords` (Pinterest SEO annotations) | yes | no | no | related pins only |
| `saves` | **no** (Pinterest does not return it logged out) | yes | yes | pin: yes, related: no |
| `reactions` | yes | yes | yes | yes |
| `comments` | no | no | yes | pin: yes |
| `pinUrl` | **no** | **no** | yes | pin: yes |

Pinterest hides the numeric pin id from logged-out search and board feeds. For those pins `id` is Pinterest's opaque identifier, which is stable and good for de-duplication, but `pinUrl` is `null`. Use `imageUrl` and `link` to reach the content.

### Pricing

Pay per result: you pay for each dataset item. Set *Maximum results* (or your Apify max-charge limit) to cap spend. The Actor stops cleanly when the limit is reached. Pins skipped by filters or de-duplication are never charged. Each run also has Apify's standard start fee of $0.00005 ($0.05 per 1,000 runs), which covers the first seconds of compute. Apify subscribers pay less per result: 10% off on Bronze, 15% on Silver and 20% on Gold and higher plans.

### FAQ

**Does it need a Pinterest login?** No. It never logs in and never asks for cookies.

**Is there an official Pinterest API? Why use this instead?** Pinterest's official API needs an approved developer app and OAuth, and is built mainly for managing your own boards, pins and ads. This Actor needs none of that: it reads the public pins, boards and search results any logged-out visitor can see.

**How many pins can I get per keyword or board?** Pinterest serves about 1,000 pins per search or board when you scroll. In our test, 14 result pages (349 unique pins) were fetched for one keyword without issues.

**Why are `saves` empty for keyword search?** Pinterest does not send save counts for search results to logged-out visitors. Use `reactions`, or paste the board/profile/pin URLs to get saves.

**Do you return product prices?** Not reliably. Pinterest does not expose price data to logged-out visitors for most pins. If a pin carries product data, `price`, `currency` and `availability` are filled in; otherwise they are absent. The `link` and `isShoppable` fields tell you where the product lives.

**Can it scrape private boards, home feed, followers, or Pinterest Trends?** No. Those require a login, so they are intentionally not supported.

**Do I need a proxy?** Apify Proxy is enabled by default and recommended. If a very large run is rate limited, switch to the residential group and raise the request delay.

### Limitations

- Only public, logged-out data. Private boards and profiles return nothing.
- Personal profiles often have no "Created" pins; in that case the Actor reads their public boards instead.
- With strict filters (*Only pins with an outbound link*, *Only pins linking to these domains*) a source stops early when 15 pages in a row (375 pins) bring no new match, or after scanning about 20 pages per 25 results still wanted (at least 40 pages). This keeps a filter that almost never matches from paging through a whole feed.
- Pinterest changes its website often. If a field disappears, open an issue and we will update the Actor.

### Legal note

This Actor collects only publicly visible information and does not collect email addresses, phone numbers or other private data. You are responsible for using the data in line with Pinterest's terms, copyright law (images belong to their owners) and privacy regulations such as GDPR. Do not use it for harassment, spam or to republish content without permission.

### Feedback

Found a bug or need a field? Open an issue in the Issues tab and we will look at it. If this Actor saved you time, a short review on this page helps other users find it.

### More scrapers from NexusCortex

- [Threads Scraper](https://apify.com/nexuscortex/threads-scraper): posts, profiles and replies of Threads accounts
- [Facebook Ads Library Scraper](https://apify.com/nexuscortex/facebook-ads-library-scraper): Facebook and Instagram ads from the Meta Ad Library
- [Google Trends Scraper](https://apify.com/nexuscortex/google-trends-scraper): interest over time, by region and related queries
- [Telegram Channel Scraper](https://apify.com/nexuscortex/telegram-channel-scraper): posts, views and reactions of public Telegram channels

# Actor input Schema

## `searchQueries` (type: `array`):

Keywords to search on Pinterest, one per line, e.g. "minimalist living room". Each keyword returns pins in Pinterest's own ranking.

## `startUrls` (type: `array`):

Public Pinterest URLs: board (pinterest.com/user/board-name/), profile (pinterest.com/user/), search page (pinterest.com/search/pins/?q=...) or a single pin with a numeric id (pinterest.com/pin/123456789/). Any country domain works.

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

Hard cap on dataset items for the whole run. You are charged per item, so this is also your maximum spend. 0 = no cap (the run still stops at your max-charge limit).

## `maxItemsPerSource` (type: `integer`):

Stops each keyword or URL after this many results so one source cannot use the whole budget. 0 = unlimited. Pinterest usually serves around 1,000 pins per keyword or board.

## `expandKeywords` (type: `integer`):

For every keyword, also search the first N autocomplete suggestions (long-tail keywords such as "wedding cake ideas"). 0 = off. Results are de-duplicated across keywords.

## `relatedPinsPerPin` (type: `integer`):

For each single-pin URL, also return up to N "more like this" pins. 0 = only the pin itself.

## `onlyPinsWithLink` (type: `boolean`):

Keep only pins that link to an external website (product pages, blog posts, shops). Skipped pins are not charged.

## `linkDomains` (type: `array`):

Keep only pins whose outbound link is on one of these domains (subdomains included), e.g. etsy.com, amazon.com, yourshop.com. Useful to find pins that send traffic to a given site. Skipped pins are not charged.

## `dedupeImages` (type: `boolean`):

Pins are always de-duplicated by pin id. Turn this on to also drop different pins that reuse exactly the same image.

## `includeSourceSummary` (type: `boolean`):

For each board or profile URL, also output one extra row (type "board" or "profile") with name, followers, pin count and website. Charged as one result.

## `requestDelayMs` (type: `integer`):

Minimum pause between two Pinterest requests. Lower is faster but more likely to be rate limited.

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

Proxy used for Pinterest requests. Apify Proxy (datacenter) is enough for most runs; switch the group to RESIDENTIAL if you are rate limited on very large runs.

## Actor input object example

```json
{
  "searchQueries": [
    "minimalist living room"
  ],
  "startUrls": [],
  "maxItems": 50,
  "maxItemsPerSource": 100,
  "expandKeywords": 0,
  "relatedPinsPerPin": 0,
  "onlyPinsWithLink": false,
  "linkDomains": [],
  "dedupeImages": false,
  "includeSourceSummary": false,
  "requestDelayMs": 400,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

All scraped pins in the default dataset.

# 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 = {
    "searchQueries": [
        "minimalist living room"
    ],
    "startUrls": [],
    "linkDomains": [],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexuscortex/pinterest-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 = {
    "searchQueries": ["minimalist living room"],
    "startUrls": [],
    "linkDomains": [],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("nexuscortex/pinterest-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 '{
  "searchQueries": [
    "minimalist living room"
  ],
  "startUrls": [],
  "linkDomains": [],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call nexuscortex/pinterest-scraper --silent --output-dataset

```

## MCP server setup

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