# Pinterest Scraper (`muhammad_noman_riaz/pinterest-scraper`) Actor

Scrape Pinterest pins, boards and profiles without login: titles, links, full-size images, video URLs, saves, board and pinner details, plus profile stats. Pay only for results.

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

## Pricing

from $2.99 / 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

### What does Pinterest Scraper do?

Pinterest Scraper extracts public data from Pinterest without a login or account cookies. Give it search keywords, pin URLs, board URLs or profile URLs, and it returns one clean item per pin with the title, description, alt text, outbound link and domain, the full-size image plus 736x and 474x versions, the video URL for video pins, the creation date, save, repin, reaction and comment counts where Pinterest shows them, the dominant color, the board and the pinner. For profile URLs it also returns one profile item with the follower, following, pin and board counts, monthly views, bio, website and verified flags. It reads the same JSON that Pinterest's own website loads for logged-out visitors, so runs are light and fast, and pins found by two inputs in one run are returned and charged once. Use it for trend research, mood boards, competitor and creator analysis, ecommerce product discovery and image datasets.

### Input

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `searchQueries` | array of strings | none | Keywords to search pins for, such as `minimalist living room`. |
| `startUrls` | array of URLs | none | Pin URLs (`https://www.pinterest.com/pin/123/`), board URLs (`https://www.pinterest.com/user/board/`), profile URLs (`https://www.pinterest.com/user/`) or `pin.it` short links. Only https `pinterest.com`, `www.pinterest.com` and country subdomains such as `de.pinterest.com` are accepted. |
| `maxItemsPerInput` | integer | 50 | Maximum pins per search query, board or profile. The profile item is not counted. |
| `includeProfilePins` | boolean | true | For profile URLs, also return the profile's recent pins. |
| `maxConcurrency` | integer | 10 | Inputs processed at the same time. |
| `maxRequestRetries` | integer | 6 | Attempts per request, each on a new proxy IP, before the input is skipped and not charged. |
| `proxy` | object | Apify Residential | Proxy settings. Residential proxies are recommended. |

Example input:

```json
{
  "searchQueries": ["minimalist living room"],
  "startUrls": [
    { "url": "https://www.pinterest.com/pin/424605071145708386/" },
    { "url": "https://www.pinterest.com/pinterest/media-mindfulness/" },
    { "url": "https://www.pinterest.com/pinterest/" }
  ],
  "maxItemsPerInput": 60,
  "includeProfilePins": true,
  "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}
```

### Output

Every item has a `type` field: `pin` or `profile`. Pins carry `searchQuery` or `sourceUrl` so you can tell which input found them. These examples come from a real test run.

A pin from a board:

```json
{
  "type": "pin",
  "pinId": "e1_AfqPShzRTQYMeNlfZn-Cgj0Ouq7LHKJyTXXVCFzfXvdKaz1RLHHf",
  "url": "https://www.pinterest.com/pin/e1_AfqPShzRTQYMeNlfZn-Cgj0Ouq7LHKJyTXXVCFzfXvdKaz1RLHHf/",
  "title": "How Can Educators Better Support Trans Students?",
  "description": "Peer-led allyship is all-too-often a response to school-level inaction. Educators have enormous power to uphold the rights of gender-expansive students. That is a sacred trust that we hold.",
  "altText": "a pink and blue poster with an image of a tiger on it's back",
  "link": "https://www.nextgenmen.ca/blog/how-can-educators-support-transgender-students",
  "domain": "nextgenmen.ca",
  "imageUrl": "https://i.pinimg.com/originals/c0/e5/42/c0e5426400534f88192a41d8de6e9c8f.webp",
  "images": {
    "orig": "https://i.pinimg.com/originals/c0/e5/42/c0e5426400534f88192a41d8de6e9c8f.webp",
    "736x": "https://i.pinimg.com/736x/c0/e5/42/c0e5426400534f88192a41d8de6e9c8f.jpg",
    "474x": "https://i.pinimg.com/474x/c0/e5/42/c0e5426400534f88192a41d8de6e9c8f.jpg"
  },
  "isVideo": false,
  "videoUrl": null,
  "createdAt": null,
  "saveCount": 8,
  "repinCount": 2,
  "reactionCount": 1,
  "commentCount": null,
  "dominantColor": "#b8c2f4",
  "board": {
    "id": "424605139808070499",
    "name": "(Me)dia Mindfulness",
    "url": "https://www.pinterest.com/pinterest/media-mindfulness/"
  },
  "pinner": {
    "id": "424605208526455283",
    "username": "pinterest",
    "fullName": "Pinterest",
    "followerCount": null
  },
  "hashtags": [],
  "sourceUrl": "https://www.pinterest.com/pinterest/media-mindfulness/",
  "scrapedAt": "2026-10-20T08:12:33.064Z"
}
```

A video pin from a pin URL:

```json
{
  "type": "pin",
  "pinId": "424605071145708386",
  "url": "https://www.pinterest.com/pin/424605071145708386/",
  "title": "test pin",
  "description": null,
  "altText": null,
  "link": "http://pinterest.com/",
  "domain": "pinterest.com",
  "imageUrl": "https://i.pinimg.com/originals/e7/a2/45/e7a24502f763ecbc839213320cd50db6.jpg",
  "images": {
    "orig": "https://i.pinimg.com/originals/e7/a2/45/e7a24502f763ecbc839213320cd50db6.jpg",
    "736x": "https://i.pinimg.com/736x/e7/a2/45/e7a24502f763ecbc839213320cd50db6.jpg",
    "474x": "https://i.pinimg.com/474x/e7/a2/45/e7a24502f763ecbc839213320cd50db6.jpg"
  },
  "isVideo": true,
  "videoUrl": "https://v1.pinimg.com/videos/iht/720p/9f/29/0b/9f290bf19517159217cc91fa258438f6.mp4",
  "createdAt": "2026-08-18T07:54:45.000Z",
  "saveCount": null,
  "repinCount": 0,
  "reactionCount": null,
  "commentCount": 0,
  "dominantColor": "#7a5e54",
  "board": {
    "id": "424605139808070499",
    "name": "(Me)dia Mindfulness",
    "url": "https://www.pinterest.com/pinterest/media-mindfulness/"
  },
  "pinner": {
    "id": "424605208526455283",
    "username": "pinterest",
    "fullName": "Pinterest",
    "followerCount": 6266591
  },
  "hashtags": [],
  "sourceUrl": "https://www.pinterest.com/pin/424605071145708386/",
  "scrapedAt": "2026-10-20T08:12:22.259Z"
}
```

