Snapchat Ads Gallery Scraper

Access Snapchat's official public Ads Library API to search for ads by advertiser name, browse all sponsored content, or find creator-sponsored posts by creator. Extracts ad creative metadata, impression data, targeting information, media download links, and sponsored content details — all from Snapchat's transparency-mandated open API with no login required.

What It Does

Three scraping modes are available:

• adSearch — search ads by advertiser name with optional filters for EU country, date range, and ad status. Returns up to 10 ads per advertiser (API limit).
• sponsoredContent — browse all publicly disclosed sponsored and branded content with full pagination support (up to 10,000 records).
• creatorSearch — find sponsored content posts associated with a specific creator username or name.

No login, cookies, or browser automation required. Uses Snapchat's official open Ads Library API (adsapi.snapchat.com/v1/ads_library) which is publicly mandated under EU digital advertising transparency regulations.

Input

Field	Type	Required	Default	Description
mode	select	No	adSearch	Scraping mode: adSearch, sponsoredContent, or creatorSearch
payingAdvertiserName	string	No	—	For adSearch: advertiser name to search (e.g., nike, coca-cola, amazon)
countries	string[]	No	all	EU country codes to filter by. Valid codes: de, fr, it, es, pl, nl, be, se, at, pt, cz, ro, hu, dk, fi, sk, bg, hr, lt, lv, lu, si, ee, el, mt, ie, cy. Note: gb (UK) is not supported by the Snapchat API.
startDate	string	No	—	Filter ads active from this date (ISO 8601, e.g., 2025-01-01T00:00:00.000Z)
endDate	string	No	—	Filter ads active until this date (ISO 8601)
status	select	No	ALL	Ad status filter: ACTIVE, PAUSED, or ALL
creatorName	string	No	—	For creatorSearch: creator username or display name to search
maxResults	integer	No	200	Maximum records to return (1–10,000). Note: adSearch mode is capped at 10 by the API.
proxyConfiguration	object	No	null	Apify proxy configuration (optional)

Example input (ad search):

{
  "mode": "adSearch",
  "payingAdvertiserName": "nike",
  "countries": ["fr", "de"],
  "startDate": "2025-01-01T00:00:00.000Z",
  "status": "ACTIVE",
  "maxResults": 10
}

Example input (browse sponsored content):

{
  "mode": "sponsoredContent",
  "maxResults": 500
}

Example input (creator search):

{
  "mode": "creatorSearch",
  "creatorName": "beauty",
  "maxResults": 100
}

Output

One record per ad or sponsored content item pushed to the Apify dataset. The recordType field identifies which mode produced the record.

Ad record (recordType: "ad" — adSearch mode)

Field	Type	Description
adId	string	Unique ad identifier
adName	string	Internal ad name set by the advertiser
adAccountName	string	Advertiser account name
payingAdvertiserName	string	Paying entity name as disclosed in the library
profileName	string	Public profile name shown in the ad
profileLogoUrl	string	Advertiser logo CDN URL
headline	string	Ad headline text
adType	string	Ad format type (e.g., SNAP_AD)
adRenderType	string	Ad render type identifier
creativeType	string	Creative type (e.g., VIDEO, IMAGE)
callToAction	string	Call-to-action button label (e.g., SHOP_NOW, LEARN_MORE)
topSnapMediaType	string	Top snap media type
topSnapCropPosition	string	Crop position for top snap media
mediaDownloadUrl	string	Direct CDN URL to download the ad creative (video or image)
webViewProperties	object	Web view destination properties
languages	string[]	Languages the ad targets
startDate	string	Ad start date
status	string	Current status: ACTIVE or PAUSED
reviewStatus	string	Ad review status
rejectionReasons	string[]	Rejection reason codes if ad was rejected
impressionsTotal	integer	Total impression count across all regions
impressionsMap	object	Per-country impression breakdown (country code → count)
targetingV2	object	Raw targeting parameters from the API
stickers	object	Sticker data if present
dpaPreview	object	Dynamic product ad preview data if present
recordType	string	Always "ad" for this mode
scrapedAt	string	Scrape timestamp (ISO 8601 UTC)

Sponsored content record (recordType: "sponsoredContent" — sponsoredContent / creatorSearch modes)

Field	Type	Description
contentType	string	Content type (e.g., SPOTLIGHT)
contentUrl	string	Direct URL to the sponsored content post
thumbnailUrl	string	Content thumbnail CDN URL
creatorName	string	Creator username who posted the content
creatorUrl	string	Creator profile URL (snapchat.com/add/{username})
sponsorName	string	Brand or sponsor display name
sponsorUrl	string	Sponsor profile URL
recordType	string	Always "sponsoredContent" for this mode
scrapedAt	string	Scrape timestamp (ISO 8601 UTC)

