👻 Snapchat Ads Library Scraper

Scrape the Snapchat Ads Library by advertiser / brand name and pull every ad creative, headline, impression count, media download link, and the rest of the public ad metadata — at scale, in real time.

Why Choose Us?

• 🧠 Bulk advertiser input — feed in a list of brand names and the actor scrapes them one by one, tagging each result with the search query.
• 🛡️ Automatic proxy fallback — direct → datacenter → residential (with 3 retries on residential). You don't have to think about blocks.
• 💾 Live saving — every ad is pushed to the output table as soon as it is fetched, so a crash mid-run still leaves you with usable data.
• 🌍 EU-country & date filters — narrow to a single country or date range.
• 📡 Status filter — ACTIVE only, PAUSED only, or both.
• ⚡ No browser — pure HTTP, fast and cheap.

Key Features

• 🔎 Bulk search by paying_advertiser_name
• 🎬 Returns ad ID, name, ad type, brand, headline, impressions, media download URL, media type, status, and start date
• ⬇️ Direct download links to top-Snap media (image or video)
• 🟢 Filter by ACTIVE / PAUSED
• 🌍 Filter by EU country code
• 📅 Filter by date range
• 🛡️ Built-in rate-limit handling with proxy escalation
• 📊 Per-search-query tagging in every output row

Input

{
  "searchQueries": ["Ikea", "Nike"],
  "maxItems": 30,
  "country": "FR",
  "status": "ACTIVE",
  "startDate": "2025-01-01",
  "endDate": "2026-05-16",
  "proxyConfiguration": { "useApifyProxy": false }
}

Field	Type	Required	Description
searchQueries	array of strings	✅	Advertiser / brand names. Bulk supported. Use "" to fetch all ads.
maxItems	integer	❌	Max ads per query. Default 30.
country	string	❌	EU ISO-2 country code (e.g. FR, DE). Empty = all countries.
status	string	❌	ACTIVE, PAUSED, or empty for both.
startDate	string	❌	YYYY-MM-DD — only ads whose start_date is ≥ this.
endDate	string	❌	YYYY-MM-DD — only ads whose start_date is ≤ this.
proxyConfiguration	object	❌	Standard Apify proxy editor. Defaults to no proxy.

Output

Each row in the dataset:

{
  "searchQuery": "Ikea",
  "id": "ded3fe4b-8326-4423-bdfb-8d956de682b5",
  "adName": "Offre food 1 v2",
  "adType": "STORY",
  "payingAdName": "Ikea France",
  "accountName": "IKEA Global",
  "profileLogoUrl": "https://cf-st.sc-cdn.net/...",
  "profileName": "IKEA France",
  "brandName": "IKEA",
  "headline": "Menu étudiant au restaurant",
  "totalImpressions": 999232,
  "adStatus": "PAUSED",
  "snapMediaDownloadLink": null,
  "snapMediaType": null,
  "startDate": "2025-07-16T12:00:57.000Z"
}

Field	Description
searchQuery	The advertiser / brand keyword you searched for
id	Snapchat ad UUID
adName	Internal ad name from the advertiser
adType	SNAP_AD, STORY, REMOTE_WEBPAGE, DEEP_LINK, …
payingAdName	Paying advertiser entity
accountName	Ad account name on Snapchat
profileLogoUrl	Logo of the Snapchat profile that owns the ad
profileName	Display name of the profile
brandName	Brand string (falls back to first word of account name)
headline	Ad headline shown to viewers
totalImpressions	Lifetime impressions
adStatus	ACTIVE or PAUSED
snapMediaDownloadLink	Direct download link for the top-Snap media
snapMediaType	IMAGE or VIDEO
startDate	First-served timestamp (ISO 8601)

🚀 How to Use (Apify Console)

1. Log in at https://console.apify.com → Actors.
2. Open 👻 Snapchat Ads Library Scraper.
3. Enter one or more advertiser names in Search Queries.
4. (Optional) Pick a country, status, or date range.
5. Click Start.
6. Watch the logs — every ad is logged with brand, impressions, and headline.
7. Open the Output tab when the run completes.
8. Export to JSON / CSV / XLSX.

🤖 Use via API

curl -X POST "https://api.apify.com/v2/acts/<ACTOR_ID>/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "searchQueries": ["Ikea"],
       "maxItems": 50,
       "country": "FR",
       "status": "ACTIVE"
     }'

Best Use Cases

• 🕵️ Competitor ad intelligence on Snapchat
• 🎨 Creative inspiration — see what creatives a brand is actually running
• 📈 Tracking impressions of a specific advertiser over time
• 🧪 Market research across EU countries
• 📚 Building ad-library datasets for ML / analytics

Pricing

This actor uses Apify Pay-per-event. You pay per ad pushed to the dataset (billed as the synthetic apify-default-dataset-item event) plus the small apify-actor-start event. No platform usage is passed on by default.

Frequently Asked Questions

Do I need to be logged in to Snapchat? No. The Snapchat Ads Library is public and the actor calls it without auth.

Can I search by ad URL? The library exposes ads by advertiser name, not by ad URL. Use the searchQueries field with the advertiser / brand name.

What happens if I get rate-limited? Snapchat returns error_code: E1009 when an IP is being throttled. The actor detects this, falls back to a datacenter proxy, then to a residential proxy (retrying up to 3 times), and once residential is engaged it stays engaged.

Are EU-only results a hard limit? Yes — the Snapchat Ads Library currently only exposes ads served in the EU. Leaving country empty searches across the EU.

Why is the dataset growing while the run is in progress? The actor uses Actor.push_data live, so each ad lands in the output table the moment it's scraped — a crash partway through still leaves usable data.

Support and Feedback

Open an issue on the Actor page or contact dev.scraperengine@gmail.com.

Cautions / Legal

• Data is collected only from the publicly available Snapchat Ads Library.
• The end user is responsible for legal compliance (GDPR, CCPA, target-site ToS, etc.).
• Be a good citizen — keep maxItems reasonable to avoid hammering Snap's infrastructure.