# Pinterest Scraper: Pins, Boards & Profiles

The Pinterest Scraper pulls pins from keyword search, any public board or any public profile and returns one row per pin: pin URL, image URLs at original, 736px or 474px, video variants, repin counts and alt text. It calls Pinterest's resource API over plain HTTP, so no browser, login, API key or proxy is needed. Pins cost $0.00199 each, or $1.99 per 1,000, plus $0.005 per run. Run it from Apify Console or the API.

## Key facts

- Price: from $0.00199 per pin scraped, $1.99 per 1,000
- Pricing model: Pay per event
- Output: JSON, CSV, Excel, XML, RSS via Apify datasets
- Access: Apify Console, REST API, Python and JS clients, MCP tool pinterest
- Version: Updated Nov 2026, build 0.1.8
- Usage: 30 users, 94.0% successful runs (30 days)
- Actor: subimpact/pinterest-scraper

## Who it is for

- Ecommerce and interior brands researching visual trends by keyword
- Creative teams collecting full-resolution reference images by board
- Growth analysts profiling prolific pinners and their boards
- Data teams building image datasets for model training

## Use cases

### Collect reference images from a board

Set mode to board and pass boardUrls such as https://www.pinterest.com/les_bons_details/interior-design/, or boardIds if you already have the numeric id. Each row carries pinId, pinUrl, imageOrigUrl, dominantColor and boardName. Board payloads are rich, so title, description, link, domain and repinCount usually arrive without extra requests. Use maxPinsPerSource as the spend ceiling.

### Profile a pinner's output

Run mode profile with usernames like ohuhu, nasa. Every pin a user published comes back with createdAt and scrapedAt, so you can measure posting cadence, and with imageUrl at the size you chose. Add maxPinsTotal to cap a multi-profile run, for example 250 pins across 5 accounts, and keep the run inside the platform timeout.

### Keyword demand research with text enrichment

In search mode Pinterest returns images only: no title, description, board or pinner. Turn on enrichDetails to fetch each pin's detail endpoint, which fills title, description and attribution where Pinterest exposes them. altText often carries the most descriptive wording, so pair it with dominantColor and priceValue to read a keyword's visual and commercial mix.

### Build image sets for model training

imageSize orig gives the full-resolution original, and image736Url and image474Url give the lighter variants. Turn on downloadMedia to store each file in the run's key-value store, with mediaKey and mediaBytes on the row. Files cost $0.005 each; the URLs in the dataset are directly usable if you would rather fetch them yourself.

### Find video pins and their MP4 sources

isVideo flags pins that carry video, and videoUrls lists every variant with MP4 files first and HLS playlists after. downloadMedia never pulls a playlist, only a real file, so a video pipeline gets usable media without post-processing. videoStatus tells you whether Pinterest has finished processing the upload.

## Price events

- Pin scraped (`pin-scraped`): $0.00199, lowest tier $0.00199. One pin pushed to the dataset.
- Actor Start (`apify-actor-start`): $0.005, lowest tier $0.005. Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event).
- Media downloaded (`media-downloaded`): $0.005, lowest tier $0.005. One image/video file stored in the run's key-value store (only when downloadMedia is enabled).

Prices from the Apify Store. Apify shows the final price before each run.

## How it compares with other Apify actors

Price per 1,000 pins at Apify Store list prices, checked 20 Nov 2026.

