Pinterest Ads Library Scraper

Scrape live ad campaigns, visual creatives, targeting data, and advertiser transparency metrics from the Pinterest Ads Library (Transparency Repository).

Extract advertiser profiles, high-resolution creative media (images & HD videos), destination landing pages, audience targeting demographics (countries, age buckets, genders), EU reach estimations, and campaign duration.

---

🌟 Key Features

• Live Ad Discovery — Real-time extraction directly from the official Pinterest Ads Transparency Repository.
• Dynamic Filtering — Search by advertiser/brand name, country, category vertical, gender, and age group.
• Rich Media Extraction — Captures highest-resolution original image creatives and direct MP4/HLS video URLs.
• Comprehensive Advertiser Profiles — Extracts brand name, Pinterest profile URL, account ID, verified merchant status, and domain link.
• Granular Targeting & Transparency — Extracts target countries, genders, age buckets, interests, and EU recipient reach estimates.
• Engagement & Timelines — Captures campaign start/end dates, saves/repins, comment counts, share counts, and dominant creative colors.
• Apify Integration — Ready for scheduled runs, webhook triggers, cloud datasets, and direct API export (JSON, CSV, Excel).

---

🎯 Use Cases

• Competitor Ad Monitoring: Track what ads competitors and industry leaders are running across Pinterest.
• Creative & Visual Benchmarking: Discover top-performing image & video formats, color palettes, and copy hooks.
• Audience Targeting Intelligence: Analyze how brands target specific demographics, age groups, and EU countries.
• E-Commerce & DTC Research: Discover trending products, discount offers, and conversion landing pages.

---

📥 Input Parameters

Field	Type	Default	Description
query	string	—	Optional advertiser/brand search text. Pinterest's live repository exposes advertiser-name search rather than a general keyword search.
advertiserName	string	—	Optional: specific Pinterest advertiser name to filter ads directly.
country	string	"FR"	Country code for the Ads Transparency Repository (e.g. FR, DE, ES, IT, GB, US, NL, BE, AT, BR, PL, SE).
adVertical	string	"ALL"	Category vertical (e.g. WOMENS_FASHION, BEAUTY, HOME_DECOR, SPORT, TRAVEL, FOOD_AND_DRINKS).
gender	string	"ALL"	Target audience gender filter (ALL, FEMALE, MALE, UNSPECIFIED).
ageBucket	string	"ALL"	Target audience age group (ALL, AGE_18_24, AGE_25_34, AGE_35_44, AGE_45_49, etc.).
maxItems	integer	50	Maximum number of ads to scrape (1 – 500).
proxyConfiguration	object	{ "useApifyProxy": true }	Proxy settings. Residential proxies recommended for high-volume jobs.

---

📤 Output Fields

Each dataset item contains rich structured data:

Field	Type	Description
adId	string	Unique identifier for the Pinterest ad / pin.
pinUrl	string	Direct web URL to the pin on Pinterest.
advertiserName	string	Name of the advertiser or brand.
advertiserId	string	Pinterest advertiser user ID.
advertiserUsername	string	Official Pinterest username / handle.
advertiserUrl	string	Advertiser website / official domain URL.
isVerifiedMerchant	boolean	Indicates if the advertiser is a verified merchant on Pinterest.
adTitle	string	Ad headline / creative title.
adDescription	string	Full ad copy text or pin description.
destinationUrl	string	Landing page URL where users are directed upon clicking.
adImageUrl	string	Full-resolution creative image URL.
videoUrl	string	Direct MP4 / HLS video stream URL for video ads.
adType	string	Creative format (image, video, carousel).
targetingCountries	array	List of countries targeted by the campaign.
targetingGenders	array	Targeted genders (FEMALE, MALE, UNSPECIFIED).
targetingAgeBuckets	array	Targeted age groups (e.g. ["18+"]).
targetingInterests	array	Targeted interest categories.
userCountEU	string	Estimated EU audience reach range.
userCountByCountry	object	Breakdown of estimated recipient reach per country.
startDate	string	Campaign start or first observed date.
endDate	string	Campaign end date (if applicable).
commercialContent	boolean	Flag indicating commercial advertisement status.
repinCount	integer	Total saves / repins on the ad creative.
commentCount	integer	Total comments on the ad pin.
shareCount	integer	Total shares on the ad creative.
dominantColor	string	Primary hex color code of the creative image.
searchQuery	string	Advertiser/brand search text used for the scrape, when supplied.
country	string	Country code filter used during the run.
scrapedAt	string	ISO timestamp of the scrape.

---

📋 Sample Output JSON

{
  "adId": "4593812444480190592",
  "pinUrl": "https://www.pinterest.com/pin/4593812444480190592/",
  "advertiserName": "Agapée | Jewelry",
  "advertiserId": "726205646072101387",
  "advertiserUsername": "agapee_official",
  "advertiserUrl": "https://agapee.com",
  "isVerifiedMerchant": true,
  "adTitle": "Lysia Blue Earrings",
  "adDescription": "The Lysia earrings feature drop-shaped pendants on small hoops, each with a blue stone hand-set in textured gold.",
  "destinationUrl": "https://agapee.com/products/lysia-blue-earrings?variant=50575005548870",
  "adImageUrl": "https://i.pinimg.com/originals/4d/04/7b/4d047b724360dcdb0f6f4eb231e84d56.jpg",
  "videoUrl": "https://v1.pinimg.com/videos/iht/expMp4/37/d8/af/37d8af2c7254b36fadaf7a483792deb8_720w.mp4",
  "adType": "video",
  "targetingCountries": [
    "France",
    "Germany",
    "Spain",
    "Italy",
    "Belgium",
    "Netherlands"
  ],
  "targetingGenders": [
    "FEMALE",
    "MALE",
    "UNSPECIFIED"
  ],
  "targetingAgeBuckets": [
    "18+"
  ],
  "targetingInterests": [],
  "userCountEU": "0 - 10000",
  "userCountByCountry": {
    "France": "0 - 10000",
    "Germany": "0 - 10000",
    "Spain": "0 - 10000"
  },
  "startDate": "2026-04-04",
  "endDate": "2026-08-25",
  "commercialContent": true,
  "repinCount": 12,
  "commentCount": 0,
  "shareCount": 1,
  "dominantColor": "#c27d5a",
  "searchQuery": "shoes",
  "country": "FR",
  "scrapedAt": "2026-08-25T12:00:00.000Z"
}

---

💡 Best Practices

1. Proxy Settings: For large batch extractions on the Apify platform, enable Apify residential proxies for best reliability.
2. Category & Advertiser Filters: Combine advertiserName or adVertical with country to zoom into specific market segments.
3. Automate & Schedule: Set up recurring runs (e.g., daily or weekly) to track newly launched campaigns and seasonal promotions automatically.