Pinterest Ad Library Scraper: EU Ads & Reach avatar

Pinterest Ad Library Scraper: EU Ads & Reach

Pricing

from $0.90 / 1,000 results

Go to Apify Store
Pinterest Ad Library Scraper: EU Ads & Reach

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

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

7 days ago

Last modified

Features

Limited permissions

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

ParameterTypeRequiredDefaultDescription
countrystringYesESEU country code (ES, DE, FR…)
startDatestringNo30 days agoAds shown from this date (YYYY-MM-DD)
endDatestringNoTodayAds shown up to this date (YYYY-MM-DD)
advertiserNamestringNoAllFilter by advertiser name (partial match)
adCategorystringNoAnyALL, HOUSING, CREDIT or EMPLOYMENT
genderstringNoAnyUNSPECIFIED, FEMALE or MALE
ageBucketstringNoAnyAge range: AGE_18_24, AGE_25_34… AGE_65_PLUS
maxResultsintegerNo200Max ads to extract (1–5 000)
proxyConfigurationobjectNoNoneOptional 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)

FieldDescription
adIdDurable ad identifier
advertiserAdvertiser / brand
adPayerEntity that paid for the ad (null if not disclosed)
firstShownDate / lastShownDateDelivery period
impressionsImpressions (null when the platform only reports reach)
searchCountryCountry used in the search
sourceUrlLibrary endpoint the record came from
is_natural_person_suspectedtrue if the advertiser/payer name looks like a private individual (heuristic). Treat flagged records as personal data under GDPR

The platform-specific fields follow:

FieldTypeDescription
pinIdstringUnique Pinterest pin/ad identifier
advertiserNamesstring[]Advertiser names
titlestringAd creative title
descriptionstringAd description text
imageUrlstringAd image URL
videoUrlstringVideo URL (for video ads)
startDatestringDelivery start date
endDatestringDelivery end date
ageBucketsstring[]Age targeting buckets
gendersstring[]Gender targeting
countriesstring[]Targeted countries
interestsstring[]Interest targeting categories
devicesstring[]Device targeting
keywordsUsedbooleanWhether keyword targeting was used
userCountByCountryobjectReach per country (10K ranges)
userCountEustringTotal EU reach (10K ranges)
contentCommercialbooleanDeclared as commercial communication
isLocalInventorybooleanLocal inventory ad
pinnerListTypesstring[]Pinner list types for targeting
searchCountrystringCountry used in the query
scrapedAtstringExtraction timestamp (ISO 8601)
sourcestringAlways 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.

  1. List pass — fetches paginated ad listings filtered by country, date, advertiser, etc.
  2. 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:

EventPrice
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.