| Actor | Price per 1,000 pins (Free plan) | Higher plans (Gold) | Start fee per run | Platform usage | Users | Rating | Last build |
| --- | --- | --- | --- | --- | --- | --- | --- |
| Pinterest Scraper — Search, Boards & Profiles (this API) | $1.99 | $1.99 | $0.005 | Included | 30 | No reviews yet | 18 Nov 2026 |
| [Pinterest Scraper | All-In-One](https://apify.com/fatihtahta/pinterest-scraper-search) | $3.99 | $1.99 | None | Included | 3,160 | No reviews yet | 15 Nov 2026 |
| [Pinterest Scraper — Pins, Videos, Boards, Profiles & Search](https://apify.com/automation-lab/pinterest-scraper) | $2.30 | $1.84 | None | Included | 2,237 | 5.0 (1 review) | 20 Nov 2026 |
| [Pinterest Scraper | Pins, Boards and Profiles](https://apify.com/silentflow/pinterest-scraper-ppr) | $2.00 | $1.70 | $0.00005 | Included | 1,821 | 5.0 (2 reviews) | 20 Nov 2026 |
| [Pinterest Scraper - Pins, Boards, Comments & User Profiles](https://apify.com/epctex/pinterest-scraper) | $0.1 | $0.097 | None | Included | 4,220 | 5.0 (9 reviews) | 20 Nov 2026 |
| [Pinterest Scraper - Pins, Boards, Search, Images & Video](https://apify.com/dltik/pinterest-scraper) | $2.00 | $2.00 | None | Included | 228 | 5.0 (1 review) | 20 Nov 2026 |

### Where Pinterest Scraper | All-In-One is stronger

- Can add sentiment and topic analysis to each pin, which we do not offer
- Larger user base and longer review history on the Apify Store

### Where this API is stronger

- Pure HTTP with no browser, so runs start quickly and use little compute
- Output includes repin and comment counts plus board and pinner follower counts
- Media files can be downloaded to the key-value store in the same run

### Where Pinterest Scraper — Pins, Videos, Boards, Profiles & Search is stronger

- Accepts pin URLs, so a single pin can be refreshed without a search
- Output includes video duration and hashtags, which our schema does not carry
- Larger user base and more recent runs on the Apify Store

### Where this API is stronger

- Pure HTTP with no browser, so runs start fast and keep platform usage low
- Inputs accept board IDs as well as board URLs and profile names
- Output adds board and pinner follower counts, dominant colour and media storage keys

### Where Pinterest Scraper | Pins, Boards and Profiles is stronger

- Returns images in several sizes and can include comments, replies and related pins
- Output carries a type field, so pin, board and profile rows sit in one dataset
- Larger user base and more recent runs on the Apify Store

### Where this API is stronger

- Pure HTTP with no browser, so runs start fast and use little compute
- Repin and comment counts, board follower counts and pinner follower counts per pin
- Optional media downloads to the key-value store, with keys and byte sizes in the row

### Where Pinterest Scraper - Pins, Boards, Comments & User Profiles is stronger

- Covers idea pins, comments, replies and user boards inside one actor
- Documents error codes for each failure type, useful when debugging a schedule
- Much larger user base and a longer review history on the Apify Store

### Where this API is stronger

- One event per pin instead of separate query, detail and dataset charges
- Pure HTTP with no browser, so runs start fast and keep compute low
- Media storage keys and byte sizes are written into each row when downloads are on

### Where Pinterest Scraper - Pins, Boards, Search, Images & Video is stronger

- Can add AI niche and commercial intent scoring to each pin
- Flags affiliate networks and product pricing, which our rows do not include

### Where this API is stronger

- Output adds repin counts, board and pinner follower counts and full resolution image URLs
- Accepts board IDs, board URLs, profile names and keywords from one input set
- Optional media downloads to the key-value store during the same run

The Pinterest actors here all return pins from search, boards and profiles, so the choice turns on scope and billing shape. Buyers who need comments, idea pins or AI enrichment will find a closer fit elsewhere, while teams that mainly want fast pin harvesting at a predictable per pin price can stay with this actor or the two similar HTTP based ones.

Prices are Apify Store list prices, checked 20 Nov 2026. Platform usage 'Paid separately' means Apify bills compute on top of the event price. Check each listing before you buy.

## Input

- `mode` (string, required): search = keyword search (use queries). board = every pin on a board (use boardUrls or boardIds). profile = every pin a user has published (use usernames).
- `queries` (string, optional): Comma-separated search keywords, e.g. `ai wallpaper, minimal interior`. Required when mode=search — leave empty to use the default query `ai wallpaper`. NOTE: Pinterest's search payload contains images only — no title, description, board...
- `boardUrls` (string, optional): Comma-separated board URLs or paths, e.g. `https://www.pinterest.com/les_bons_details/interior-design/` or `/les_bons_details/interior-design/`. The numeric board id is resolved automatically from the board page. Used when mode=board.
- `boardIds` (string, optional): Comma-separated numeric board ids, e.g. `286612032474627954`. Faster than boardUrls (skips the id-resolution request). Used when mode=board.
- `usernames` (string, optional): Comma-separated Pinterest usernames, e.g. `ohuhu, nasa`. A leading @ and full profile URLs are accepted. Required when mode=profile.
- `maxPinsPerSource` (integer, optional): Maximum pins to collect per query / board / profile. This is your cost ceiling: pins scraped × the per-pin price. Hard cap: 5000.
- `maxPinsTotal` (integer, optional): Optional global cap across EVERY query / board / profile in the run, on top of max pins per source. Leave empty for no global cap (unlimited). Use this to keep long multi-source runs inside the 1-hour platform timeout.
- `imageSize` (string, optional): Which image variant to put in `imageUrl` (and to download when media download is on). `orig` is the full-resolution original.
- `downloadMedia` (boolean, optional): Download each pin's image (or MP4 for video pins) into the run's key-value store and link it from the dataset row. Billed per file downloaded. Off by default — the image URLs in the dataset are directly usable.
- `enrichDetails` (boolean, optional): Fetch each pin's detail endpoint for extra fields. Costs one extra HTTP request per pin, so runs take noticeably longer. Worth it in search mode; usually redundant in board/profile mode, where pins already arrive with full metadata. With...
- `includeRaw` (boolean, optional): Keep the untouched Pinterest pin object in the `raw` column. Turn off for smaller datasets.
- `proxyConfiguration` (object, optional): Not required — Pinterest's resource API responds normally to datacenter IPs. Kept as an escape hatch in case an exit IP gets throttled.

### Example input

```json
{
  "mode": "search",
  "queries": "ai wallpaper",
  "maxPinsPerSource": 50
}
```

## Output fields

- `runId` (string/null): Apify Actor run ID
- `mode` (string/null): search / board / profile
- `source` (string/null): The query, board URL, board ID or username this pin came from
- `page` (integer/null): Bookmark page number within the source
- `pinId` (string/null): Pinterest pin ID (string — these exceed 2^53)
- `pinUrl` (string/null): Canonical permalink, https://www.pinterest.com/pin/{id}/
- `title` (string/null): Pin title. Frequently blank on Pinterest, and always absent in search mode unless enrichDetails is on
- `description` (string/null): Pin description. Absent in search mode unless enrichDetails is on
- `link` (string/null): Destination URL the pin points at, null for user uploads
- `domain` (string/null): Source domain, or 'Uploaded by user'
- `imageSignature` (string/null): Pinterest image hash — also the last path segment of every image URL
- `imageOrigUrl` (string/null): Full-resolution original on i.pinimg.com/originals/. Needs a pinterest.com Referer to fetch
- `image736Url` (string/null): 736px-wide variant
- `image474Url` (string/null): 474px-wide variant
- `isVideo` (boolean/null): True when the pin carries video variants
- `videoUrls` (array/null): All video variant URLs, MP4 first then HLS .m3u8 playlists
- `videoStatus` (string/null): Pinterest's processing status for video pins
- `isRepin` (boolean/null): Whether the pin was saved from another pin
- `repinCount` (integer/null): Save count. Not returned in search or profile payloads
- `commentCount` (integer/null): Comment count. Not returned in search or profile payloads
- `boardId` (string/null): ID of the board the pin sits on
- `boardName` (string/null): Board display name
- `boardUrl` (string/null): Absolute board URL
- `boardPinCount` (integer/null): Total pins on the board. Pinterest omits this from feed payloads — expect null
- `boardFollowerCount` (integer/null): Board follower count. Pinterest omits this from feed payloads — expect null
- `pinnerId` (string/null): User ID of the account that pinned it
- `pinnerUsername` (string/null): Username of the account that pinned it
- `pinnerFullName` (string/null): Display name of the account that pinned it
- `pinnerFollowerCount` (integer/null): Pinner follower count. Pinterest omits this from feed payloads — expect null
- `dominantColor` (string/null): Hex colour Pinterest computed for the image
- `altText` (string/null): Alt text, falling back to Pinterest's auto-generated caption — usually the most descriptive text on a pin
- `isPromoted` (boolean/null): Whether the pin is an ad
- `priceValue` (number/null): Product price when the pin is a product pin
- `createdAt` (string/null): When the pin was created (RFC 1123, as Pinterest returns it)
- `scrapedAt` (string/null): ISO 8601 timestamp of collection
- `image` (string/null): Key-value store URL of the downloaded image — only when downloadMedia is on
- `imageUrl` (string/null): Source image URL at the requested imageSize
- `videoUrl` (string/null): Best downloadable video variant, or its key-value store URL once downloaded
- `mediaKey` (string/null): Key-value store record key for the downloaded file
- `mediaBytes` (integer/null): Size of the downloaded file in bytes

## Sample output

Trimmed from one of our own test runs. Personal data is redacted.

```json
[
  {
    "runId": "mqq3xE8nEmXGzxQX4",
    "mode": "search",
    "source": "ai wallpaper",
    "page": 1,
    "pinId": "e1_AfqPShz1GB3sQUCT19l4Vl-K0is4WHRRJMuPjXZHB8IhHUmeYq_ITw",
    "pinUrl": "https://www.pinterest.com/pin/e1_AfqPShz1GB3sQUCT19l4Vl-K0is4WHRRJMuPjXZHB8IhHUmeYq_ITw/",
    "title": null,
    "description": null,
    "link": null,
    "domain": null,
    "imageSignature": "30fc8ec901c93d8c85843517aff25c2d",
    "imageOrigUrl": "https://i.pinimg.com/originals/30/fc/8e/30fc8ec901c93d8c85843517aff25c2d.png",
    "image736Url": "https://i.pinimg.com/736x/30/fc/8e/30fc8ec901c93d8c85843517aff25c2d.jpg",
    "image474Url": "https://i.pinimg.com/474x/30/fc/8e/30fc8ec901c93d8c85843517aff25c2d.jpg",
    "isVideo": false,
    "videoUrls": [],
    "videoStatus": null,
    "isRepin": null,
    "repinCount": null,
    "commentCount": null,
    "boardId": null,
    "boardName": null,
    "boardUrl": null,
    "boardPinCount": null,
    "boardFollowerCount": null,
    "pinnerId": null,
    "pinnerUsername": null,
    "pinnerFullName": null,
    "pinnerFollowerCount": null,
    "dominantColor": "#0a1f22"
  },
  {
    "runId": "mqq3xE8nEmXGzxQX4",
    "mode": "search",
    "source": "ai wallpaper",
    "page": 1,
    "pinId": "e1_AfqPShyQs47tnDpm9L6uF9Jg2XhtYOhFg4Py1Q3-C_nfiH1BG9CiiA",
    "pinUrl": "https://www.pinterest.com/pin/e1_AfqPShyQs47tnDpm9L6uF9Jg2XhtYOhFg4Py1Q3-C_nfiH1BG9CiiA/",
    "title": null,
    "description": null,
    "link": null,
    "domain": null,
    "imageSignature": "1c3c7a6b754dffe79b0ecdfd204e6740",
    "imageOrigUrl": "https://i.pinimg.com/originals/1c/3c/7a/1c3c7a6b754dffe79b0ecdfd204e6740.png",
    "image736Url": "https://i.pinimg.com/736x/1c/3c/7a/1c3c7a6b754dffe79b0ecdfd204e6740.jpg",
    "image474Url": "https://i.pinimg.com/474x/1c/3c/7a/1c3c7a6b754dffe79b0ecdfd204e6740.jpg",
    "isVideo": false,
    "videoUrls": [],
    "videoStatus": null,
    "isRepin": null,
    "repinCount": null,
    "commentCount": null,
    "boardId": null,
    "boardName": null,
    "boardUrl": null,
    "boardPinCount": null,
    "boardFollowerCount": null,
    "pinnerId": null,
    "pinnerUsername": null,
    "pinnerFullName": null,
    "pinnerFollowerCount": null,
    "dominantColor": "#2e2845"
  }
]
```

## How to run it

1. Pick the mode: search, board or profile. Only one target field is needed for the run.
2. Fill the matching field, for example queries "ai wallpaper, minimal interior", or usernames "ohuhu, nasa", or a board URL.
3. Set maxPinsPerSource to your budget, for example 100, and imageSize to orig, 736x or 474x.
4. Turn on enrichDetails for search runs when you need titles and descriptions, and downloadMedia only if you want the files stored.
5. Run the actor, then read the dataset in Apify Console or export it as JSON, CSV or Excel.

### cURL

```bash
curl -X POST "https://api.apify.com/v2/acts/subimpact~pinterest-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"search","queries":"ai wallpaper","maxPinsPerSource":50}'
```

### Python

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("subimpact/pinterest-scraper").call(run_input={
      "mode": "search",
      "queries": "ai wallpaper",
      "maxPinsPerSource": 50
    })

for item in client.dataset(run["default_dataset_id"]).iterate_items():
    print(item)
```

### JavaScript

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

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('subimpact/pinterest-scraper').call({
  "mode": "search",
  "queries": "ai wallpaper",
  "maxPinsPerSource": 50
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

console.log(items);
```

### MCP

```bash
claude mcp add subimpact-data -e APIFY_TOKEN=<YOUR_APIFY_TOKEN> -- npx -y @subimpact/data-mcp

# Then ask your agent to use the pinterest tool.
```

### n8n

Use the Apify node (Run an Actor).
Actor ID: subimpact/pinterest-scraper
Input JSON: paste the example input below.

## Limits

- Search mode returns images only unless enrichDetails is on, so title, description and pinner are null by default.
- Board pin totals and follower counts are not present in feed payloads.
- Video HLS playlists are listed in videoUrls but cannot be downloaded as files.
- Title and description are blank on most real pins because Pinterest does not require them.

## FAQ

### How much does 1,000 pins cost?

Each scraped pin costs $0.00199, so 1,000 pins come to $1.99. The actor start charge of $0.005 per run and the $0.005 per file media charge are the only additions. maxPinsPerSource and maxPinsTotal act as hard ceilings, so a run cannot spend more than you allow.

### Why are titles and descriptions null in search mode?

Pinterest's search payload contains images only, with seven fields and no title, description, board or pinner. Set enrichDetails to true and the actor requests each pin's detail endpoint, which recovers real text where Pinterest exposes it. Board and profile payloads already include the richer fields.

### Does it need a Pinterest login or cookies?

No. A single request to pinterest.com mints the session token, and every resource call uses it over plain HTTP. There is no account, no OAuth and no browser, and the proxy field is optional: Pinterest's resource API answers datacenter IPs normally.

### How many pins can I get per board or profile?

Up to 5,000 per source with maxPinsPerSource, which defaults to 500. Pagination stops when the bookmark ends or repeats, so smaller boards return everything they have. For runs with many sources, set maxPinsTotal to keep the whole run inside the platform timeout.

### Are follower counts included?

Board and pinner follower counts, and the board pin total, are null in feed payloads because Pinterest does not include them there. The fields stay in the schema for board search results, which do carry a pin count. Pin level engagement, repinCount and commentCount, comes through in board and profile modes.

### Can I download the images instead of linking them?

Yes. Set downloadMedia to true and each image, or the MP4 for video pins, is written to the run's key-value store with mediaKey, mediaBytes and a public URL on the row. The charge is $0.005 per stored file. The original URLs stay directly fetchable if you only want links.

### What output formats does the dataset support?

JSON, CSV, Excel and XML, from the Apify Console or the Apify API. Rows arrive in a fixed column order starting with runId, mode, source, page, pinId and pinUrl, and include imageSignature, isRepin, boardUrl, pinnerUsername and createdAt.

## Links

- Page: https://subimpact.net/apis/pinterest-scraper/
- Category: https://subimpact.net/apis/category/social-media/
- Run on Apify: https://apify.com/subimpact/pinterest-scraper
- All data APIs: https://subimpact.net/apis/
- Catalogue JSON: https://subimpact.net/apis/catalogue.json
