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

Scrape Pinterest search results, boards, profiles and single pins: image URLs, titles, descriptions, outbound links and domains, saves, reactions, pinner and board, plus profile followers, monthly views and website. No login, no browser. Pay per result.

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

## Pricing

$2.00 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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 & Search

Scrape **Pinterest** without logging in: **search results, boards, user profiles and single pins**. Every pin comes with its **full-size image URL, title, description, alt text, outbound link and domain, save count, reactions, comment count, creation date, video URL, pinner and board** — and profile rows include **followers, following, monthly views, pin and board counts, website and bio**.

The actor uses the same JSON resources as pinterest.com itself, so it doesn't need a browser.

### Features

- **All entry points:** keywords, profile URLs, board URLs, pin URLs or plain usernames.
- **Outbound links & saves** for every pin (`scrapePinDetails`) — the data you need for e-commerce and content research.
- **Profile analytics:** followers and monthly views for influencer and brand research.
- **Deduplicated** across sources; full-resolution `originals` images.
- **Pay per result:** $2 per 1,000 pins or profiles.

### Use cases

- **E-commerce & dropshipping research:** which products and shops get saved most for a keyword (`link`, `domain`, `saves`).
- **Content & trend research** for marketers and designers.
- **Influencer discovery:** profiles with followers, monthly views and website.
- **Competitor monitoring:** a brand's latest pins and boards.
- **Image datasets** with titles, descriptions and alt texts.

### Input

```json
{
  "searchQueries": ["modern kitchen", "wedding cake"],
  "startUrls": [
    "https://www.pinterest.com/marthastewart/",
    "https://www.pinterest.com/marthastewart/letscelebrate-pin-party/",
    "https://www.pinterest.com/pin/18999629667015418/"
  ],
  "maxPinsPerSource": 200,
  "scrapePinDetails": true,
  "includeProfiles": true
}
```

### Output — pin (`type: "pin"`)

#### Real output (default input)

First 2 of 41 records from a run with the prefilled input (7.0 s on a test machine; long values shortened here):

```json
[
  {
    "type": "profile",
    "username": "marthastewart",
    "url": "https://www.pinterest.com/marthastewart/",
    "fullName": "Martha Stewart",
    "about": "Daily recipes, crafts, and inspiration from Martha Stewart.",
    "websiteUrl": "http://marthastewart.com",
    "domainVerified": true,
    "followers": 1868070,
    "following": 322,
    "pinCount": 105545,
    "boardCount": 174,
    "monthlyViews": 10000001,
    "isVerifiedMerchant": false,
    "country": null,
    "avatar": "https://i.pinimg.com/280x280_RS/c8/11/4c/c8114c783347e27daef00e5d4a6ac4f3.jpg",
    "userId": "32088353503445352",
    "source": "https://www.pinterest.com/marthastewart/",
    "scrapedAt": "2026-10-15T12:13:47.466Z"
  },
  {
    "type": "pin",
    "pinId": "47921183531617924",
    "url": "https://www.pinterest.com/pin/47921183531617924/",
    "title": null,
    "description": null,
    "altText": "an image of a kitchen setting with two stools in front of the counter top",
    "link": null,
    "domain": null,
    "image": "https://i.pinimg.com/originals/a0/73/b8/a073b811a0c08c39abf7c6770b85b458.png",
    "imageWidth": 1125,
    "imageHeight": 1704,
    "dominantColor": "#7f705a",
    "isVideo": false,
    "videoUrl": null,
    "saves": 2115,
    "reactions": 90,
    "commentCount": 0,
    "createdAt": "2026-09-20T17:45:51.000Z",
    "isPromoted": false,
    "pinnerUsername": "beaudry0287",
    "pinnerName": "Ghyslain Beaudry",
    "pinnerFollowers": 12,
    "boardName": "NOVAVI",
    "boardUrl": "https://www.pinterest.com/beaudry0287/novavi/",
    "source": "modern kitchen",
    "scrapedAt": "2026-10-15T12:13:48.238Z"
  }
]
```

```json
{
  "type": "pin",
  "pinId": "18999629667015418",
  "url": "https://www.pinterest.com/pin/18999629667015418/",
  "title": "This is Exactly How to Host an Easy Dinner Party in 6 steps",
  "description": null,
  "altText": "a dinner table set with plates and candles",
  "link": "https://celebrationsathomeblog.com/host-a-laid-back-dinner-party-with-6-easy-steps/",
  "domain": "celebrationsathomeblog.com",
  "image": "https://i.pinimg.com/originals/…jpg",
  "imageWidth": 1000,
  "imageHeight": 1500,
  "dominantColor": "#7f705a",
  "isVideo": false,
  "videoUrl": null,
  "saves": 2201,
  "reactions": 76,
  "commentCount": 0,
  "createdAt": "2021-04-17T18:48:36.000Z",
  "isPromoted": false,
  "pinnerUsername": "marthastewart",
  "pinnerName": "Martha Stewart",
  "pinnerFollowers": 1868076,
  "boardName": "#LetsCelebrate Pin Party",
  "boardUrl": "https://www.pinterest.com/marthastewart/letscelebrate-pin-party/",
  "source": "https://www.pinterest.com/marthastewart/letscelebrate-pin-party/"
}
```

