AdLib

Built for

Go to dashboardLog inStart free
Snapchat Ads Gallery

Snapchat Ads Gallery API

Ads from Snapchat's Ads Gallery by paying advertiser or domain, with the creative, landing page, impressions per country and targeting.

Get 5,000 free credits a monthRead the quickstart
Coverage
Ads delivered in the 27 EU countries in the last 12 months.
Price
1 credit per ad. 1 credit per delivered ad. A live search page costs at most 5 credits, however many ads it returns. Ads last shown more than 12 months ago cost double. Empty, cached and failed results are free.
Status
Snapchat says whether an ad is active or paused: status is active or inactive. Filter with status=active or status=inactive.

Find ads by

  • Paying advertiser name (advertiser=…)
  • Advertiser id (advertiser=snapchat:<name>): the paying advertiser's name
  • Domain (domain=…): the brand name, kept when the ads' landing URLs are on the domain
  • Ad id (GET /v1/ads/snapchat:{id})
  • Our archive (source=history)

Filters

  • country: one of the 27 EU countries
  • from / to
  • status: active or inactive
  • format: image, video or carousel, applied to each page, so pages can come back shorter

What you get for each ad

The same fields as every other platform, in one schema. What Snapchat publishes is filled in; what it does not stays null.

Ad and advertiser

id
snapchat:<ad id>
advertiser.name
The paying advertiser
status
active or inactive
first_shown, last_shown
Start and end of delivery
extra.profile_name, extra.ad_account_name
The Snapchat profile and ad account

Creative

formats
image, video, or carousel for product ads with several items
creatives[].headline, cta, landing_url
Headline, call to action and web link
placements
Always snapchat

Delivery

impressions_range
Total impressions as an exact number (lower and upper are equal)
extra.impressions_by_country
Impressions per country
countries
Countries with impressions

Only for ads shown in the EU

Published under the Digital Services Act; see EU reach.

  • eu_data.targeting.ages, genders and locations
  • eu_data.targeting.other: languages, devices (operating system) and regulated content
  • eu_data.payer: the paying advertiser
  • Every ad in the gallery was shown in the EU, so these come with every ad

What Snapchat does not publish

  • Spend: spend_range is null
  • Reach: Snapchat publishes impressions, so eu_data.reach_total is null
  • Beneficiary separate from the payer
  • Keyword search in the ad text

Try it

An advertiser's active Snapchat ads in France, with impressions per country and targeting.

Media: The ad's image or video, and product images for product ads. Images are copied to media.adlibapi.com under stable URLs, and videos are archived for advertisers on a watchlist.

curl "https://api.adlibapi.com/v1/search?platform=snapchat&advertiser=…&country=FR&status=active" \
  -H "X-API-Key: $ADLIB_API_KEY"

What to do with it

  • See how many impressions a competitor's Snapchat ads got per EU country.
  • Get an alert when a brand starts or pauses Snapchat ads.

Limits

  • No keyword search: start from an advertiser or a domain.
  • The gallery searches the paying advertiser, which can be an agency rather than the brand.
  • library_url points to the gallery's start page, not to the single ad.

Questions

Does Snapchat have an ad library?
Yes, the Ads Gallery, for ads delivered in the EU. AdLib returns it through a REST API in the same schema as the other platforms.
Can I see impressions for Snapchat ads?
Yes. Snapchat publishes impressions for every ad in the gallery, in total and per country, in impressions_range and extra.impressions_by_country. No spend.
Can I see Snapchat ad targeting?
Yes: age, gender, locations, languages and devices, in eu_data.targeting.

Read more

Other platforms

Questions about Snapchat data? [email protected]