Pinterest Ads Scraper

Extract comprehensive marketing data from the Pinterest Ad Library with ease. Collect targeting demographics, ad details, and creatives at scale. Perfect for competitive intelligence, ad monitoring, and market research.

---

Features

• Granular Filters — Filter by date range, country, category, age, and gender
• Demographic Targeting — Retrieve specific age buckets and gender targeting details
• Creative Extraction — Extract ad creatives including image links and content descriptions
• Customized Limits — Control the number of ads fetched to optimize runs

---

Use Cases

Competitive Analysis

Monitor competitors' active campaigns, messaging, and visual assets on Pinterest. Identify when they launch campaigns and what categories they target.

Market Trend Research

Understand regional advertising trends by analyzing ad counts, active durations, and demographic targeting configurations across different countries.

Demographic Profiling

Analyze which age ranges and genders are most heavily targeted within specific business categories to optimize your own audience targeting.

---

Input Parameters

The actor accepts the following input parameters:

Parameter	Type	Required	Default	Description
start_date	String	Yes	—	Start date for ad search (YYYY-MM-DD)
end_date	String	Yes	—	End date for ad search (YYYY-MM-DD)
country	String	Yes	—	Target country code (ISO Alpha-2)
category	String	No	"ALL"	Target ad category value
age	String	No	"ALL"	Target age bucket value
gender	String	No	"ALL"	Target gender value
results_limit	Integer	No	50	Maximum number of ads to retrieve

---

Filter Options

Use these value mappings to ensure proper input validation when using the actor via API or programmatically:

🌍 Countries (country input)

Use any of the following ISO Alpha-2 codes:

Label	Value
Austria	AT
Belgium	BE
Brazil	BR
Bulgaria	BG
Croatia	HR
Cyprus	CY
Czech Republic	CZ
Denmark	DK
Estonia	EE
Finland	FI
France	FR
Germany	DE
Greece	GR
Hungary	HU
Ireland	IE
Italy	IT
Latvia	LV
Lithuania	LT
Luxembourg	LU
Malta	MT
Netherlands	NL
Norway	NO
Poland	PL
Portugal	PT
Romania	RO
Slovakia	SK
Slovenia	SI
Spain	ES
Sweden	SE
Turkey	TR

---

🗂 Categories (category input)

Label	Value
All Categories	ALL
Animals	ANIMALS
Architecture	ARCHITECTURE
Art	ART
Beauty	BEAUTY
Children's fashion	CHILDRENS_FASHION
Design	DESIGN
DIY and crafts	DIY_AND_CRAFTS
Education	EDUCATION
Electronics	ELECTRONICS
Entertainment	ENTERTAINMENT
Event planning	EVENT_PLANNING
Finance	FINANCE
Food and drinks	FOOD_AND_DRINKS
Health	HEALTH
Home decor	HOME_DECOR
Gardening	GARDENING
Men's fashion	MENS_FASHION
Parenting	PARENTING
Quotes	QUOTES
Sport	SPORT
Travel	TRAVEL
Vehicles	VEHICLES
Wedding	WEDDING
Women's fashion	WOMENS_FASHION
Other	OTHER

---

🎂 Ages (age input)

Label	Value
All Ages	ALL
18–24	AGE_18_24
21–24	AGE_21_24
18–20	AGE_18_20
25–34	AGE_25_34
35–44	AGE_35_44
45–49	AGE_45_49
50–54	AGE_50_54
55–64	AGE_55_64
65+	AGE_65_PLUS

---

⚥ Genders (gender input)

Label	Value
All Genders	ALL
Male	MALE
Female	FEMALE
Unspecified	UNSPECIFIED

---

Output Data

Each item in the dataset contains the following fields:

Field	Type	Description
pin_id	String	Unique identifier of the pin
ad_details_start_date	String	Campaign launch date
ad_details_end_date	String	Campaign end date
ad_details_age_buckets	String	Targeted age ranges as a comma-separated list
ad_details_genders	String	Targeted genders as a comma-separated list
ad_details_countries	String	Targeted countries as a comma-separated list
ad_details_content_commercial	Boolean	Whether the ad is marked as commercial content
ad_details_user_count_by_country	String	Country-level audience estimate summary
ad_details_user_count_eu	String	EU-wide audience estimate summary
ad_details_image_link	String	URL of the main creative
ad_details_pin_data_image_link	String	URL of the pin image asset
ad_details_pin_data_title	String	Title of the advertised pin
ad_details_pin_data_details	String	Ad caption or text copy

