Pinterest Ads Scraper

What is the Pinterest Ads Scraper?

The Pinterest Ads Scraper is an Apify actor designed to collect Pinterest ad data using customizable filters such as country, category, age, gender, and date ranges. This tool is ideal for marketing analysts, researchers, and media monitoring platforms that need structured access to Pinterest’s public ad repository.

---

🚀 Key Features

• 🔍 Filter by Date Range: Define a start and end date to get only relevant ads.
• 🌍 Country-Specific Scraping: Target specific countries using ISO Alpha-2 codes.
• 🧑‍🤝‍🧑 Demographic Filters: Narrow results by age groups and gender.
• 🗂️ Category Filtering: Choose from available Pinterest ad categories (or select ALL).
• 📈 Limit Results: Specify how many ads to retrieve.
• 📸 Includes Media Data: Extract image links and content details from each ad.

---

🎯 Filter Value Reference

The following reference tables outline the available input options for each filter. These values must be used exactly as listed when setting the corresponding input fields in the actor.

---

🌍 Countries (country input)

Use any of the following ISO Alpha-2 codes:

Label	Value
Austria	AT
Belgium	BE
Bulgaria	BG
Brazil	BR
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
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

---

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

🛠 Input Schema

The following fields are required or optional to customize your scraping task:

1{
2  "start_date": "2025-04-01",           // Required – format: YYYY-MM-DD
3  "end_date": "2025-04-12",             // Required – format: YYYY-MM-DD
4  "country": "FR",                      // Required – ISO Alpha-2 country code
5  "category": "ALL",                    // Optional – default is ALL
6  "age": "ALL",                         // Optional – values like "18-24", "25-34", etc.
7  "gender": "ALL",                      // Optional – "MALE", "FEMALE", or "UNSPECIFIED"
8  "results_limit": 50                   // Optional – max number of ads to fetch
9}

📤 Output Schema

Each ad record in the dataset will have the following structure:

1{
2	"pin_id": "969188782583356431",
3	"ad_details": {
4		"advertiser_names": null,
5		"statement_of_reasons": null,
6		"review_status": null,
7		"violation_source": null,
8		"violation_decision_means": null,
9		"start_date": "2025-03-21",
10		"end_date": "2025-04-09",
11		"age_buckets": [
12			"18-24",
13			"25-34",
14			"35-44",
15			"45-49",
16			"50-54",
17			"55-64",
18			"65+"
19		],
20		"genders": [
21			"FEMALE",
22			"MALE",
23			"UNSPECIFIED"
24		],
25		"postal_codes": [],
26		"metros": [],
27		"regions": [],
28		"countries": [
29			"France"
30		],
31		"content_commercial": true,
32		"interests": [],
33		"pinner_list_types": [
34			"USER_LIST",
35			"VISITOR"
36		],
37		"user_count_by_country": {
38			"France": "0 - 10000"
39		},
40		"user_count_eu": "0 - 10000",
41		"keywords_used": false,
42		"negative_keywords_used": false,
43		"image_link": "https://i.pinimg.com/474x/cc/69/cb/cc69cbaf7e657aec232ac2b4747346e4.jpg",
44		"pin_data": {
45			"image_link": "https://i.pinimg.com/474x/cc/69/cb/cc69cbaf7e657aec232ac2b4747346e4.jpg",
46			"video_link": null,
47			"details": "Beau pot en argile tortue de mer. Ce pot a été peint à la main en blanc",
48			"content_creator_name": null,
49			"story_pin_page_blocks": []
50		}
51	}
52}

Need to scrape ads from Google?

👉 Scrape Google ads with Google Ads Scraper

Need to scrape ads from Bing?

👉 Scrape Bing ads with Bing Ads Scraper

Need to scrape ads from TikTok?

👉 Scrape TikTok ads with TikTok Ads Scraper

Need to scrape ads from Reddit?

👉 Scrape Reddit ads with Reddit Ads Scraper

---

👀 p.s.

Got feedback or need an extension?

Lexis Solutions is a certified Apify Partner. We can help you with custom solutions or data extraction projects.

Contact us over Email or LinkedIn

Image Credit: Pinterest Ads Transparency