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

Scrape public Pinterest pins by keyword, board, profile or pin link: image sizes, outbound link and domain, saves, board, pinner, hashtags, ISO dates. No login, no API key.

- **URL**: https://apify.com/transparent_meteorite/pinterest-scraper.md
- **Developed by:** [Detroit Web Agent - Open Data](https://apify.com/transparent_meteorite) (community)
- **Categories:** Social media, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.41 / 1,000 pin scrapeds

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

Pinterest scraper for public pins, with no login, no cookies and no API key. Give it search keywords, board links, profile links or single pin links and get one clean row per pin: title, description, outbound link and domain, image URL and every size, dominant color, saves, repins, comments, board, pinner, hashtags and ISO dates.

One Actor covers all four ways people collect Pinterest data, so you do not need a different tool for keyword research, board exports, competitor profiles and single-pin checks. Everything it reads is information Pinterest already shows to any visitor who is not signed in.

### Run in 30 seconds

1. Open the **Input** tab. The prefilled keywords, `home office ideas` and `minimalist desk setup`, return 25 pins each.
2. Click **Start**. A default run finishes in under 10 seconds.
3. Open the **Pins** table in the Output tab, or export as JSON, CSV, Excel or XML.
4. Replace the keywords or paste your own board, profile or pin links and run again.

### What does this Pinterest scraper do?

It reads Pinterest's own public data feeds, the same ones the website uses for visitors who are not signed in, and turns them into flat rows. It pages through results automatically until it reaches your limit or runs out of pins.

| Input type | Example | What you get |
|---|---|---|
| Search keyword | `boho bedroom` | The pins Pinterest ranks for that search, in ranked order (`rank` field) |
| Board link | `pinterest.com/user/board-name/` | Every pin on that public board |
| Profile link | `pinterest.com/user/` | The pins that account created |
| Pin link | `pinterest.com/pin/123456789/` | One pin with full detail: saves, repins, comments |
| Search page link | `pinterest.com/search/pins/?q=desk` | Same as a keyword |

You can mix keywords and links in one run. Each input has its own limit, and every row records which input it came from (`sourceType`, `sourceInput`, `rank`).

### Output fields

| Group | Fields |
|---|---|
| Identity | `pinId`, `pinUrl`, `sourceType`, `sourceInput`, `rank`, `scrapedAt` |
| Content | `title`, `description`, `altText`, `hashtags`, `mentions` |
| Outbound traffic | `outboundUrl`, `outboundDomain` (the site the pin sends visitors to) |
| Image | `imageUrl` (original), `imageWidth`, `imageHeight`, `imageAspectRatio`, `imageSizes` (every size Pinterest serves), `dominantColor` |
| Video | `isVideo`, `videoUrl` |
| Engagement | `saves`, `repinCount`, `commentCount`, `shareCount`, `reactionCount`, `reactions` |
| Classification | `category`, `isRepin`, `isCarousel`, `isStoryPin`, `seoTitle`, `seoDescription`, `richSummary` |
| Board | `boardId`, `boardName`, `boardUrl` |
| Pinner | `pinnerUsername`, `pinnerName`, `pinnerFollowers`, `pinnerVerified`, `pinnerUrl` |
| Product | `price` (value and currency, when the pin is a product) |
| Time | `createdAt` as an ISO 8601 date |

Fields Pinterest does not publish for a pin are returned as `null`, never dropped, so your columns stay stable between runs. Save and repin counts are filled when you scrape a pin link; search and board feeds show reaction counts instead, because Pinterest does not include save counts in those lists. Promoted (paid) pins are skipped so your data stays organic.

### Example input

```json
{
  "searchQueries": ["home office ideas", "minimalist desk setup"],
  "urls": [
    "https://www.pinterest.com/crateandbarrel/",
    "https://www.pinterest.com/pin/99360735500167749/"
  ],
  "maxItems": 25
}
```

### Output sample

```json
{
  "pinId": "99360735500167749",
  "pinUrl": "https://www.pinterest.com/pin/99360735500167749/",
  "title": null,
  "description": "Love my Pinterest t-shirt!",
  "outboundUrl": "http://www.flickr.com/photos/kentbrew/6851755809/",
  "outboundDomain": "flickr.com",
  "imageUrl": "https://i.pinimg.com/originals/...jpg",
  "imageWidth": 600,
  "dominantColor": "#e77b60",
  "createdAt": "2012-10-04T21:50:37.000Z",
  "saves": 101669,
  "repinCount": 4829,
  "commentCount": 35,
  "boardName": "Advent...",
  "pinnerUsername": "...",
  "hashtags": [],
  "sourceType": "pin",
  "scrapedAt": "2026-11-17T20:30:00.000Z"
}
```

### Use cases

- **Keyword and trend research.** See which images, titles and domains Pinterest ranks for a keyword, and what colors and aspect ratios dominate the top results.
- **Competitor and brand monitoring.** Export a brand's created pins and see which boards and which outbound links they push.
- **Content and traffic planning.** The `outboundDomain` field shows which sites win Pinterest traffic in your niche, and `price` shows product pins.
- **Mood boards and datasets.** Pull a full board with every image size for design inspiration, training sets or archives.
- **Influencer lists.** `pinnerFollowers` and `pinnerVerified` rank the accounts behind the pins you found.
- **Ecommerce.** Find product pins with prices and the shops they link to.

### How to scrape Pinterest, step by step

1. Decide the entry point. Keywords are best for research and discovery. Board and profile links are best when you already know the account.
2. Set **Max pins per keyword or link**. Pinterest returns pins in pages of about 50, so a limit of 100 costs two requests per input.
3. Start the run. Progress shows in the status line.
4. Check the `OUTPUT` record in the key-value store: it lists every input, its type, how many pins it returned and whether it was found, empty or failed.
5. Download the dataset or connect it to your tools.

### Limits

- **Public data only.** Private boards, secret boards, direct messages and anything behind a login are not available and are reported as not found.
- **Search depth.** Pinterest limits how far a single search goes; results typically run out after a few hundred to a couple of thousand pins.
- **Saves on feeds.** Exact save counts are provided on pin links. Search and board lists give reactions only.
- **Pin IDs.** Some feed pins use new-style IDs. They are valid for matching and de-duplication; use pin links with numeric IDs for the full detail lookup.
- **Rate limits.** The Actor retries with a fresh anonymous session if Pinterest throttles it. If you see repeated failures, switch on the **Proxy** option.

### Pricing and cost control

Pay per result, no subscription: **$0.0023 per pin on the free plan** (Bronze $0.00214, Silver $0.00183, Gold $0.00141), plus a $0.002 start fee per run. That is $2.30 per 1,000 pins on the free plan, and the price drops on higher Apify plans. Set **Maximum cost per run** or **Max pins per keyword or link** to cap spend; the run stops cleanly at the limit and tells you so in `OUTPUT`. Runs that return nothing, for example a misspelt board link, are not charged for pins.

### Integrations and scheduling

Schedule the Actor daily or weekly to track a keyword or a competitor profile over time, then send results to Google Sheets, Slack, email, Make, Zapier or n8n with the Apify integrations, or call it from your own code through the REST API and the Python and JavaScript clients.

### Use with the API, n8n, Make, Zapier or AI agents

**API** (one call, returns the rows as JSON):

```bash
curl -X POST "https://api.apify.com/v2/acts/transparent_meteorite~pinterest-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" -H "Content-Type: application/json" -d '{"searchQueries":["home office ideas"],"maxItems":25}'
```

**Python**

```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("transparent_meteorite/pinterest-scraper").call(run_input={"searchQueries": ["home office ideas"], "maxItems": 25})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(row["rank"], row["title"], row["outboundDomain"])
```

**JavaScript**

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('transparent_meteorite/pinterest-scraper').call({ searchQueries: ['home office ideas'], maxItems: 25 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.length);
```

- **n8n, Make, Zapier:** use the Apify app's "Run Actor" step with actor `transparent_meteorite/pinterest-scraper`, paste the input JSON, then map the dataset items to your sheet or database.
- **AI agents (MCP):** connect the Apify MCP server at `https://mcp.apify.com?tools=transparent_meteorite/pinterest-scraper` to Claude, Cursor or any MCP client, and your agent can run this Actor as a tool.

### Is it legal to scrape Pinterest?

The Actor reads only pages and data that Pinterest shows publicly to anyone without an account. It does not log in, bypass captchas, read private content or collect personal messages. Pins and images belong to their creators, so respect copyright and the privacy rules that apply to you, especially when you store profile details. This is an independent tool and is not affiliated with Pinterest.

### FAQ

**Do I need a Pinterest account or API key?** No. The Actor works logged out.

**Can it scrape private or secret boards?** No. Only public content is available.

**Why are some save counts empty on search results?** Pinterest does not include save counts in its list feeds. Scrape the pin link to get saves, repins and comments for a specific pin.

**How many pins can I get per search?** Up to 5,000 per keyword or link are allowed; Pinterest itself usually ends a search sooner.

**Do I need a proxy?** Usually not. The Actor works from Apify's cloud without one. If Pinterest blocks your runs, enable the Proxy option.

**Are promoted pins included?** No, paid promoted pins are skipped.

**Why did I get fewer pins than my limit?** The keyword, board or profile has fewer public pins, or Pinterest ended the feed. The `OUTPUT` record shows the count per input.

**Can I get the original full-size image?** Yes, `imageUrl` is the original and `imageSizes` lists every smaller size with width and height.

**Which dates are used?** `createdAt` is an ISO 8601 UTC timestamp.

**Does it download images?** No, it returns image links, which keeps runs fast and cheap. Download them with your own tool if you need the files.

### Support

Found a link or keyword that reads badly? Open an issue on the Issues tab with the run URL and the input.

### Related actors

- [Website Email Extractor](https://apify.com/transparent_meteorite/website-contact-extractor) for emails and contact details on the sites your pins link to.
- [Company Enrichment by Domain](https://apify.com/transparent_meteorite/company-enrichment-by-domain) to add firmographics to the brands behind the pins.
- [Domain Intelligence Lookup](https://apify.com/transparent_meteorite/domain-intelligence-lookup) to check the domains your pins send traffic to.
- [Telegram Channel Scraper](https://apify.com/transparent_meteorite/telegram-channel-scraper) for public channel posts, views and links.

### Changelog

- **0.1**: First build. Keyword search, boards, profiles and pin links with image sizes, outbound domain, engagement and ISO dates.

# Actor input Schema

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

One Pinterest search per line, for example: boho bedroom. Each keyword returns its own list of pins.

## `urls` (type: `array`):

Public Pinterest links, one per line: a board (pinterest.com/user/board/), a profile (pinterest.com/user/), a pin (pinterest.com/pin/123/) or a search page.

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

Stops after this many pins for each keyword or link. A pin link always returns one pin with full save counts.

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

Optional. Leave off for most runs; turn on Apify Proxy if Pinterest blocks the cloud address.

## Actor input object example

```json
{
  "searchQueries": [
    "home office ideas",
    "minimalist desk setup"
  ],
  "maxItems": 25
}
```

# Actor output Schema

## `pins` (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": [
        "home office ideas",
        "minimalist desk setup"
    ],
    "maxItems": 25
};

// Run the Actor and wait for it to finish
const run = await client.actor("transparent_meteorite/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": [
        "home office ideas",
        "minimalist desk setup",
    ],
    "maxItems": 25,
}

# Run the Actor and wait for it to finish
run = client.actor("transparent_meteorite/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": [
    "home office ideas",
    "minimalist desk setup"
  ],
  "maxItems": 25
}' |
apify call transparent_meteorite/pinterest-scraper --silent --output-dataset

```

## MCP server setup

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