# Pinterest Search Scraper — Keyword Search, Pins & Videos (`memo23/pinterest-search-scraper`) Actor

Pinterest keyword search scraper: pins, videos, boards, profiles by search query. Images, outbound links, saves, comments. JSON or CSV, no login.

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

## Pricing

from $2.50 / 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.

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 Search Scraper — Keyword Search, Pins & Videos

> Same actor as [Pinterest Scraper](https://apify.com/memo23/pinterest-scraper). This listing is the one Store search hits for **Pinterest keyword search**. Keyword research (Trends + suggested phrases) lives on [Pinterest Trends Scraper](https://apify.com/memo23/pinterest-trends-scraper).

**Search Pinterest by keyword** and get pin rows: images, video stream URLs, descriptions, outbound links, saves, creator and board context. Boards, profiles, ideas hubs, pin.it links, comments, and a scheduled watch for new pins are on the same actor. JSON or CSV. No login.

> One run, one dataset. A deleted or private pin cannot fail the rest of the run.

#### How it works

![How Pinterest Search Scraper works](https://raw.githubusercontent.com/muhamed-didovic/muhamed-didovic.github.io/main/assets/how-it-works-pinterest-v1.png)

### How to use

1. Leave **Start URLs** empty (or paste search / pin / board / profile URLs).
2. Fill **Search queries** — one phrase per line.
3. Set **Search type** to **All pins** (default) or **Videos**.
4. Set **max items** and start.

### Example input

Keyword search:

```json
{
    "searchQueries": ["spring nails", "almond nails"],
    "searchScope": "pins",
    "maxItems": 100
}
```

Video pins for a phrase:

```json
{
    "searchQueries": ["kitchen remodel"],
    "searchScope": "videos",
    "maxItems": 50
}
```

A pasted search URL:

```json
{
    "startUrls": ["https://www.pinterest.com/search/pins/?q=nail+art"],
    "maxItems": 80
}
```

### What you get

- Pin id, URL, title, description, created time
- Image variants and, on video pins, stream URLs
- Saves, comments count, reactions
- Destination website when the pin links out
- Creator and board context
- Optional comments + replies, more-ideas pins, keep-only filters (min saves, outbound host, drop promoted), and a scheduled watch for new pins

### Output

Each dataset item is one **pin**. With **flattened output** on, keys are dotted (CSV-friendly).

| Field | Meaning |
| --- | --- |
| `id` / `url` | Pin id and canonical URL |
| `title` / `description` | Text on the pin |
| `link` | Destination website, when present |
| `repin_count` / `comment_count` | Engagement where Pinterest shows it |
| `images.*` | Image sizes |
| `video_url` | Stream URL on video pins |
| `pinner.*` / `board.*` | Creator and board |

### FAQ

**Do I need a Pinterest login?** No.

**Why is this a separate listing?** Store search ranks the slug. `pinterest-search-scraper` is what buyers type for keyword search. The bundled pin/board/profile actor is `pinterest-scraper`.

**Can I still paste a board or profile URL?** Yes. Same actor — Start URLs accept pins, boards, board sections, profiles, ideas hubs, and pin.it links.

**Keyword research (rising searches)?** Use [Pinterest Trends Scraper](https://apify.com/memo23/pinterest-trends-scraper).

### Support

- Issues tab on this actor in the Apify Console
- <https://muhamed-didovic.github.io/>
- <muhamed.didovic@gmail.com>

### Additional services

Customization or full dataset delivery: <muhamed.didovic@gmail.com>

### Explore more scrapers

- [Pinterest Scraper](https://apify.com/memo23/pinterest-scraper) — pins, boards, profiles, comments, watch
- [Pinterest Trends Scraper](https://apify.com/memo23/pinterest-trends-scraper) — rising searches and suggested phrases
- More tools: [memo23 on Apify](https://apify.com/memo23)

### 🤖 For AI Agents & LLM Apps

Actor: `memo23/pinterest-search-scraper`. Same code as `memo23/pinterest-scraper`.

**Purpose:** Keyword search on Pinterest. One row per pin.

**Minimal input:**

```json
{
  "searchQueries": ["nails"],
  "searchScope": "pins",
  "maxItems": 50
}
```

**Output:** `id`, `url`, `title`, `description`, `link`, `repin_count`, `images`, `pinner`, `board`, optional `comments`, `video_url`.

**Notes:** `startUrls` override search. `maxItems` is a shared cap. `searchScope`: `pins` (default), `videos`, `boards`, `users`, `suggestions`. Pay-per-event; comments and enrichment bill as Additional data.

### ⚠️ Disclaimer

This scraper collects only **publicly available** Pinterest data — no login, no private content, and no personal data behind authentication. Use it in compliance with Pinterest, Inc.'s Terms of Service and the laws applicable in your jurisdiction (including GDPR/CCPA where relevant). You are responsible for how the collected data is used.

### SEO Keywords

pinterest search scraper, pinterest keyword search, scrape pinterest pins, pinterest search api, pinterest video search, pinterest board search, pinterest profile search, pinterest image scraper, pinterest marketing data, pinterest json export, pinterest csv export, no-login pinterest search

# Actor input Schema

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

**Supported paths:** ideas `/ideas/slug/id/`, pin `/pin/id/` or `/pin/name--id/`, profile `/{user}/`, board `/{user}/{board}/`, board section `/{user}/{board}/{section}/`, search `/search/{pins|videos|boards|users}/…`, and `pin.it` share links (they open the pin, board or profile they point at). Country domains such as `pinterest.de` or `pinterest.co.uk` work. An ideas hub returns at most the 18 pins Pinterest shows a logged-out visitor. Via API, both plain strings and `{ "url": "…" }` objects are accepted. Unsupported entries are skipped with a warning (the run fails only if none are usable). All URLs share one **max items** budget. Leave empty to use keyword search instead. Pin links in the new format (pinterest.com/pin/e1\_…) cannot be read without a Pinterest account; use the board, profile or search the pin is in.

## `flattenedOutput` (type: `boolean`):

If true, each pin is deep-flattened to one level with dot-separated keys (e.g. `board.owner.username`, `comments.0.content`). If false, the full merged pin record is stored.

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

Each non-empty line becomes its own search at `https://www.pinterest.com/search/{Search type}/?q=…` using **Search type** below. Example lines: `nails`, `spring nail art`. All queries share one **max items** cap. Unused when **Start URLs** is set.

## `searchScope` (type: `string`):

Which Pinterest search tab to use when scraping from **Search queries** (or legacy keyword). **All pins** is the default. **Videos** returns video pins. **Boards** and **Profiles** find matching boards / accounts and then scrape the pins inside them unless **Emit board/profile rows** is on. **Suggested phrases** returns the phrases Pinterest offers for each seed, not pins.

## `searchKeyword` (type: `string`):

Single search term if **Start URLs** and **Search queries** are empty. Same as adding one entry to **Search queries**. Prefer **Search queries** for new setups.

## `includeComments` (type: `boolean`):

Adds a `comments` array to each pin: text, author, date, likes.

## `includeReplies` (type: `boolean`):

Nests public replies under each comment. Turn **Include comments** on as well.

## `includeMoreIdeas` (type: `boolean`):

For each pin start URL, also collect the pins Pinterest shows under it as more ideas. Each one is a separate result.

## `moreIdeasPerPin` (type: `integer`):

Cap on more-ideas pins collected for each pin start URL.

## `includeOnlyUserInfo` (type: `boolean`):

Merges public follower counts, avatars and names for the pinner (and board owner when different) into each pin.

## `boardsFromProfile` (type: `boolean`):

For profile URLs, save one row per public board instead of the profile's pins.

## `listingRows` (type: `boolean`):

When **Search type** is Boards or Profiles, save those boards or accounts as rows instead of opening them to scrape pins.

## `includeSentiment` (type: `boolean`):

Adds a `sentiment` object (label, score, confidence) to each pin from its title/description/alt text. Heuristic — no AI/API call, no extra latency. Billed per pin via the **Additional data** event.

## `includeContentCategory` (type: `boolean`):

Adds a `content_category` object (label, confidence) to each pin — e.g. Home Decor, Fashion & Style, Food & Drink, Beauty — from its text and domain. Heuristic — no AI/API call. Billed per pin via the **Additional data** event.

## `minSaveCount` (type: `integer`):

Keep pins saved at least this many times. 0 keeps everything.

## `requireDestination` (type: `boolean`):

Keep only pins with a destination website (product pages, articles, recipes).

## `destinationHosts` (type: `array`):

Keep only pins whose destination host matches one of these (e.g. etsy.com). Leave empty for every host.

## `dropPromoted` (type: `boolean`):

Skip pins Pinterest marks as promoted.

## `minFollowerCount` (type: `integer`):

Keep pins whose creator has at least this many followers. 0 keeps everything.

## `pinWatch` (type: `string`):

all = save every matching pin (default). unseen = only pins this watch has not seen. changed = pins whose save or comment counts moved, plus new pins.

## `watchKey` (type: `string`):

Stable label for this scheduled job (e.g. nails-daily). Reuse the same name on every run of the same schedule so later runs know what they already saw. Leave empty to use default.

## `trendMarket` (type: `string`):

Country or region whose Pinterest Trends list to read. Leave unset to skip Trends and use URLs or keyword search instead.

## `trendList` (type: `string`):

Which Trends list to read for the market above.

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

Maximum number of pins to collect (enqueues across search pages until this cap or no more results).

## `maxSearchPages` (type: `integer`):

Maximum number of **search** API pages to crawl (e.g. **1** = first page only). Leave empty for no page limit (still limited by max items).

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

Maximum concurrent requests.

## `minConcurrency` (type: `integer`):

Minimum concurrent requests.

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

Retries per request before failure.

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

Leave empty — the actor already routes all traffic through its own built-in residential proxy at no extra cost to you. Only set this if you want to use your own proxies.

## Actor input object example

```json
{
  "startUrls": [
    "https://www.pinterest.com/ideas/beauty/935541271955/",
    "https://www.pinterest.com/pin/1829656094716568/",
    "https://www.pinterest.com/pin/uitas--1829656094716568/",
    "https://www.pinterest.com/dudadelsanto/",
    "https://www.pinterest.com/dudadelsanto/nail-inspo/",
    "https://pin.it/AbC123",
    "https://www.pinterest.com/search/pins/?q=nail+art",
    "https://www.pinterest.com/search/pins/?q=Valentine%E2%80%99s%20Nail%20Art&rs=hub_page",
    "https://www.pinterest.com/search/videos/?q=tutorial",
    "https://www.pinterest.com/search/boards/?q=nails",
    "https://www.pinterest.com/search/users/?q=jane"
  ],
  "flattenedOutput": false,
  "searchQueries": [
    "nails"
  ],
  "searchScope": "pins",
  "includeComments": false,
  "includeReplies": false,
  "includeMoreIdeas": false,
  "moreIdeasPerPin": 50,
  "includeOnlyUserInfo": false,
  "boardsFromProfile": false,
  "listingRows": false,
  "includeSentiment": false,
  "includeContentCategory": false,
  "minSaveCount": 0,
  "requireDestination": false,
  "dropPromoted": false,
  "minFollowerCount": 0,
  "pinWatch": "all",
  "trendList": "rising",
  "maxItems": 10000,
  "maxConcurrency": 10,
  "minConcurrency": 1,
  "maxRequestRetries": 3
}
```

# Actor output Schema

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

One row per pin with title, description, destination link and domain, repin/share/comment counts, image URLs, board and pinner.

# 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 = {
    "startUrls": [
        "https://www.pinterest.com/ideas/beauty/935541271955/",
        "https://www.pinterest.com/pin/1829656094716568/",
        "https://www.pinterest.com/pin/uitas--1829656094716568/",
        "https://www.pinterest.com/dudadelsanto/",
        "https://www.pinterest.com/dudadelsanto/nail-inspo/",
        "https://pin.it/AbC123",
        "https://www.pinterest.com/search/pins/?q=nail+art",
        "https://www.pinterest.com/search/pins/?q=Valentine%E2%80%99s%20Nail%20Art&rs=hub_page",
        "https://www.pinterest.com/search/videos/?q=tutorial",
        "https://www.pinterest.com/search/boards/?q=nails",
        "https://www.pinterest.com/search/users/?q=jane"
    ],
    "searchQueries": [
        "nails"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("memo23/pinterest-search-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 = {
    "startUrls": [
        "https://www.pinterest.com/ideas/beauty/935541271955/",
        "https://www.pinterest.com/pin/1829656094716568/",
        "https://www.pinterest.com/pin/uitas--1829656094716568/",
        "https://www.pinterest.com/dudadelsanto/",
        "https://www.pinterest.com/dudadelsanto/nail-inspo/",
        "https://pin.it/AbC123",
        "https://www.pinterest.com/search/pins/?q=nail+art",
        "https://www.pinterest.com/search/pins/?q=Valentine%E2%80%99s%20Nail%20Art&rs=hub_page",
        "https://www.pinterest.com/search/videos/?q=tutorial",
        "https://www.pinterest.com/search/boards/?q=nails",
        "https://www.pinterest.com/search/users/?q=jane",
    ],
    "searchQueries": ["nails"],
}

# Run the Actor and wait for it to finish
run = client.actor("memo23/pinterest-search-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 '{
  "startUrls": [
    "https://www.pinterest.com/ideas/beauty/935541271955/",
    "https://www.pinterest.com/pin/1829656094716568/",
    "https://www.pinterest.com/pin/uitas--1829656094716568/",
    "https://www.pinterest.com/dudadelsanto/",
    "https://www.pinterest.com/dudadelsanto/nail-inspo/",
    "https://pin.it/AbC123",
    "https://www.pinterest.com/search/pins/?q=nail+art",
    "https://www.pinterest.com/search/pins/?q=Valentine%E2%80%99s%20Nail%20Art&rs=hub_page",
    "https://www.pinterest.com/search/videos/?q=tutorial",
    "https://www.pinterest.com/search/boards/?q=nails",
    "https://www.pinterest.com/search/users/?q=jane"
  ],
  "searchQueries": [
    "nails"
  ]
}' |
apify call memo23/pinterest-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,memo23/pinterest-search-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/F5dptdUzWaU1wSmyz/builds/9fgiVbzRf0Uucdt8O/openapi.json
