Documentation

Learn how to integrate AdSnapshot into your application and start capturing high-quality ad previews

Quick Start

Get up and running in minutes with our simple API

https://adsnapshot.com/get/API_KEY/AD_ID?format=MOBILE_FEED_STANDARD

Replace API_KEY with your API key and AD_ID with the Meta ad ID for the preview you want to generate. The API returns a PNG image. Your first request for a specific ad ID creates a new preview and counts as a generation. Subsequent requests for the same ad ID will return the cached preview and count as retrievals, unless you include refresh=true to force a new generation.

Fast Response

Cached retrievals delivered in milliseconds

Secure

API key authentication and account-level access control

Always Fresh

Generate new previews using refresh=true

Integration Guides

Google Sheets Integration

Display ad previews directly in your Google Sheets using the IMAGE function

=IMAGE("https://adsnapshot.com/get/API_KEY/AD_ID")

Replace API_KEY and AD_ID with your values. You can reference cells containing these values:

=IMAGE(CONCATENATE("https://adsnapshot.com/get/", A1, "/", B1))

Note: Each view counts as a retrieval. Add refresh=true parameter only when you need a fresh generation.

Looker Studio Integration

Add ad previews to your Looker Studio dashboards using the Image URL field type

Steps to integrate:

Create a calculated field in your data source
Use the following formula to construct the AdSnapshot URL:
CONCAT("https://adsnapshot.com/get/YOUR_API_KEY/", Ad_ID)
Set the calculated field type to "Image URL"
Add an Image viewer to your dashboard and select the calculated field

Pro Tip: Each dashboard view uses retrievals by default. Add the refresh=true parameter when you need to generate fresh previews, but be mindful as this will count against your generation quota.

API Reference

adsnapshot.com/get/{key}/{adId}

Generate and retrieve ad previews as PNG images

Query Parameters

format optional

Preview format (default: MOBILE_FEED_STANDARD)

Choose the format that matches where your ad will be displayed

refresh optional

Force a new generation instead of retrieving cached preview

Counts as a generation. Use when you've updated the ad and need a fresh preview

wait optional

Wait time in milliseconds before capturing (default: 0)

Useful for ads with animations or loading states

Supported Preview Formats

Available ad preview formats for different placements

FACEBOOK_REELS_BANNER_DESKTOP

FACEBOOK_STORY_MOBILE

INSTREAM_BANNER_DESKTOP

INSTAGRAM_REELS

INSTAGRAM_REELS_OVERLAY

INSTAGRAM_STANDARD

INSTAGRAM_STORY

MESSENGER_MOBILE_INBOX_MEDIA

MESSENGER_MOBILE_STORY_MEDIA

MOBILE_FEED_STANDARD