# Pinterest Followers Scraper (`maximedupre/pinterest-followers-scraper`) Actor

Collect follower profile identities from public Pinterest profiles with URLs or usernames. Set a per-profile limit, or leave it empty to collect all available followers until the source is exhausted, with usernames, names, links, images, account IDs, and status fields when shown.

- **URL**: https://apify.com/maximedupre/pinterest-followers-scraper.md
- **Developed by:** [Maxime Dupré](https://apify.com/maximedupre) (community)
- **Categories:** Social media, Marketing, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.15 / 1,000 follower profiles

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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### 📌 See who follows a Pinterest profile

Marketers, researchers, and developers can enter Pinterest profile URLs or usernames and get structured follower rows. Each row can include the follower username, full name, profile link, profile image, account ID, privacy status, verification status, and the source profile URL when Pinterest shows the data. Use the data to study an audience, compare profiles, or prepare a list for later work. The Actor reads publicly visible profiles and does not need a customer-supplied Pinterest credential.

Set a per-profile limit to shorten a run. Leave it empty to collect all available followers until the source is exhausted.

- Scrape a public profile's audience with **[Pinterest Followers Scraper](https://apify.com/maximedupre/pinterest-followers-scraper/examples/pinterest-followers-scraper)**.
- Export follower rows for a profile with **[Pinterest Follower Export](https://apify.com/maximedupre/pinterest-followers-scraper/examples/pinterest-follower-export)**.
- Build structured audience data with **[Pinterest Followers Data](https://apify.com/maximedupre/pinterest-followers-scraper/examples/pinterest-followers-data)**.
- Review the followers of one profile with **[Pinterest Profile Followers](https://apify.com/maximedupre/pinterest-followers-scraper/examples/pinterest-profile-followers)**.
- Collect a reusable follower list with **[Pinterest Follower List](https://apify.com/maximedupre/pinterest-followers-scraper/examples/pinterest-follower-list)**.

#### 👥 Pinterest follower profile rows

The Actor saves one row for each first eligible follower occurrence it finds. Each row keeps the source profile URL so you can trace where it came from. Pinterest may leave fields out when it does not show them.

**Returned data**

Rows are saved as followers are found. The output panel links to the default dataset, where you can export the structured data.

#### ▶️ Collect followers from each profile

Enter one or more profiles. The Actor continues through the available follower results for each profile, and the limit applies separately to each profile. A smaller limit can shorten the wait and reduce the amount of data to review. Leave the limit empty to collect all available followers until the source is exhausted.

Use publicly visible profiles. Results are not guaranteed for private or inaccessible profiles, or profiles blocked by Pinterest.

#### ⚙️ Input

Use a Pinterest profile URL or username for each source profile.

**Input fields**

| Field | Type | What it does |
| --- | --- | --- |
| `profiles` | array of strings | Profiles to process. Each value can be a Pinterest profile URL or username. |
| `maxFollowersPerProfile` | integer | Maximum followers to collect from each submitted profile. Leave it empty to collect all available followers until the source is exhausted. |

**Default input example**

This example is copied from the successful beta run that used the default input.

```json
{
  "profiles": [
    "pinterest"
  ],
  "maxFollowersPerProfile": 10
}
```

#### 🧾 Output

The Actor writes follower profile rows to the default dataset. `sourceProfileUrl` is always present. At least one of `username`, `profileUrl`, or `accountId` is present, and other fields appear when Pinterest shows them.

**Follower profile row fields**

| Field | Type | What it does |
| --- | --- | --- |
| `sourceProfileUrl` | string | URL of the Pinterest profile that the follower came from. |
| `username` | string | Pinterest username of the follower when shown by the source. |
| `fullName` | string | Full name of the follower when shown by the source. |
| `profileUrl` | string | URL of the follower's Pinterest profile when shown by the source. |
| `profileImageUrl` | string | URL of the follower's profile image when shown by the source. |
| `accountId` | string | Pinterest account identifier of the follower when shown by the source. |
| `privacyStatus` | string | Privacy status shown for the follower. |
| `isVerified` | boolean | Whether the source marks the follower as verified. |

**Example follower row**

This genuine row is copied from the successful beta run that used the default input.

```json
{
  "sourceProfileUrl": "https://www.pinterest.com/pinterest/",
  "username": "samarborik26",
  "profileUrl": "https://www.pinterest.com/samarborik26/",
  "accountId": "1107674608259525852",
  "privacyStatus": "public",
  "fullName": "Samar",
  "profileImageUrl": "https://s.pinimg.com/images/user/default_280.png"
}
```

#### 💳 Pricing

Pricing uses one pay-per-event charge for each successfully saved follower profile. The price shown by Apify depends on your account tier. The charge applies to a successfully saved follower profile, not to a fixed bundle of rows.

**Follower profile**

One follower profile is charged when it is successfully saved from a public Pinterest profile.

#### 🔌 Integrations

Watch the Pinterest follower scraper walkthrough:

https://www.youtube.com/watch?v=bNACk1\_S\_6w\&list=PLObrtcm1Kw6MUrlLNDbK9QRg8VDJg0gOW\&index=4

#### ❓ FAQ

##### What happens when Pinterest does not show a follower field?

That field is omitted from the row. The row still includes the source URL and at least one available follower identity field.

##### Will a private or blocked profile always return data?

No. Results are not guaranteed for private or inaccessible profiles, or profiles blocked by Pinterest.

##### Can I submit a username instead of a URL?

Yes. Each value in `profiles` can be a Pinterest profile URL or a username.

##### Can I submit more than one profile?

Yes. The Actor processes the submitted profile list in one run, and `maxFollowersPerProfile` applies separately to each profile.

##### What happens if I leave the follower limit empty?

The Actor collects all available followers until the source is exhausted.

##### Do I need a Pinterest login or cookie?

No customer-supplied Pinterest credential is needed for publicly visible profiles.

##### Does this Actor collect following lists too?

No. This product collects followers. Following-list extraction is outside its scope.

##### What does one saved row represent?

It represents one follower identity linked to the Pinterest profile where it was found. Optional profile details appear when the source shows them.

### 📝 Changelog

**0.0: Initial release**

### 🆘 Support

For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~pinterest-followers-scraper/issues) and I'll fix or implement it in less than 24h 🫡

### 🔗 Related Actors

- [Social Media Stats Checker](https://apify.com/maximedupre/social-media-stats-checker) checks public Pinterest profile stats for audience comparisons.
- [Influencer Scraper](https://apify.com/maximedupre/influencer-scraper) finds public influencer profiles across TikTok, Instagram, and YouTube for wider creator research.
- [Pinterest Keyword Scraper](https://apify.com/maximedupre/pinterest-keyword-scraper) collects Pinterest autocomplete suggestions for content planning.
- [Pinterest Followers & Following Scraper - Low-cost💲🔥👥📌](https://apify.com/delectable_incubator/pinterest-followers-following-scraper-low-cost) helps compare follower and following lists when both audience surfaces are needed.
- [Pinterest Followers Scraper](https://apify.com/scraper-engine/pinterest-followers-scraper) collects follower profiles with extra public profile details.

**Made with ❤️ by Maxime Dupré**

# Actor input Schema

## `profiles` (type: `array`):

Enter one or more Pinterest profile URLs or usernames. The Actor collects followers from each profile you enter.

## `maxFollowersPerProfile` (type: `integer`):

Set the maximum number of followers to collect from each submitted profile. Leave this empty to collect all available followers until the source is exhausted.

## Actor input object example

```json
{
  "profiles": [
    "pinterest"
  ],
  "maxFollowersPerProfile": 10
}
```

# Actor output Schema

## `datasetItems` (type: `string`):

Open the collected follower profile rows in the default dataset.

# 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 = {
    "profiles": [
        "pinterest"
    ],
    "maxFollowersPerProfile": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("maximedupre/pinterest-followers-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 = {
    "profiles": ["pinterest"],
    "maxFollowersPerProfile": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("maximedupre/pinterest-followers-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 '{
  "profiles": [
    "pinterest"
  ],
  "maxFollowersPerProfile": 10
}' |
apify call maximedupre/pinterest-followers-scraper --silent --output-dataset

```

## MCP server setup

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