Pinterest Ad Library Scraper: EU Ads & Reach
Pricing
from $0.90 / 1,000 results
Pinterest Ad Library Scraper: EU Ads & Reach
Extract ads from the Pinterest Ads Repository (DSA Art. 39): advertiser, creative, targeting, reach per EU country and delivery dates. No API key needed.
Pricing
from $0.90 / 1,000 results
Rating
0.0
(0)
Developer
Rastriq — Structured data from the world
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
7 days ago
Last modified
Categories
Features
Share
Pinterest Ad Library Scraper
Extracts ads from the Pinterest Ads Repository — the DSA Article 39 transparency library.
Filter by country, date range, advertiser name, category, age and gender. Returns creative data, audience targeting, reach per country and delivery dates. No API key or login needed.
Features
- No browser, no API key — pure HTTP calls to Pinterest's public API
- Filter by EU country, advertiser name, ad category, gender and age bucket
- Automatic detail enrichment (fetches full ad data per pin)
- Returns per-country reach, interest/device targeting and pinner-list types
- Outputs structured JSON ready for analysis
Input
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
country | string | Yes | ES | EU country code (ES, DE, FR…) |
startDate | string | No | 30 days ago | Ads shown from this date (YYYY-MM-DD) |
endDate | string | No | Today | Ads shown up to this date (YYYY-MM-DD) |
advertiserName | string | No | All | Filter by advertiser name (partial match) |
adCategory | string | No | Any | ALL, HOUSING, CREDIT or EMPLOYMENT |
gender | string | No | Any | UNSPECIFIED, FEMALE or MALE |
ageBucket | string | No | Any | Age range: AGE_18_24, AGE_25_34… AGE_65_PLUS |
maxResults | integer | No | 200 | Max ads to extract (1–5 000) |
proxyConfiguration | object | No | None | Optional proxy (EU IP may help) |
Example input
{"country": "ES","advertiserName": "adidas","maxResults": 50}
Output
Each dataset item represents one ad.
Common fields (shared across our DSA ad library scrapers)
| Field | Description |
|---|---|
adId | Durable ad identifier |
advertiser | Advertiser / brand |
adPayer | Entity that paid for the ad (null if not disclosed) |
firstShownDate / lastShownDate | Delivery period |
impressions | Impressions (null when the platform only reports reach) |
searchCountry | Country used in the search |
sourceUrl | Library endpoint the record came from |
is_natural_person_suspected | true if the advertiser/payer name looks like a private individual (heuristic). Treat flagged records as personal data under GDPR |
The platform-specific fields follow:
| Field | Type | Description |
|---|---|---|
pinId | string | Unique Pinterest pin/ad identifier |
advertiserNames | string[] | Advertiser names |
title | string | Ad creative title |
description | string | Ad description text |
imageUrl | string | Ad image URL |
videoUrl | string | Video URL (for video ads) |
startDate | string | Delivery start date |
endDate | string | Delivery end date |
ageBuckets | string[] | Age targeting buckets |
genders | string[] | Gender targeting |
countries | string[] | Targeted countries |
interests | string[] | Interest targeting categories |
devices | string[] | Device targeting |
keywordsUsed | boolean | Whether keyword targeting was used |
userCountByCountry | object | Reach per country (10K ranges) |
userCountEu | string | Total EU reach (10K ranges) |
contentCommercial | boolean | Declared as commercial communication |
isLocalInventory | boolean | Local inventory ad |
pinnerListTypes | string[] | Pinner list types for targeting |
searchCountry | string | Country used in the query |
scrapedAt | string | Extraction timestamp (ISO 8601) |
source | string | Always pinterest_ad_library |
Example output
{"adId": "1234567890123","advertiser": "adidas","adPayer": null,"firstShownDate": "2026-10-15","lastShownDate": null,"impressions": null,"sourceUrl": "https://api.pinterest.com/ads/v4/ads_repository/ad_library/1234567890123","is_natural_person_suspected": false,"pinId": "1234567890123","advertiserNames": ["adidas"],"title": "Ultraboost 22","description": "Run beyond limits","imageUrl": "https://i.pinimg.com/...","startDate": "2026-10-15","ageBuckets": ["AGE_25_34", "AGE_35_44"],"genders": ["FEMALE", "MALE"],"countries": ["ES", "FR", "DE"],"userCountByCountry": { "ES": "10000-20000", "FR": "20000-30000" },"userCountEu": "50000-60000","scrapedAt": "2026-11-12T10:30:00Z","source": "pinterest_ad_library"}
How it works
The scraper calls Pinterest's public Ads Repository API (GET /ads/v4/ads_repository/ad_library). No authentication is required.
- List pass — fetches paginated ad listings filtered by country, date, advertiser, etc.
- Detail pass — for each ad, calls the detail endpoint (
/ad_library/{pin_id}) to get full targeting and advertiser data (the list endpoint omits some fields).
Concurrent detail requests are limited to 5 at a time with exponential backoff on rate limits.
Notes
- Country is required by the Pinterest API. It defaults to
ES(Spain). - Start date defaults to 30 days ago if not specified.
- Reach counts are returned as ranges (e.g.
10000-20000), not exact numbers. - The API may require an EU IP for some country queries — use the proxy option if needed.
💰 How much does it cost to use Pinterest Ad Library Scraper?
Pinterest Ad Library Scraper uses pay-per-event pricing, so you only pay for the ads you get:
| Event | Price |
|---|---|
| Actor start (per GB of memory) | $0.0005 |
| Each ad record in the dataset | $0.0009 |
That works out to roughly $0.90 per 1,000 ads, platform compute included. A 10-ad test run costs about one cent. Use Max ads to cap what a run can cost.