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

Scrape Pinterest pins, video pins, boards and profiles by keyword or link, no login: real pin links, saves, outbound links, product prices, monthly views, keyword suggestions. Free date, saves and domain filters, only-new-pins monitoring. For e-commerce, SEO and social media marketing.

- **URL**: https://apify.com/panix/pinterest-scraper.md
- **Developed by:** [PANIX AI LAB](https://apify.com/panix) (community)
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 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 Scraper: pins, boards, profiles and search

Find what works on Pinterest for any keyword, board or profile. Get pins with saves, reactions, outbound links, product prices and creator stats as clean rows for content research, trend spotting or competitor tracking.

- **Engagement on every pin**: saves, reactions, comments and shares, plus the outbound link and its domain.
- **Shopping pins and profiles**: product name, price and stock, and profile followers with monthly views.
- **No Pinterest account, cookies or API key.** Scheduled monitoring returns only pins you haven't received yet.

**Try it now:** the input is already filled in (pins for "minimalist kitchen", 20 pins). Click **Start** and the results appear in a table you can export to Excel, CSV or JSON. That example run costs a few cents, which the $5 of free monthly credit on Apify's free plan covers.

**Price:** from **$1.20 per 1,000 pins**, and you pay only for results you get. The full price table is in the Pricing section below.

### Example result

One result, shortened. Every field is described in the Output section below.

```json
{
  "type": "pin",
  "id": "778770960602814445",
  "pinUrl": "https://www.pinterest.com/pin/778770960602814445/",
  "title": "21 Minimalist Living Room Decor Ideas You’ll Want to Try Immediately",
  "link": "https://www.vivandtimhome.com/minimalist-living-room/",
  "domain": "vivandtimhome.com",
  "createdAt": "2024-11-13T03:00:06Z",
  "saves": 142,
  "reactions": 234,
  "imageUrl": "https://i.pinimg.com/originals/7b/5a/34/7b5a3465d0ec30e8dd1f3d49e0dfe66a.jpg",
  "creatorUsername": "vivandtimhome",
  "creatorFollowers": 29650,
  "boardName": "Living Room Decor",
  "query": "home decor"
}
```

### What you get

Scrape Pinterest pins, video pins, boards and profiles by **keyword** or from **any Pinterest link** into clean rows: title, description, image in full size, outbound link and domain, pin date, saves, reactions, comments, shares, video stream and length, **product name, price and stock** for shopping pins, Pinterest's own topic labels, hashtags, creator and board. Profile rows add followers, **monthly views**, website and pin and board counts. It reads Pinterest the way a logged-out visitor does, so you need **no Pinterest account, no cookies and no API key**.

You pay only for what you get. Pins left out by your filters, duplicates, pins already delivered in earlier monitoring runs, and links that point to nothing are free.

### What it does

1. Searches Pinterest for your keywords (pins, video pins, boards or profiles), page by page, hundreds of pins deep.
2. Opens the pin, board, profile and search links you paste. Boards return the board plus its pins; profiles return the profile plus its created pins, saved pins or boards.
3. Finds the **real pin link and save count** for pins Pinterest hides behind an encoded ID (see below).
4. Applies your filters: date, saves, reactions, creator followers, video or image, outbound link, destination domain, products only, no ads.
5. Delivers one row per pin, board, profile or keyword suggestion to the dataset (JSON, CSV, Excel, Google Sheets, API), with a status line per input and a run summary.
6. With *Only pins not delivered before* on, scheduled runs return just the new pins.

### Who uses it

- **E-commerce and Etsy/Shopify sellers**: find the pins that send traffic to your shop or a competitor's (filter by destination domain), with product prices and save counts.
- **Social media and content marketers**: see which pins, boards and formats get saved for a keyword, plan pin titles with Pinterest's own keyword suggestions, and track a competitor's new pins every week.
- **SEO and keyword research**: Pinterest autocomplete suggestions, topic labels and related topics for any phrase.
- **Influencer and creator research**: search profiles by topic, then compare followers, monthly views, pin counts and last activity.
- **Trend and product research**: what is pinned for "fall outfits" or "kitchen ideas" this month, with dates, saves and the shops behind the pins.
- **Designers and moodboards**: full-size images, dominant colors and boards for a style.
- **Data and AI teams**: image URLs, titles, descriptions, alt text and topic labels as training or RAG data, from the API or the Apify MCP server.

### Why this Pinterest scraper

- **Working pin links for search and board pins.** Logged out, Pinterest gives search and board pins an encoded ID (`e1_...`). Pin links built from it open an empty page, and those pins come without a save count. This Actor looks each pin up in its board's and creator's public pin list and adds the real pin link and save count. In our tests it found them for about two out of three search pins (51-72% across five everyday keywords, less for shop-heavy searches such as jewelry) and for 90-100% of board pins; profile pins always have them. Pins it can't match keep `pinUrl` empty and are still delivered, never dropped.
- **Pins, video pins, boards, profiles and keyword suggestions in one Actor.** One keyword list, one setting for what to search, plus any mix of pin, board, profile and search links. Any country domain and `pin.it` short links work.
- **Shopping data.** Product name, price, currency, stock and rich-pin type on shopping pins, and a *products only* filter.
- **Profile analytics.** Followers, following, monthly views, monthly reach, pin, board, video and idea pin counts, website and its verification, verified-merchant flag, account age, last save.
- **Filters you don't pay for.** Pinned after / before (date or "30 days"), minimum saves, reactions and creator followers, video or image only, only pins with an outbound link, only pins linking to chosen domains (e.g. `etsy.com`), products only, no promoted pins. Filtered pins are free.
- **Monitoring built in.** *Only pins not delivered before* remembers what each keyword, board or profile delivered and returns only new pins on scheduled runs.
- **Fast and cheap.** Plain HTTP on Apify datacenter proxies, no browser, 512 MB. That keeps the price per pin low.
- **Clear runs.** Each row says which keyword or link produced it and its rank in the search. `INPUTS` shows pages read, pins seen, links found and why each input stopped; `SUMMARY` shows what each filter left out. Missing pins, boards and profiles come back as free error rows.

### Coming from another Pinterest scraper?

| Common problem in this category | How this Actor handles it |
|---|---|
| Search pins come with broken `e1_` links and no save count | Real pin link and saves looked up for you, at no extra cost |
| Separate scrapers for search, boards, profiles and keywords | All in one run and one dataset (`type` tells rows apart) |
| Profile pins come back as bare URLs | Full pin rows with numeric IDs, saves, comments, topics and dates |
| Paying for pins you filter out afterwards | Filters run before charging: filtered pins are free |
| Fixed per-query fees charged up front | No per-query fee: you pay per delivered pin, board or profile |
| Scheduled runs return the same pins again | *Only pins not delivered before* returns only new ones |
| Expensive residential proxies built into the price | Datacenter proxies work for Pinterest, so the price stays low |
| A wrong link fails the run | Bad links are skipped with a warning; missing pins get a free error row |

### How to use it

1. Type **Search keywords** (for example `minimalist kitchen`) and choose **Search for**: pins, video pins, boards or profiles. Or paste **Pinterest links**: pins, boards, profiles, search pages, `pin.it` links.
2. Set **Results per keyword or link** and, if you want, filters.
3. For profile links, choose what to get: created pins, saved pins, boards or just the profile.
4. Click **Start**, then download the dataset or connect it to Google Sheets, Make, n8n, Zapier or your code.

For weekly monitoring: add your keywords, boards or competitor profiles, turn on **Only pins not delivered before**, give it a **Memory name**, and create a schedule (Schedules -> Create new).

### Input examples

Pins for two keywords, 200 each:

```json
{ "searchQueries": ["minimalist kitchen", "fall outfits"], "maxItemsPerInput": 200 }
```

Video pins only:

```json
{ "searchQueries": ["easy dinner recipes"], "searchType": "videos", "maxItemsPerInput": 100 }
```

Pins that send traffic to Etsy, saved at least 50 times, pinned in the last 6 months:

```json
{
  "searchQueries": ["boho earrings"],
  "linkDomains": ["etsy.com"],
  "minSaves": 50,
  "createdAfter": "6 months",
  "maxItemsPerInput": 100
}
```

Creators for a topic (profile rows with followers):

```json
{ "searchQueries": ["vegan recipes"], "searchType": "profiles", "maxItemsPerInput": 50, "minCreatorFollowers": 10000 }
```

A board, a profile's newest pins and one pin:

```json
{
  "startUrls": [
    "https://www.pinterest.com/marthastewart/appetizers-and-hors-doeuvres-recipes/",
    "https://www.pinterest.com/ikea/",
    "https://www.pinterest.com/pin/656962664433257016/"
  ],
  "maxItemsPerInput": 100
}
```

A competitor's boards, or only their profile stats:

```json
{ "startUrls": ["https://www.pinterest.com/tulipshades/"], "profileContent": "boards" }
```

Keyword ideas for pin titles (Pinterest autocomplete):

```json
{ "searchQueries": ["wedding cake", "small bathroom"], "includeKeywordSuggestions": true, "maxItemsPerInput": 10 }
```

Weekly tracker that returns only new pins:

```json
{
  "startUrls": ["https://www.pinterest.com/tulipshades/"],
  "searchQueries": ["ceiling light shade"],
  "onlyNewPins": true,
  "monitorName": "competitors",
  "maxItemsPerInput": 100
}
```

### Output

A pin row (search result, real link found):

```json
{
  "type": "pin",
  "id": "778770960602814445",
  "pinUrl": "https://www.pinterest.com/pin/778770960602814445/",
  "title": "21 Minimalist Living Room Decor Ideas You’ll Want to Try Immediately",
  "description": "Looking for minimalist living room decor ideas? Here are 21 simple ideas for an aesthetic living room design that you'll love! These minimalist apartment ideas are perfect for my small living room to create a cozy yet functional space. Love this modern living room inspiration!",
  "link": "https://www.vivandtimhome.com/minimalist-living-room/",
  "domain": "vivandtimhome.com",
  "createdAt": "2024-11-13T03:00:06Z",
  "saves": 142,
  "reactions": 234,
  "comments": null,
  "shares": null,
  "imageUrl": "https://i.pinimg.com/originals/7b/5a/34/7b5a3465d0ec30e8dd1f3d49e0dfe66a.jpg",
  "isVideo": false,
  "videoUrl": null,
  "videoDurationSec": null,
  "isProduct": false,
  "price": null,
  "currency": null,
  "productName": null,
  "creatorUsername": "vivandtimhome",
  "creatorName": "Viv and Tim Home | Interior Design | Home Decor",
  "creatorFollowers": 29650,
  "boardName": "Living Room Decor",
  "boardUrl": "https://www.pinterest.com/vivandtimhome/living-room-decor/",
  "position": 16,
  "source": "search",
  "query": "home decor",
  "input": "home decor",
  "encodedId": "e1_AfqPShwt4UbMrsA7DAbSybPiG5gAkt3Fc7b7YifiqRC4_b4NTKUL",
  "altText": "Minimalist living room decor",
  "imageWidth": 736,
  "imageHeight": 1104,
  "thumbnailUrl": "https://i.pinimg.com/236x/7b/5a/34/7b5a3465d0ec30e8dd1f3d49e0dfe66a.jpg",
  "dominantColor": "#b8b0a0",
  "videoThumbnailUrl": null,
  "topics": [
    "Home Image",
    "Clean House Ideas",
    "Living Room Simple Design",
    "Minimal Design Home",
    "..."
  ],
  "interestTags": [],
  "hashtags": [],
  "isPromoted": false,
  "priceText": null,
  "inStock": null,
  "richPinType": "article",
  "creatorUrl": "https://www.pinterest.com/vivandtimhome/",
  "creatorIsVerifiedMerchant": false,
  "boardId": "778771029254664221",
  "imageSignature": "7b5a3465d0ec30e8dd1f3d49e0dfe66a",
  "scrapedAt": "2026-11-07T22:17:07Z",
  "schemaVersion": 1
}
```

A profile row:

```json
{
  "type": "profile",
  "id": "1151795810858610367",
  "username": "tulipshades",
  "name": "Tulip Shades",
  "url": "https://www.pinterest.com/tulipshades/",
  "about": "Adaptable, design-forward ceiling light shades that elevate your space in minutes...",
  "followers": 343,
  "following": 10,
  "monthlyViews": 1647557,
  "monthlyReach": 662366,
  "pinCount": 1213,
  "boardCount": 22,
  "videoPinCount": 0,
  "ideaPinCount": 183,
  "website": "http://tulipshades.com",
  "websiteVerified": true,
  "isVerifiedMerchant": true,
  "isBusiness": true,
  "instagramUrl": "https://www.instagram.com/tulipshades",
  "createdAt": "2023-09-24T10:26:47Z",
  "lastPinSavedAt": "2026-11-05T15:33:14Z",
  "avatarUrl": "https://i.pinimg.com/280x280_RS/0f/74/05/0f74051bf65c498401a69a7bb63ab38b.jpg",
  "source": "profile",
  "input": "https://www.pinterest.com/tulipshades/"
}
```

A board row:

```json
{
  "type": "board",
  "id": "1151795742140937408",
  "name": "Renter Friendly Upgrades",
  "url": "https://www.pinterest.com/tulipshades/renter-friendly-upgrades/",
  "description": "Transform your space without losing your deposit! Discover rental friendly decor...",
  "pinCount": 53,
  "followers": 340,
  "sectionCount": 0,
  "isCollaborative": false,
  "lastPinnedAt": "2026-11-03T14:04:12Z",
  "coverImageUrl": "https://i.pinimg.com/236x/a2/c5/52/a2c552de0164e56211345b517c565751.jpg",
  "relatedTopics": ["Apartment Decorating On A Budget", "Cover Ugly Light Fixture", "Renter Friendly", "..."],
  "ownerUsername": "tulipshades",
  "ownerName": "Tulip Shades",
  "source": "board"
}
```

A keyword suggestion row:

```json
{ "type": "suggestion", "rank": 1, "suggestion": "minimalist kitchen design", "suggestionType": "keyword",
  "searchUrl": "https://www.pinterest.com/search/pins/?q=minimalist+kitchen+design&rs=ac", "query": "minimalist kitchen" }
```

#### Main fields

| Field | What it is |
|---|---|
| `id`, `pinUrl` | Numeric pin ID and working pin link (empty when Pinterest hides the real ID and the lookup found no match) |
| `encodedId` | Pinterest's logged-out ID for search and board pins (`e1_...`) |
| `title`, `description`, `altText` | Pin text and Pinterest's image description |
| `link`, `domain` | Where the pin leads (the outbound link) and its domain |
| `createdAt` | When the pin was created |
| `saves`, `reactions`, `comments`, `shares` | Engagement counts (`shares` and exact comments with *Full pin details*) |
| `imageUrl`, `thumbnailUrl`, `imageWidth`, `imageHeight`, `dominantColor` | Full-size image, 236 px thumbnail, size and main color |
| `isVideo`, `videoUrl`, `videoDurationSec`, `videoThumbnailUrl` | Video pins: HLS stream (`.m3u8`, download with ffmpeg), length, cover |
| `isProduct`, `productName`, `price`, `currency`, `priceText`, `inStock`, `richPinType` | Shopping data for product pins |
| `topics`, `interestTags`, `hashtags` | Pinterest's topic labels for the image, the creator's interest tags, hashtags |
| `creatorUsername`, `creatorName`, `creatorFollowers`, `creatorUrl`, `creatorIsVerifiedMerchant` | Who pinned it |
| `boardName`, `boardUrl`, `boardId` | The board it is on |
| `position`, `query`, `source`, `input` | Rank in the search, the keyword, and the input that found it |
| `imageSignature` | Pinterest's image hash: the same image pinned twice has the same value |

The Output tab has views for **Pins**, **Products and links**, **Video pins**, **Text, topics and hashtags**, **Boards**, **Profiles** and **Keyword suggestions**. The key-value store has `INPUTS` (one status line per input) and `SUMMARY` (totals, pins left out per filter, pin-link rate, request statistics).

### Pricing

Pay per event, no monthly fee:

| Event | Free plan | Starter (Bronze) | Scale (Silver) | Business (Gold) and up |
|---|---|---|---|---|
| Pin (per 1,000) | $2.00 | $1.80 | $1.50 | $1.20 |
| Profile (per 1,000) | $2.00 | $1.80 | $1.50 | $1.20 |
| Board (per 1,000) | $1.00 | $0.90 | $0.75 | $0.60 |
| Keyword suggestion (per 1,000) | $0.30 | $0.25 | $0.20 | $0.15 |
| Actor start (per run, per GB of memory) | $0.001 | $0.001 | $0.001 | $0.001 |

Free: pins left out by filters, duplicates, pins already delivered in earlier *only new* runs, error rows for missing pins, boards and profiles, and failed inputs. The real-pin-link lookup and *Full pin details* cost nothing extra. With the default 512 MB a run pays one start event. Set a spending limit on the run and the Actor stops before it.

Examples on the Starter plan: 1,000 pins for a keyword cost $1.80 plus $0.001; a profile with its 200 newest pins costs $0.0018 + $0.36; 10 keywords with their suggestions (about 10 each) cost $0.025.

### Use it from code, n8n, Make, Zapier and AI agents

Python ([apify-client](https://pypi.org/project/apify-client/) 3.x):

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("panix/pinterest-scraper").call(run_input={
    "searchQueries": ["minimalist kitchen"],
    "maxItemsPerInput": 100,
})
for row in client.dataset(run.default_dataset_id).iterate_items():
    if row["type"] == "pin":
        print(row["pinUrl"], row["saves"], row["domain"], row["title"])
```

JavaScript:

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

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('panix/pinterest-scraper').call({
    startUrls: ['https://www.pinterest.com/marthastewart/'], maxItemsPerInput: 50,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.filter((r) => r.type === 'pin').map((r) => [r.createdAt, r.saves, r.title]));
```

One HTTP call that runs the Actor and returns the rows (n8n HTTP Request node, Make HTTP module, any script):

```
POST https://api.apify.com/v2/acts/panix~pinterest-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>
Content-Type: application/json

{"searchQueries": ["minimalist kitchen"], "maxItemsPerInput": 20}
```

n8n, Make and Zapier also have Apify apps: choose **Run Actor**, pick `panix/pinterest-scraper`, paste the input JSON, then read the dataset items. AI agents can call it through the Apify MCP server (`https://mcp.apify.com`).

### FAQ

**Do I need a Pinterest account or API key?** No. The Actor reads what Pinterest shows to logged-out visitors. No login, cookies or Pinterest developer approval.

**Why do some pins have an empty `pinUrl`?** Logged out, Pinterest shows search and board pins with an encoded ID that its own website can't open. The Actor finds the real pin in the board's and the creator's newest public pins. Older pins, and pins Pinterest generates from websites, are not in those lists, so their `pinUrl` stays empty. The row still has the image, text, outbound link, creator and board. `SUMMARY.pinLinkRate` shows the share found in your run.

**How many pins per keyword?** Pinterest keeps loading results; we read 20 pages (about 500 pins) for one keyword without reaching the end. Use several keywords for more.

**Can I download the images and videos?** `imageUrl` is the full-size original. `videoUrl` is Pinterest's HLS stream (`.m3u8`); `ffmpeg -i <videoUrl> -c copy pin.mp4` saves it as MP4.

**Can I get the comments' text?** Not yet. Pinterest no longer shows comment text to logged-out visitors through the pages this Actor reads. Comment counts are included.

**Does it work for other countries?** Yes. Links on any Pinterest domain work (de.pinterest.com, pinterest.co.uk, ...). Search results are Pinterest's international (US English) results.

**How does *Only pins not delivered before* work?** The Actor stores what each keyword, board or profile delivered in a named key-value store in your account (`pinterest-scraper-memory`, one record per memory name). The next run with the same memory name skips those pins for free. Pins are matched by their image, so a re-pin of the same image is not delivered twice. The board or profile row itself is delivered on every run, so you also get its follower and pin counts over time.

**Why did a board return fewer pins than its pin count?** Pinterest sometimes ends a board's list early for logged-out visitors. The Actor then adds the board's 50 newest pins from Pinterest's public widget list. Very large boards can still return fewer pins than they hold.

### Limits

- Public content only: no secret boards, private profiles, messages or account analytics.
- Board section links are not supported yet; use the board link.
- Logged-out pin IDs: see the FAQ above for when `pinUrl` stays empty.
- Comment and reply text, and "More like this" related pins, are not available logged out.
- Search results change between visits and are Pinterest's choice; sort by `position` for the rank.
- Pinterest changes its site at times. If a field stops filling, open an issue.

### Data and legal

The Actor collects pins, boards and profiles that Pinterest shows to every visitor. Creator names and usernames are public profile data; no email addresses, phone numbers or other contact data are collected. You are responsible for using the data lawfully, including Pinterest's terms, copyright in the images, and data protection laws such as the GDPR where they apply. This Actor is not affiliated with Pinterest.

### Support

Open an issue on the Actor's **Issues** tab with the run ID; it is answered quickly. Feature requests are welcome.

# Actor input Schema

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

One keyword or phrase per line, e.g. 'minimalist kitchen' or 'fall outfits'. Each keyword is searched on its own and every row says which keyword found it.

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

What a keyword search returns: pins, video pins only, boards or profiles (creators).

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

Pin links (pinterest.com/pin/123.../), boards (pinterest.com/user/board/), profiles (pinterest.com/user/, or @user), search pages (pinterest.com/search/pins/?q=...) and pin.it short links. Any country domain works (de.pinterest.com, pinterest.co.uk).

## `maxItemsPerInput` (type: `integer`):

Most pins (or boards / profiles) to deliver for each keyword, board or profile. Searches go hundreds of pins deep.

## `maxResults` (type: `integer`):

Stop the whole run after this many pins. Leave empty for no total limit.

## `profileContent` (type: `string`):

Created = pins the account published itself (newest first). Saved = everything it saved. Boards = its public boards. Profile only = just the profile row (followers, monthly views, website). Every profile link also returns one profile row.

## `resolvePinLinks` (type: `boolean`):

Pinterest hides the real pin ID of search and board pins from logged-out visitors, so their links don't open. With this on, the scraper looks each pin up in its board's and creator's public pin list to add the working pin link and the save count. Pins it can't find keep an empty pinUrl. Free; adds a little run time.

## `pinDetails` (type: `boolean`):

One extra request per pin with a known ID: adds shares, exact comment and save counts, hashtags and the creator's follower count. Slower; no extra charge.

## `includeKeywordSuggestions` (type: `boolean`):

For each search keyword, also return the related searches Pinterest suggests (autocomplete), in Pinterest's order. Handy for SEO and pin titles. Charged as keyword suggestions (cheap).

## `createdAfter` (type: `string`):

Only pins created on or after this date: 2026-01-01, or a period like '30 days', '6 months', '1 year'.

## `createdBefore` (type: `string`):

Only pins created before this date or period.

## `minSaves` (type: `integer`):

Only pins saved at least this many times. Search pins need 'Find real pin links and save counts' for a save count.

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

Only pins with at least this many reactions (likes).

## `minCreatorFollowers` (type: `integer`):

Only pins (or profiles in a profile search) whose creator has at least this many followers.

## `mediaType` (type: `string`):

Keep all pins, only video pins, or only image pins.

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

Leave out pins without an outbound link.

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

Keep pins whose outbound link is on one of these domains, e.g. etsy.com, amazon.com, yourshop.com. A word without a dot (e.g. 'etsy') matches any domain containing it.

## `onlyProducts` (type: `boolean`):

Keep only shopping pins with a product or price.

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

Drop pins Pinterest marks as promoted.

## `onlyNewPins` (type: `boolean`):

For scheduled runs: deliver (and charge for) only pins this keyword, board or profile did not deliver in earlier runs with the same memory name. The first run delivers everything and remembers it.

## `monitorName` (type: `string`):

Separate memories for different schedules (letters, digits, - and \_).

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

Apify datacenter proxy works well for Pinterest and keeps the price low. Change only if you know you need to.

## `maxConcurrency` (type: `integer`):

How many requests run at the same time. The default suits most runs.

## Actor input object example

```json
{
  "searchQueries": [
    "minimalist kitchen"
  ],
  "searchType": "pins",
  "startUrls": [],
  "maxItemsPerInput": 20,
  "profileContent": "created",
  "resolvePinLinks": true,
  "pinDetails": false,
  "includeKeywordSuggestions": false,
  "mediaType": "all",
  "onlyWithLink": false,
  "onlyProducts": false,
  "excludePromoted": false,
  "onlyNewPins": false,
  "monitorName": "default",
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "maxConcurrency": 8
}
```

# Actor output Schema

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

All delivered rows. Filter by the type column: pin, board, profile, suggestion or error. Error rows (missing pins, boards or profiles) are free.

## `inputs` (type: `string`):

Pages read, pins seen and delivered, pin links found and why each keyword or link stopped.

## `summary` (type: `string`):

Totals, charged events, pins left out per filter, pin-link rate, request statistics and warnings.

# 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 kitchen"
    ],
    "startUrls": [],
    "maxItemsPerInput": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("panix/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 kitchen"],
    "startUrls": [],
    "maxItemsPerInput": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

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

```

## MCP server setup

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