# Pinterest Trends Scraper — Keyword Research & Rising Searches (`memo23/pinterest-trends-scraper`) Actor

Pinterest Trends scraper for rising searches, monthly and seasonal lists, plus suggested phrases from a seed. Optional follow-on pin scrape. JSON or CSV, no login.

- **URL**: https://apify.com/memo23/pinterest-trends-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 Trends Scraper — Keyword Research & Rising Searches

> Same actor as [Pinterest Scraper](https://apify.com/memo23/pinterest-scraper) — this listing is the keyword-research entry. Paste a market to get rising phrases, or a seed to get the phrases Pinterest suggests.

**Pinterest Trends and keyword suggestions in one run.** Pick a market for rising / monthly / yearly / seasonal lists, or type seed phrases and get the suggestions Pinterest shows for them. Optional weekly interest, related phrases, and the pins that already rank for those terms. JSON or CSV, no login.

> No Pinterest account. One row per phrase (or per pin if you keep scraping search).

### What you get

- Rising, monthly, yearly and seasonal trend lists by market
- Suggested phrases for each seed you type
- Optional related phrases and weekly interest when Pinterest publishes them
- Optional follow-on pin scrape for any phrase (same actor, search type = pins)

### How to use

1. Leave **Start URLs** empty.
2. Set **Trends market** (e.g. United States) and **Trends list** (Rising is the default).
3. Or fill **Search queries** and set **Search type** to **Suggested phrases**.
4. Set **max items** and start.

### Example input

```json
{
    "trendMarket": "US",
    "trendList": "rising",
    "maxItems": 50
}
```

Suggested phrases from a seed:

```json
{
    "searchQueries": ["coastal grandma", "linen bedding"],
    "searchScope": "suggestions",
    "maxItems": 40
}
```

### Output

Each dataset item is one trend or suggestion:

| Field | Meaning |
| --- | --- |
| `type` | `trend` or `suggestion` |
| `phrase` | The search phrase |
| `market` | Trends market (trend rows) |
| `weekChange` / `monthChange` / `yearChange` | Relative change when Pinterest publishes it |
| `seed` | The seed that produced a suggestion |

Pin, board and profile scrapes from the parent listing still work on this actor — use Start URLs as usual.

### FAQ

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

**Why is this a separate listing?** Store search ranks the slug. `pinterest-trends-scraper` is what buyers type for keyword research. The pin scraper is `pinterest-scraper`.

Need pins, boards, comments or pin.it links? Use [Pinterest Scraper](https://apify.com/memo23/pinterest-scraper).

# 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-trends-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-trends-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-trends-scraper --silent --output-dataset

```

## MCP server setup

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