# Pinterest Ads Repository Scraper (`aboo.script/ads-pinterest-scraper`) Actor

\[💰$2 / 1K] ⚡ Fast Pinterest Ads Repository scraper. No login, no API key. Get ads shown in 29 EU, Brazil and Turkey markets by country, advertiser, category, age, gender and date: advertiser, creative image/video, landing page, targeting, reach per country and delivery dates.

- **URL**: https://apify.com/aboo.script/ads-pinterest-scraper.md
- **Developed by:** [Aboo Script](https://apify.com/aboo.script) (community)
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.40 / 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.
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 Ads Repository Scraper

![Pinterest Ads Repository Scraper](https://i.ibb.co/XfMBy7V8/ads-pinterest-banner.png)

**Pinterest Ads Repository Scraper** extracts ads from the [Pinterest Ads Repository](https://ads.pinterest.com/ads-repository/) into clean, structured data you can download as JSON, CSV, Excel, or HTML. Pick a country, an advertiser, a category or a date range, and get the advertiser, creative image or video, title, landing page, targeting, reach and delivery dates of every ad. No account or login required.

### Introduction

The [Pinterest Ads Repository](https://ads.pinterest.com/ads-repository/) is Pinterest's public ad library. It lists every ad shown to people in the European Union, Brazil and Turkey, together with who paid for it, who it targeted and how many people it reached.

This actor collects the same public information you see in your browser and turns it into a ready-to-use dataset. You can run it once, schedule it to run daily, or connect it to your own tools.

### What data can you extract from the Pinterest Ads Repository?

- 🏢 Advertiser names, Pinterest profile name, username, profile URL and follower count
- 🏷️ Ad title and description
- 🖼️ Creative image (original size), video, story pages and carousel images
- 🔗 Landing page URLs and domain, plus the ad and Pin URLs
- 📅 First and last delivery dates
- 🎯 Targeting: countries, regions, metros, postal codes, age groups, genders, interests, audience types, devices and keyword use
- 📊 Reach in the EU and per country, as text and as minimum/maximum numbers
- ⚖️ Commercial content flag, verified merchant, review status and moderation reasons

### Use Cases

- 📈 **Market research**: see which products and messages advertisers push on Pinterest in each country and category.
- 🕵️ **Competitor monitoring**: track every Pinterest ad a competitor runs, with its creative, landing page and targeting.
- 🎨 **Creative inspiration**: collect winning images, videos and titles by category for your own campaigns.
- 🤝 **Lead generation**: find brands that actively advertise on Pinterest, with their website and profile.
- 🤖 **AI and automation**: feed clean, structured ad data into spreadsheets, dashboards, or AI workflows.

### How to scrape the Pinterest Ads Repository step by step

1. Keep the Ads Repository page in **Start URLs**, or type advertiser names into **Advertiser names**.
2. Choose the **Country**, and optionally the dates, **Ad category**, **Gender** and **Age**.
3. Set **Maximum number of results** to how many ads you want per URL or per advertiser.
4. Click **Start** and download your data in JSON, CSV, Excel, or HTML from the **Output** tab.

### Input

- **Start URLs**: the Ads Repository page (`https://ads.pinterest.com/ads-repository/`), scraped with the filters below, or single ad pages (`https://ads.pinterest.com/ads-repository/<adId>/`). You can also set filters right in the URL, for example `https://ads.pinterest.com/ads-repository/?country=DE&category=BEAUTY&startDate=2026-09-01&endDate=2026-10-01`, to scrape several countries or categories in one run.
- **Advertiser names**: advertiser names as shown in the Ads Repository advertiser filter, one per line. Upper and lower case do not matter. Each advertiser is scraped separately.
- **Country**: the country where the ads were shown (EU countries, Brazil and Turkey).
- **Start date** and **End date**: the delivery period. Empty means the last 30 days.
- **Ad category**, **Gender** and **Age**: narrow the results to a category or a targeted audience.
- **Maximum number of results**: how many ads to collect for each start URL or advertiser. Set 0 for unlimited.

You can use start URLs, advertiser names, or both in the same run.

### Input Examples

Scrape the latest ads shown in France:

```json
{
  "startUrls": [{ "url": "https://ads.pinterest.com/ads-repository/" }],
  "country": "FR",
  "category": "ALL",
  "gender": "ALL",
  "age": "ALL",
  "maxResults": 5
}
```

Get the ads of specific advertisers in Germany:

```json
{
  "searchQueries": ["Amazon.de", "OTTO"],
  "country": "DE",
  "maxResults": 5
}
```

### Output

Each ad is saved as one item in the dataset. Here is an example of a single item:

```json
{
  "url": "https://ads.pinterest.com/ads-repository/4598527157295329152/",
  "adId": "4598527157295329152",
  "pinUrl": "https://www.pinterest.com/pin/4598527157295329152/",
  "advertiserNames": ["nightbubo"],
  "title": "Charming Long Satin Column Mermaid Prom Dress With Beading (ZD05229)",
  "description": "This Charming Long Satin Column Mermaid Prom Dress With Beading is perfect for any special occasion. The striking silhouette features an alluring mermaid tail s...",
  "imageUrl": "https://i.pinimg.com/originals/61/05/0f/61050f3971cf15db6c9e8cf104348c5a.jpg",
  "videoUrl": null,
  "storyPages": [],
  "carouselImages": [],
  "destinationUrls": [
    "https://www.nightbubo.com/products/charming-long-satin-column-mermaid-prom-dress-with-beading?variant=44435295043724"
  ],
  "destinationDomain": "nightbubo.com",
  "startDate": "2026-09-25T00:00:00.000Z",
  "endDate": "2026-10-17T00:00:00.000Z",
  "searchCountry": "DE",
  "countries": ["Brazil", "Germany", "Turkey"],
  "regions": [],
  "metros": [],
  "postalCodes": [],
  "hasExcludedLocations": false,
  "ageBuckets": ["18+"],
  "genders": ["Female", "Male"],
  "interests": [],
  "audienceTypes": [],
  "devices": [],
  "internetServiceProviders": [],
  "keywordsUsed": false,
  "negativeKeywordsUsed": false,
  "usesPinterestAi": false,
  "reachEu": "0 - 10000",
  "reachEuMin": 0,
  "reachEuMax": 10000,
  "reachByCountry": [
    { "country": "Germany", "reach": "0 - 10000", "reachMin": 0, "reachMax": 10000 },
    { "country": "Turkey", "reach": "0 - 10000", "reachMin": 0, "reachMax": 10000 },
    { "country": "Brazil", "reach": "0 - 10000", "reachMin": 0, "reachMax": 10000 }
  ],
  "isCommercial": true,
  "isLocalInventory": false,
  "isVerifiedMerchant": true,
  "reviewStatus": null,
  "statementOfReasons": [],
  "violationSource": null,
  "violationDecisionMeans": null,
  "pinnerUsername": "nightbubo",
  "pinnerName": "nightbubo",
  "pinnerProfileUrl": "https://www.pinterest.com/nightbubo/",
  "pinnerFollowers": 10,
  "pinCreatedAt": "2026-09-20T16:54:46.000Z"
}
```

You can download the dataset in JSON, CSV, Excel, XML, or HTML, or access it through the Apify API.

### Notes

- The Ads Repository only covers ads shown in the EU, Brazil and Turkey, and only keeps ads from the last 12 months. Older dates are ignored.
- Date ranges longer than 30 days are split into 30-day periods automatically, newest first.
- Advertiser names must match a name from the Ads Repository advertiser filter. If no advertiser matches, the run log shows similar names you can use instead.
- An ad that matches several start URLs or advertisers in the same run is saved only once.
- Some ads link to a Pin that no longer exists. Those ads still have their repository data, but the landing page, Pinterest profile and original image fields are empty.
- Reach is shown as a range by Pinterest (for example `0 - 10000`), so it is returned as text plus minimum and maximum numbers.
- Only URLs from the Ads Repository are supported; other Pinterest URLs are skipped.

### Why use the Pinterest Ads Repository Scraper?

- ✅ **No login needed**: works with public data only, so there is no account to manage.
- 🌍 **Many inputs in one run**: mix countries, categories and advertisers by adding several start URLs and advertiser names.
- 🧹 **Clean data**: numbers are real numbers, dates use one standard format, and text is free of HTML.
- 💸 **Pay for what you need**: set a result limit per URL or advertiser and keep every run small and cheap.
- 🔄 **Ready for automation**: schedule runs, export to Google Sheets, or connect to Make, Zapier, and n8n.

### FAQ

#### How many results can I scrape?

You can set any number in **Maximum number of results**, or 0 for unlimited. The actor keeps going until it reaches your limit or runs out of ads for your filters.

#### Do I need a Pinterest account?

No. The actor only collects publicly available data. You do not need to log in or provide any account details.

#### Can I scrape data on a schedule?

Yes. Use Apify Schedules to run the actor every hour, day, or week, and get fresh ads automatically.

#### Why are some fields empty?

Pinterest does not publish every detail for every ad. When a field is not available, it is returned as `null` or an empty list.

#### Can I request a new feature or filter?

Yes. Right now the actor supports the Ads Repository page, single ad pages, advertiser names and the country, date, category, gender and age filters. If you need something else, get in touch and it can be added.

#### Can I get a custom or private version?

Yes. The actor can be customized for your workflow, delivered as a private version, or a new scraper can be built for a different website. Use the contact details below.

***

**Need help or want a custom solution?**

- 📧 Email: aboo.script@gmail.com
- 🧩 More scrapers: [Apify profile](https://apify.com/aboo.script)

### Image Credit

Image credit: [Pinterest Ads Repository](https://ads.pinterest.com/ads-repository/)

# Actor input Schema

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

Pinterest Ads Repository page (https://ads.pinterest.com/ads-repository/), scraped with the filters below, or ad detail URLs (https://ads.pinterest.com/ads-repository/<adId>/).

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

Advertiser names to get ads for, as shown in the Ads Repository advertiser filter (exact name, case-insensitive). Each advertiser is scraped separately with the filters below.

## `country` (type: `string`):

Country where the ads were shown. Applies to the Ads Repository start URL and to advertiser names (filters written in a start URL take precedence).

## `startDate` (type: `string`):

Show ads delivered from this date (YYYY-MM-DD). Empty means 30 days before the end date. The repository keeps ads from the last 365 days; longer ranges are split into 30-day windows automatically. Applies to the Ads Repository start URL and to advertiser names (filters written in a start URL take precedence).

## `endDate` (type: `string`):

Show ads delivered until this date (YYYY-MM-DD). Empty means today. Applies to the Ads Repository start URL and to advertiser names (filters written in a start URL take precedence).

## `category` (type: `string`):

Ad category. Applies to the Ads Repository start URL and to advertiser names (filters written in a start URL take precedence).

## `gender` (type: `string`):

Targeted gender. Applies to the Ads Repository start URL and to advertiser names (filters written in a start URL take precedence).

## `age` (type: `string`):

Targeted age group. Applies to the Ads Repository start URL and to advertiser names (filters written in a start URL take precedence).

## `maxResults` (type: `integer`):

Maximum number of ads to scrape per start URL or advertiser name. Set 0 for unlimited.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://ads.pinterest.com/ads-repository/"
    }
  ],
  "country": "FR",
  "category": "ALL",
  "gender": "ALL",
  "age": "ALL",
  "maxResults": 5
}
```

# Actor output Schema

## `overview` (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 = {
    "startUrls": [
        {
            "url": "https://ads.pinterest.com/ads-repository/"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("aboo.script/ads-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 = { "startUrls": [{ "url": "https://ads.pinterest.com/ads-repository/" }] }

# Run the Actor and wait for it to finish
run = client.actor("aboo.script/ads-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 '{
  "startUrls": [
    {
      "url": "https://ads.pinterest.com/ads-repository/"
    }
  ]
}' |
apify call aboo.script/ads-pinterest-scraper --silent --output-dataset

```

## MCP server setup

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