### Output — profile (`type: "profile"`)

```json
{
  "type": "profile",
  "username": "marthastewart",
  "url": "https://www.pinterest.com/marthastewart/",
  "fullName": "Martha Stewart",
  "about": "Daily recipes, crafts, and inspiration from Martha Stewart.",
  "websiteUrl": "http://marthastewart.com",
  "domainVerified": true,
  "followers": 1868076,
  "following": 322,
  "pinCount": 105532,
  "boardCount": 174,
  "monthlyViews": 10000001
}
```

Use the **Pins** and **Profiles** dataset views to export each type.

### Use with AI agents (MCP), LangChain, RAG & the API

This actor is a ready-made **tool for AI agents**: an LLM can call it, wait for the run and read clean JSON back.

**MCP server (Claude Desktop, Claude Code, Cursor, VS Code, any MCP client)** — add Apify's hosted MCP server with this actor enabled as a tool:

```json
{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=murch1k/pinterest-scraper",
      "headers": { "Authorization": "Bearer <APIFY_TOKEN>" }
    }
  }
}
```

**LangChain / LangGraph** (`pip install langchain-apify`, set `APIFY_API_TOKEN`):

```python
import json
from langchain_apify import ApifyActorsTool, ApifyWrapper
from langchain_core.documents import Document

## 1) give the actor to an agent as a tool
tool = ApifyActorsTool("murch1k/pinterest-scraper")

## 2) or load results as Documents for a RAG index
loader = ApifyWrapper().call_actor(
    actor_id="murch1k/pinterest-scraper",
    run_input={"searchQueries": ["modern kitchen", "wedding cake"], "startUrls": ["https://www.pinterest.com/marthastewart/", "https://www.pinterest.com/marthastewart/letscelebrate-pin-party/", "https://www.pinterest.com/pin/18999629667015418/"], "maxPinsPerSource": 200, "scrapePinDetails": True, "includeProfiles": True},
    dataset_mapping_function=lambda item: Document(page_content=json.dumps(item, ensure_ascii=False), metadata={"url": item.get("url")}),
)
docs = loader.load()
```

**REST API — one synchronous call, dataset items in the response:**

```bash
curl -X POST "https://api.apify.com/v2/acts/murch1k~pinterest-scraper/run-sync-get-dataset-items?token=<APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries": ["modern kitchen", "wedding cake"], "startUrls": ["https://www.pinterest.com/marthastewart/", "https://www.pinterest.com/marthastewart/letscelebrate-pin-party/", "https://www.pinterest.com/pin/18999629667015418/"], "maxPinsPerSource": 200, "scrapePinDetails": true, "includeProfiles": true}'
```

Also works with the Apify Python/JS clients, **Make, Zapier, n8n**, Google Sheets, webhooks and schedules. Export as JSON, CSV, Excel, XML or RSS.

**RAG tip:** Use `title`, `description` and outbound `link` of pins to let an agent map trending products and content ideas for a niche.

### Pricing

- **$2.00 per 1,000 results** ($0.002 per result).
- The prefilled input returns 41 results → **$0.082**.
- Example: 1,000 results → $2.00; 10,000 → $20.00. Set **Max results (cost cap)** to limit any run.

### Limitations

- Only public pins, boards and profiles are collected. Private boards and secret pins are not accessible.
- Pinterest reports monthly views above 10M as "10M+".

### FAQ

**Do I need a Pinterest login?**
No. Only public pins, boards and profiles are collected.

**Can I get the outbound link of each pin?**
Yes. Turn on `scrapePinDetails` for outbound links and save counts.

**Does it download full-size images?**
It returns the full-resolution `originals` image URL for every pin.

# Actor input Schema

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

Keywords as typed into Pinterest search (pins).

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

Profile (<code>pinterest.com/marthastewart/</code>), board (<code>pinterest.com/user/board-name/</code>), pin (<code>pinterest.com/pin/123…/</code>) or search URLs. Usernames work too.

## `maxPinsPerSource` (type: `integer`):

Per search query, profile or board.

## `scrapePinDetails` (type: `boolean`):

Open each pin for its outbound link, save count and comment count (one extra fast request per pin).

## `includeProfiles` (type: `boolean`):

For profile URLs, also output one row with followers, monthly views, website and bio (<code>type: "profile"</code>).

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

Stop after this many rows in total. <code>0</code> = no limit.

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

Pin detail requests in parallel.

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

Requests go direct first; if Pinterest throttles, retries switch to these proxies.

## Actor input object example

```json
{
  "searchQueries": [
    "modern kitchen"
  ],
  "startUrls": [
    "https://www.pinterest.com/marthastewart/"
  ],
  "maxPinsPerSource": 20,
  "scrapePinDetails": true,
  "includeProfiles": true,
  "maxResults": 0,
  "maxConcurrency": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `pins` (type: `string`):

No description

## `profiles` (type: `string`):

No description

## `runStats` (type: `string`):

No description

# 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": [
        "modern kitchen"
    ],
    "startUrls": [
        "https://www.pinterest.com/marthastewart/"
    ],
    "maxPinsPerSource": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("torix33/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": ["modern kitchen"],
    "startUrls": ["https://www.pinterest.com/marthastewart/"],
    "maxPinsPerSource": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

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

```

## MCP server setup

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