Pinterest Ads Scraper

Pinterest Ads Scraper extracts ad creative data, targeting parameters, reach estimates, and advertiser information from the Pinterest Ad Transparency Repository. It accepts country, category, gender, age, advertiser name, and date range filters, and outputs structured JSON with ad titles, descriptions, image URLs, product links, targeting breakdowns, and EU reach ranges. Supports all 27 EU member states plus Brazil and Turkey — the countries covered by Pinterest's Digital Services Act disclosure.

What data can you extract?

Field	Description
id	Pinterest pin ID
advertiserName	Name of the advertiser
title	Ad creative title
description	Full ad description
imageUrl	Pinterest CDN image URL
videoUrl	Video URL (when available)
domain	Advertiser website domain
url	Direct ad URL
productUrl	Product landing page URL
startDate	Ad start date (ISO 8601)
endDate	Ad end date (ISO 8601)
country	Country filter used
targeting.ages	Age groups targeted
targeting.genders	Gender targeting
targeting.countries	Countries targeted
targeting.regions	Regions targeted
targeting.metros	Metro areas targeted
targeting.interests	Interest categories
targeting.keywords	Keyword targeting
reach.totalEU	Total EU reach range
reach.byCountry	Per-country reach breakdown
seoText	SEO metadata text
annotations	Ad annotations from Pinterest
scrapedAt	Extraction timestamp

How to scrape Pinterest ads

1. Open the actor in Apify Console and go to the Input tab.
2. Select a Country — choose from the 29 supported EU/BR/TR options (e.g., DE for Germany).
3. Optionally set a Category to narrow results (e.g., BEAUTY, ELECTRONICS).
4. Optionally add Gender or Age filters to narrow targeting.
5. Set Start Date and End Date for the date range you want to cover.
6. Click Start — the actor returns structured ads matching your filters.

How much does it cost?

This actor uses pay-per-result pricing. You are charged $0.001 per ad scraped across all subscription tiers.

Example	Ads	Cost
Quick sample	50	~$0.05
Category snapshot	500	~$0.50
Full country pull	1,000	~$1.00
Competitor research	5,000	~$5.00

Cost scales with the number of ads returned, not the number of requests. An additional $0.005 platform start fee applies per run (covers the first 5 seconds of compute at no extra charge to you).

Use cases

• Monitor competitor ad creative for a specific category and country
• Track ad frequency and targeting changes over time for a brand
• Build a database of Pinterest advertisers active in EU markets
• Analyze age/gender targeting strategies across product categories
• Research reach estimates for market sizing in specific countries
• Identify emerging advertisers in a niche before they scale budgets
• Verify ad transparency compliance for DSA reporting
• Feed Pinterest ad data into AI agents via the companion Pinterest Ads MCP Server

Input

Field	Required	Default	Description
country	Yes	DE	Country code — EU27 + BR + TR
category	No	ALL	Ad vertical (BEAUTY, ELECTRONICS, etc.)
gender	No	ALL	Gender targeting filter
age	No	ALL	Age group filter
advertiserName	No	—	Filter by advertiser name (partial match)
startDate	No	30 days ago	Start of date range (YYYY-MM-DD)
endDate	No	today	End of date range (YYYY-MM-DD)
maxResults	No	100	Maximum ads to return (0 = unlimited)
proxyConfiguration	No	Residential	Proxy settings

Full input reference is in the Input tab.

Output example

[
  {
    "id": "1120340844803190055",
    "advertiserName": "Sephora France",
    "title": "Découvrez notre nouvelle collection printemps",
    "description": "Explorez les dernières tendances beauté chez Sephora...",
    "imageUrl": "https://i.pinimg.com/474x/dd/99/3a/dd993a.jpg",
    "videoUrl": null,
    "domain": "sephora.fr",
    "url": "https://www.sephora.fr/...",
    "productUrl": "https://www.sephora.fr/...",
    "startDate": "2025-03-01",
    "endDate": "2026-03-01",
    "country": "FR",
    "targeting": {
      "ages": ["25-34", "35-44"],
      "genders": ["FEMALE"],
      "countries": ["France"],
      "regions": [],
      "interests": []
    },
    "reach": {
      "totalEU": "10000 - 50000",
      "byCountry": { "France": "10000 - 50000" }
    },
    "scrapedAt": "2026-02-22T14:42:21.715045+00:00"
  }
]

Tips

• Date ranges over 30 days are split into chunks automatically. Longer ranges return more unique ads but take longer.
• maxResults: 0 means unlimited — use only when you need full coverage for a date range.
• Advertiser name filter does partial matching. Use a brand name fragment (e.g., "Sephora") to find all ads from that advertiser.
• Category ALL returns every vertical, which may include many unrelated ads. Use a specific category for competitive analysis.
• Residential proxies are enabled by default and required for reliable extraction.

FAQ

Which countries are supported? Pinterest's Ad Transparency Repository is available for EU member states (27 countries), Brazil, and Turkey. The United States and other countries are not supported — this is a Pinterest platform limitation, not a scraper limitation.

Why do some ads have empty fields? Pinterest does not expose advertiser IDs in its ad library API. Some pins also lack pinner metadata (advertiser name) or creative data depending on the ad format. Core fields (id, imageUrl, targeting, reach) are always populated.

Can I filter by specific keywords or interests? The ad repository does not support keyword or interest filters — only country, category, gender, age, advertiser name, and date range. These are the same filters available in the Pinterest Ad Repository UI.

How often does Pinterest update the ad library? Pinterest updates the ad library continuously as new ads are approved and existing ads expire. Run the actor daily or weekly to capture changes.

What is the rate limit? The actor manages request pacing automatically. Running it repeatedly on the same filters within minutes may return cached results from Pinterest's side.