A profile:

```json
{
  "type": "profile",
  "id": "424605208526455283",
  "username": "pinterest",
  "fullName": "Pinterest",
  "about": "Find your reason to go offline. 📌",
  "websiteUrl": "http://www.pinterest.com",
  "followerCount": 6266590,
  "followingCount": 397,
  "pinCount": 97760,
  "boardCount": 150,
  "monthlyViews": 10000001,
  "imageUrl": "https://i.pinimg.com/280x280_RS/1c/b5/61/1cb561c8e7b9c709f78d110a4b5f0863.jpg",
  "verified": true,
  "isVerifiedMerchant": false,
  "isWebsiteVerified": true,
  "createdAt": "2012-08-16T06:25:03.000Z",
  "url": "https://www.pinterest.com/pinterest/",
  "sourceUrl": "https://www.pinterest.com/pinterest/",
  "scrapedAt": "2026-10-20T08:12:43.756Z"
}
```

### Pricing

Pinterest Scraper costs **$2.99 per 1,000 results**.

- Pins and profiles each count as one result.
- Failed inputs are not charged. They are listed in `FAILED_ITEMS` in the run's key-value store with the reason.
- A pin found by two inputs in the same run is returned and charged once.

### FAQ

#### Do I need a Pinterest account?

No. The scraper never logs in and never uses account cookies. It reads the public data Pinterest serves to any logged-out visitor. It does not solve captchas or get around login walls, so anything Pinterest only shows to signed-in users is not returned.

#### How many pins can I get from a search?

Up to `maxItemsPerInput` per query. Results are loaded 25 pins at a time until your limit is reached or Pinterest stops serving more. Pinterest limits what logged-out visitors see, and from some IP addresses and countries it returns no search results at all. A search that returns nothing is retried on a new proxy IP, and if it still returns nothing it is listed in `FAILED_ITEMS` and not charged.

#### Can I download images and videos?

Yes. Every pin has `imageUrl` (the largest version, usually the original upload) and `images` with the original, 736x and 474x links. Video pins have `videoUrl`, the widest MP4 when there is one, otherwise an HLS (`.m3u8`) playlist. The actor returns links only; download the files with any tool you like.

#### Why are some counts missing?

Pinterest sends different fields on different pages. Board pins include saves and repins but no creation date. Profile pins include the creation date and reactions but no saves. Pin URLs return the most complete data, including comments. A field Pinterest did not send is `null` instead of a guessed zero.

### Known limits

- Search depends on Pinterest showing results to logged-out visitors. In our own test from a home connection Pinterest returned an empty search, so searches may fail on some IPs. Residential proxies give the best chance.
- Board pins come back with Pinterest's obfuscated pin ids (starting with `e1_`) for logged-out visitors, so a pin seen on a board and again in a profile or as a pin URL can appear twice.
- Logged-out board feeds may end before the board's full pin count. In testing, a board with 530 pins returned 50.
- Profile pins are the profile's recent activity, not every board.
- `monthlyViews` is capped by Pinterest; 10000001 means more than 10 million.
- Board section URLs, private boards and secret boards are not supported.

# Actor input Schema

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

Keywords to search pins for, one per item, such as "minimalist living room". Each query returns up to Max items per input pins.

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

Pin URLs (https://www.pinterest.com/pin/123/), board URLs (https://www.pinterest.com/user/board/), profile URLs (https://www.pinterest.com/user/) or pin.it short links. www, pinterest.com and country subdomains such as de.pinterest.com are accepted.

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

Maximum number of pins to return for each search query, board or profile. A profile item itself is not counted toward this limit.

## `includeProfilePins` (type: `boolean`):

For profile URLs, also return the profile's recent pins, not only the profile item.

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

Maximum number of inputs processed at the same time.

## `maxRequestRetries` (type: `integer`):

How many times a request is tried, each time on a new proxy IP, before the input is skipped and not charged.

## `proxy` (type: `object`):

US residential proxies are recommended. Pinterest returns empty search results to IPs it flags, which includes many datacenter and some non-US networks.

## Actor input object example

```json
{
  "searchQueries": [
    "minimalist living room"
  ],
  "startUrls": [
    {
      "url": "https://www.pinterest.com/pinterest/"
    }
  ],
  "maxItemsPerInput": 50,
  "includeProfilePins": true,
  "maxConcurrency": 10,
  "maxRequestRetries": 6,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

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

One item per pin (type pin) and one per scraped profile (type profile)

# 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": [
        {
            "url": "https://www.pinterest.com/pinterest/"
        }
    ],
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("muhammad_noman_riaz/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": [{ "url": "https://www.pinterest.com/pinterest/" }],
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("muhammad_noman_riaz/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": [
    {
      "url": "https://www.pinterest.com/pinterest/"
    }
  ],
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call muhammad_noman_riaz/pinterest-scraper --silent --output-dataset

```

## MCP server setup

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