Pricing
from $3.00 / 1,000 results
Snapchat Ads Gallery Scraper
Scrape the official Snapchat Ads Library API - search ads by advertiser, browse sponsored content, and search creator campaigns.
Pricing
from $3.00 / 1,000 results
Rating
0.0
(0)
Developer
Actor stats
0
Bookmarked
2
Total users
1
Monthly active users
a day ago
Last modified
Categories
Share
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 |