Only populated values are included in each record, so some optional columns appear only when Pinterest provides them.

---

Usage Examples

Retrieve German Home Decor Ads

Filter ads in Germany specifically related to Home Decor:

{
  "start_date": "2026-01-01",
  "end_date": "2026-06-01",
  "country": "DE",
  "category": "HOME_DECOR",
  "age": "ALL",
  "gender": "ALL",
  "results_limit": 20
}

Age-Targeted Campaign Scraping

Fetch ads targeting young adults (18-24) in France:

{
  "start_date": "2026-01-01",
  "end_date": "2026-06-01",
  "country": "FR",
  "category": "ALL",
  "age": "AGE_18_24",
  "gender": "ALL",
  "results_limit": 50
}

Female-Targeted Beauty Ads in Spain

Filter specifically for female demographic beauty ads:

{
  "start_date": "2026-01-01",
  "end_date": "2026-06-01",
  "country": "ES",
  "category": "BEAUTY",
  "age": "ALL",
  "gender": "FEMALE",
  "results_limit": 100
}

---

Sample Output

{
  "pin_id": "4602327078024214784",
  "ad_details_start_date": "2026-04-02",
  "ad_details_end_date": "2026-06-12",
  "ad_details_age_buckets": "18+",
  "ad_details_genders": "UNSPECIFIED, FEMALE, MALE",
  "ad_details_countries": "Italy",
  "ad_details_content_commercial": true,
  "ad_details_is_local_inventory": false,
  "ad_details_has_excluded_locations": false,
  "ad_details_user_count_by_country": "Italy: 0 - 10000",
  "ad_details_user_count_eu": "0 - 10000",
  "ad_details_keywords_used": false,
  "ad_details_negative_keywords_used": false,
  "ad_details_image_link": "https://i.pinimg.com/474x/35/18/f9/3518f9b5222df2ac47c3d2db86049c25.jpg",
  "ad_details_pin_data_image_link": "https://i.pinimg.com/474x/35/18/f9/3518f9b5222df2ac47c3d2db86049c25.jpg",
  "ad_details_pin_data_title": "Pantaloni pieghetti Meraner | Comoda e alla moda vestibilità dritta",
  "ad_details_pin_data_details": "Valorizza il tuo look quotidiano con i pantaloni plissettati Merano..."
}

---

Tips for Best Results

Date Ranges

• Avoid requesting excessively large date ranges at once.
• Fetch in smaller chunks (e.g., monthly) to avoid hitting limits or timeouts.

Handling Empty Fields

• The actor skips null and empty values, so only populated fields are written to the dataset.
• Optional fields can vary by ad and by market depending on what Pinterest exposes publicly.

---

Integrations

Connect your data with:

• Google Sheets — Export for analysis
• Airtable — Build searchable databases
• Slack — Get notifications
• Webhooks — Send to custom endpoints
• Make — Create automated workflows
• Zapier — Trigger actions

Export Formats

Download data in multiple formats:

• JSON — For developers and APIs
• CSV — For spreadsheet analysis
• Excel — For business reporting
• XML — For system integrations

---

Frequently Asked Questions

Can I run this without proxies?

For stable runs and bypassing blocks, we recommend utilizing Apify's proxy options.

What are the correct codes for filters?

Please check the tables in the Filter Options section above for the valid country codes, category values, age parameters, and gender formats.

How is the pricing calculated?

Pricing is based on computing power (CU) consumed per run. Optimize your limits to reduce costs.

---

Support

For issues or feature requests, contact support through the Apify Console.

Resources

• Apify Documentation
• API Reference
• Scheduling Runs

---

Legal Notice

This actor is designed for legitimate data collection purposes. Users are responsible for ensuring compliance with website terms of service and applicable laws. Use data responsibly and respect rate limits.