👻 Snapchat Ads Creative Analyzer

Scrape the Snapchat Ads Library by advertiser / brand name and get a full creative-analysis breakdown for every ad — headline length, call-to-action detection, media presence, creative format, and brand-in-headline — plus impression / media / CTA filters and automatic de-duplication of identical creatives.

Built on the Snapchat Ads Library scraper engine (pure HTTP, no browser, no login), this variant adds a creative-intelligence layer on top of every row.

What's New vs. the Base Scraper

• 🎨 Per-ad creative analysis — each row is enriched with creativeFormat, headlineWordCount, headlineCharCount, headlineHasCta, detectedCtaKeywords, hasMedia, and brandInHeadline. Every value is computed from the real ad data (headline text, ad type, media type, brand).
• 🧹 Row-reducing filters — minImpressions, requireMedia, and ctaOnly drop non-matching creatives before they are saved, and the run log reports exactly how many rows each filter removed.
• ♻️ Creative de-duplication — ads with the same headline + adType + brandName are collapsed to a single row (dropped-duplicate count logged).

Core Features (from the base engine)

• 🔎 Bulk search by advertiser / brand name (paying_advertiser_name)
• 🎬 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 (direct → datacenter → residential, 3 retries)
• 💾 Live saving — every qualifying ad is pushed the moment it is analyzed
• 📊 Per-search-query tagging in every output row

Input

{
  "searchQueries": ["McDonald's", "Nike"],
  "maxItems": 20,
  "country": "FR",
  "status": "ACTIVE",
  "startDate": "2025-01-01",
  "endDate": "2026-05-16",
  "minImpressions": 1000,
  "requireMedia": false,
  "ctaOnly": false,
  "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 retrieved per query. Filters/dedup are applied afterward, so saved rows may be fewer. Default 10.
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.
minImpressions	integer	❌	Only save ads with totalImpressions ≥ this. Missing = 0. Default 0.
requireMedia	boolean	❌	Only save ads that have a downloadable media link. Default false.
ctaOnly	boolean	❌	Only save ads whose headline contains a CTA keyword. Default false.
proxyConfiguration	object	❌	Standard Apify proxy editor. Defaults to no proxy.

Output

Each row preserves every base field and adds the creative-analysis fields:

{
  "searchQuery": "McDonald's",
  "id": "ded3fe4b-8326-4423-bdfb-8d956de682b5",
  "adName": "Offre food 1 v2",
  "adType": "STORY",
  "payingAdName": "McDonald's France",
  "accountName": "McDonald's Global",
  "profileLogoUrl": "https://cf-st.sc-cdn.net/...",
  "profileName": "McDonald's France",
  "brandName": "McDonald's",
  "headline": "Get the McSmart menu — order now",
  "totalImpressions": 999232,
  "adStatus": "PAUSED",
  "snapMediaDownloadLink": null,
  "snapMediaType": null,
  "startDate": "2025-07-16T12:00:57.000Z",
  "creativeFormat": "story_ad",
  "headlineWordCount": 6,
  "headlineCharCount": 32,
  "headlineHasCta": true,
  "detectedCtaKeywords": ["get", "order"],
  "hasMedia": false,
  "brandInHeadline": false
}

Base fields

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)

Creative-analysis fields (new)

Field	Description
creativeFormat	Derived format: story_ad, video_snap, image_snap, ar_lens, collection, commercial, or the lower-cased ad type
headlineWordCount	Number of words in the headline
headlineCharCount	Number of characters in the headline
headlineHasCta	true if the headline contains a CTA keyword
detectedCtaKeywords	The CTA keywords actually found (shop, buy, learn more, sign up, download, get, order, discover)
hasMedia	true if snapMediaDownloadLink is present
brandInHeadline	true if a brand-name token appears in the headline

🚀 How to Use (Apify Console)

1. Log in at https://console.apify.com → Actors.
2. Open 👻 Snapchat Ads Creative Analyzer.
3. Enter one or more advertiser names in Search Queries.
4. (Optional) Pick a country, status, or date range, and set the creative filters (minImpressions, requireMedia, ctaOnly).
5. Click Start.
6. Watch the logs — every ad is logged, and a filter summary reports how many rows each filter removed.
7. Open the Output tab when the run completes and 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": ["Nike"],
       "maxItems": 50,
       "minImpressions": 1000,
       "ctaOnly": true
     }'

Best Use Cases

• 🕵️ Competitor creative intelligence on Snapchat
• 🎨 Studying which CTA phrasing and creative formats a brand actually runs
• 📈 Filtering to only high-impression creatives for benchmarking
• 🧪 Building clean, de-duplicated ad-creative datasets for ML / analytics

Pricing

This actor uses Apify Pay-per-event. You pay per ad row pushed to the dataset plus the small 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.

Why did I get fewer rows than maxItems? maxItems bounds how many ads are retrieved per query. The creative filters (minImpressions, requireMedia, ctaOnly) and de-duplication then reduce the rows that are actually saved. The run log shows the exact counts removed.

How is headlineHasCta computed? The headline text is scanned for the CTA keywords listed above. Single-word keywords require a whole-word match (so "getaway" does not trigger "get").

What happens if I get rate-limited? Snapchat returns error_code: E1009 when an IP is 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.

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.