Pinterest Ads Scraper

Apify Actor that scrapes Pinterest Ads Library by date range and country.

Logic (from pin-ads.py)

1. Bulk fetch – Paginated fetch from /ads/v4/ads_repository/ad_library (page_size 24)
2. Individual fetch – Per-pin details from /ads/v4/ads_repository/ad_library/{pin_id}
3. Concurrency – 5 concurrent requests, batch size 10
4. Retry – 2 attempts with 1s delay

Input

Field	Required	Description
start_date	Yes	YYYY-MM-DD
end_date	Yes	YYYY-MM-DD
country	Yes	Country name (e.g. France)
resultsLimit	No	Max ads (default 100)
proxyConfiguration	No	Optional proxy

Output

Each record: { "pin_id": "...", "ad_details": { ... } }

ad_details includes: advertiser_names, start_date, end_date, countries, user_count_by_country, image_link, pin_data (title, details, etc.)

Run

pip install -r requirements.txt
python -m src