Example ad record output:

{
  "adId": "123456789",
  "adName": "Nike Summer 2025 FR",
  "adAccountName": "Nike Europe",
  "payingAdvertiserName": "Nike",
  "profileName": "Nike",
  "profileLogoUrl": "https://cf-st.sc-cdn.net/...",
  "headline": "Just Do It",
  "adType": "SNAP_AD",
  "adRenderType": "STANDARD",
  "creativeType": "VIDEO",
  "callToAction": "SHOP_NOW",
  "mediaDownloadUrl": "https://creative.snapchat.com/...",
  "languages": ["fr"],
  "startDate": "2025-06-01",
  "status": "ACTIVE",
  "reviewStatus": "APPROVED",
  "impressionsTotal": 1500000,
  "impressionsMap": {"fr": 900000, "de": 600000},
  "recordType": "ad",
  "scrapedAt": "2026-06-28T10:00:00.000000+00:00"
}

Example sponsored content record output:

{
  "contentType": "SPOTLIGHT",
  "contentUrl": "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYeWVyZGt1ZHVzAZ6jJBbTAZ6jJBa7AAAAAQ",
  "thumbnailUrl": "https://cf-st.sc-cdn.net/o/64pAgd2mdHnAgKzdFa1an.256.IRZXSOY",
  "creatorName": "beauty_creator",
  "creatorUrl": "https://www.snapchat.com/add/beauty_creator",
  "sponsorName": "Sephora",
  "sponsorUrl": "https://www.snapchat.com/add/sephora",
  "recordType": "sponsoredContent",
  "scrapedAt": "2026-06-28T10:00:00.000000+00:00"
}

FAQ

Is this official Snapchat data? Yes. The actor uses Snapchat's official Ads Library API (adsapi.snapchat.com/v1/ads_library), publicly available without authentication under EU digital advertising transparency mandates (DSA). No scraping of private pages is involved.

Why does adSearch return only up to 10 ads? The Snapchat Ads Library API enforces a hard limit of 10 results per advertiser search request and does not support pagination in this endpoint. This is a platform constraint, not an actor limitation. Use sponsoredContent or creatorSearch mode if you need larger volumes.

Which countries are supported? EU member states only: de, fr, it, es, pl, nl, be, se, at, pt, cz, ro, hu, dk, fi, sk, bg, hr, lt, lv, lu, si, ee, el, mt, ie, cy. The UK (gb) is not currently supported by Snapchat's API and will return a 400 error if included.

Can I download the actual ad video? Yes — the mediaDownloadUrl field in ad records contains a direct CDN link to the ad creative (video or image file) that can be downloaded directly.

What does impressionsMap contain? A JSON object mapping each EU country code to its impression count for that ad. For example: {"fr": 900000, "de": 600000} means 900,000 impressions in France and 600,000 in Germany.

What is the difference between sponsoredContent and creatorSearch mode? sponsoredContent browses the full public library of all sponsored posts with pagination — useful for bulk collection. creatorSearch searches for sponsored content by a specific creator name and returns the first page of matching results. Both produce the same sponsoredContent output format.

How much data can I collect with sponsoredContent mode? The Snapchat API returns up to 200 items per page, and the actor follows pagination links automatically. You can set maxResults up to 10,000 to collect large volumes of sponsored content records.

Other Snapchat Scrapers

Explore the full Snapchat scraper suite on Apify:

Actor	Description
Snapchat Profile Scraper	Full profile metadata, highlights, lenses, and spotlight data
Snapchat Hashtag Scraper	Spotlight videos by hashtag or topic with AI metadata
Snapchat User Stories Scraper	Curated highlights and active story snaps
Snapchat Spotlight Video Downloader	Download Spotlight videos with AI metadata, transcripts, and comments
Snapchat Search Scraper	Search across videos, lenses, users, places, and shows
Snapchat Lens Scraper	AR lens metadata, trending lenses, and creator info
Snapchat Publisher Scraper	Discover publisher pages, shows, episodes, and spotlights
Snapchat Ads Gallery Scraper	EU/UK ad transparency library — ads and sponsored content
Snapchat Spotlight Comments Scraper	Comment threads from Spotlight videos
Snapchat Topic Scraper	Spotlight videos by topic with related tags
Snapchat Snapcode Scraper	Download Snapcode images (SVG/PNG) for any username
Snapchat Snap Map Scraper	Public Snap Map places and their latest snaps
Snapchat Discover Scraper	Shows and stories from Snapchat's Discover feed