VOOZH about

URL: https://apify.com/crawlerbros/snapchat-ads-gallery-scraper

โ‡ฑ Snapchat Ads Gallery Scraper ยท Apify


Pricing

from $3.00 / 1,000 results

Go to Apify Store

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

๐Ÿ‘ Crawler Bros

Crawler Bros

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

a day ago

Last modified

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

FieldTypeRequiredDefaultDescription
modeselectNoadSearchScraping mode: adSearch, sponsoredContent, or creatorSearch
payingAdvertiserNamestringNoโ€”For adSearch: advertiser name to search (e.g., nike, coca-cola, amazon)
countriesstring[]NoallEU 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.
startDatestringNoโ€”Filter ads active from this date (ISO 8601, e.g., 2025-01-01T00:00:00.000Z)
endDatestringNoโ€”Filter ads active until this date (ISO 8601)
statusselectNoALLAd status filter: ACTIVE, PAUSED, or ALL
creatorNamestringNoโ€”For creatorSearch: creator username or display name to search
maxResultsintegerNo200Maximum records to return (1โ€“10,000). Note: adSearch mode is capped at 10 by the API.
proxyConfigurationobjectNonullApify 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)

FieldTypeDescription
adIdstringUnique ad identifier
adNamestringInternal ad name set by the advertiser
adAccountNamestringAdvertiser account name
payingAdvertiserNamestringPaying entity name as disclosed in the library
profileNamestringPublic profile name shown in the ad
profileLogoUrlstringAdvertiser logo CDN URL
headlinestringAd headline text
adTypestringAd format type (e.g., SNAP_AD)
adRenderTypestringAd render type identifier
creativeTypestringCreative type (e.g., VIDEO, IMAGE)
callToActionstringCall-to-action button label (e.g., SHOP_NOW, LEARN_MORE)
topSnapMediaTypestringTop snap media type
topSnapCropPositionstringCrop position for top snap media
mediaDownloadUrlstringDirect CDN URL to download the ad creative (video or image)
webViewPropertiesobjectWeb view destination properties
languagesstring[]Languages the ad targets
startDatestringAd start date
statusstringCurrent status: ACTIVE or PAUSED
reviewStatusstringAd review status
rejectionReasonsstring[]Rejection reason codes if ad was rejected
impressionsTotalintegerTotal impression count across all regions
impressionsMapobjectPer-country impression breakdown (country code โ†’ count)
targetingV2objectRaw targeting parameters from the API
stickersobjectSticker data if present
dpaPreviewobjectDynamic product ad preview data if present
recordTypestringAlways "ad" for this mode
scrapedAtstringScrape timestamp (ISO 8601 UTC)

Sponsored content record (recordType: "sponsoredContent" โ€” sponsoredContent / creatorSearch modes)

FieldTypeDescription
contentTypestringContent type (e.g., SPOTLIGHT)
contentUrlstringDirect URL to the sponsored content post
thumbnailUrlstringContent thumbnail CDN URL
creatorNamestringCreator username who posted the content
creatorUrlstringCreator profile URL (snapchat.com/add/{username})
sponsorNamestringBrand or sponsor display name
sponsorUrlstringSponsor profile URL
recordTypestringAlways "sponsoredContent" for this mode
scrapedAtstringScrape 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:

ActorDescription
Snapchat Profile ScraperFull profile metadata, highlights, lenses, and spotlight data
Snapchat Hashtag ScraperSpotlight videos by hashtag or topic with AI metadata
Snapchat User Stories ScraperCurated highlights and active story snaps
Snapchat Spotlight Video DownloaderDownload Spotlight videos with AI metadata, transcripts, and comments
Snapchat Search ScraperSearch across videos, lenses, users, places, and shows
Snapchat Lens ScraperAR lens metadata, trending lenses, and creator info
Snapchat Publisher ScraperDiscover publisher pages, shows, episodes, and spotlights
Snapchat Ads Gallery ScraperEU/UK ad transparency library โ€” ads and sponsored content
Snapchat Spotlight Comments ScraperComment threads from Spotlight videos
Snapchat Topic ScraperSpotlight videos by topic with related tags
Snapchat Snapcode ScraperDownload Snapcode images (SVG/PNG) for any username
Snapchat Snap Map ScraperPublic Snap Map places and their latest snaps
Snapchat Discover ScraperShows and stories from Snapchat's Discover feed

You might also like

Snapchat Spotlight Comments Scraper

crawlerbros/snapchat-spotlight-comments-scraper

Scrape comment threads from Snapchat Spotlight videos - by individual spotlight URL or by creator username.

Snapchat Discover Scraper

crawlerbros/snapchat-discover-scraper

Scrape Snapchat Discover page - extract premium publisher stories, episodes, and their snap details from the Apollo GraphQL cache.

Snapchat Snapcode Scraper

crawlerbros/snapchat-snapcode-scraper

Download Snapchat snapcode images (QR codes) in SVG or PNG format for any public username.

Snapchat Ads Scraper [PPR]

zadexinho/snapchat-ads-scraper

Extract commercial ads from Snapchat's Ads Gallery across 27 EU countries. Search by advertiser name, filter by country, date range, and ad status. Returns ad ID, headline, impressions, creative type, CTA, campaign dates, and media URLs. No login required.

Snapchat Ads Mcp Server [PPR]

zadexinho/snapchat-ads-mcp-server

MCP server providing Snapchat Ads Gallery data to AI agents. Search EU commercial ads by advertiser name, country, date range, and status. Returns impressions, headlines, CTAs, and creative metadata for 27 EU countries. No login required.

Snapchat Ads Scraper

khadinakbar/snapchat-ads-scraper

Scrape Snapchat ads from the official Ads Gallery API + Political Ads Library โ€” creatives, impressions, targeting, and spend.

Snapchat Ads Scraper

lexis-solutions/snapchat-ads-scraper

Extract data from ads shown on the Snapchat platform. Download and analyze data from the Snap Ads Gallery for competitive analysis.

๐Ÿ‘ User avatar

Lexis Solutions

53

3.4

(6)

Snapchat Spotlight Video Downloader

crawlerbros/snapchat-spotlight-video-downloader

Download Snapchat Spotlight videos. Provide one or more Spotlight URLs and get direct CDN video links, thumbnails, captions, creator info, and engagement stats.

84

Snapchat Profile Scraper

crawlerbros/snapchat-profile-scraper

Scrape public profile metadata from Snapchat user profiles. Provide usernames or profile URLs and get display name, verification status, subscriber count, bio, avatar, story highlights, related accounts, and external links with one record per username.

34

Snapchat User Stories Scraper

crawlerbros/snapchat-user-stories-scraper

Scrape curated highlight stories from public Snapchat profiles. Provide usernames or profile URLs and get direct media URLs, thumbnails, story titles, and creator metadata with one record per snap.

11