# Snapchat Ads Scraper (`lexis-solutions/snapchat-ads-scraper`) Actor

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

- **URL**: https://apify.com/lexis-solutions/snapchat-ads-scraper.md
- **Developed by:** [Lexis Solutions](https://apify.com/lexis-solutions) (community)
- **Categories:** Social media, Lead generation, Automation
- **Stats:** 56 total users, 2 monthly users, 100.0% runs succeeded, 12 bookmarks
- **User rating**: 3.45 out of 5 stars

## Pricing

$30.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period. You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#rental-actors

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

![Snapchat Ads Scraper](https://lexis-solutions-apify.fra1.cdn.digitaloceanspaces.com/banners/snapchat.jpg)

## What is the Snapchat Ads Scraper?

The Snapchat Ads Scraper is designed to extract ad content and statistics from https://www.snapchat.com/ads-library. This tool is designed to scrape Snapchat ads and extract the following data:

<table>
<tr>
<td>✅ Ad Name</td>
<td>✅ Ad Type</td>
</tr>
<tr>
<td>✅ Paying Ad Name</td>
<td>✅ Account Name</td>
</tr>
<tr>
<td>✅ Profile Logo URL</td>
<td>✅ Profile Name</td>
</tr>
<tr>
<td>✅ Brand Name</td>
<td>✅ Headline</td>
</tr>
<tr>
<td>✅ Total Impressions</td>
<td>✅ Ad Status</td>
</tr>
<tr>
<td>✅ Media Download Link</td>
<td>✅ Media Type</td>
</tr>
<tr>
<td>✅ Start Date</td>
<td>✅ Destination URL</td>
</tr>
<tr>
<td>✅ Creative Type</td>
<td>✅ Ad Render Type</td>
</tr>
<tr>
<td>✅ Call to Action</td>
<td>✅ Review Status</td>
</tr>
<tr>
<td>✅ Impressions by Country</td>
<td>✅ Languages</td>
</tr>
<tr>
<td>✅ Targeting Details</td>
<td>✅ Media Crop Position</td>
</tr>
<tr>
<td>✅ Favorite Display Mode</td>
<td>✅ Sticker Display Mode</td>
</tr>
<tr>
<td>✅ Stickers</td>
<td>✅ Rejection Reasons</td>
</tr>
<tr>
<td>✅ Web View Properties</td>
<td>✅ Deep Link Properties</td>
</tr>
<tr>
<td>✅ App Install Preview</td>
<td>✅ Composite Preview</td>
</tr>
<tr>
<td>✅ DPA Preview</td>
<td>✅ Lens Preview</td>
</tr>
<tr>
<td>✅ Sub Request Status</td>
<td>✅ ID</td>
</tr>
</table>

## What use cases does the Snapchat Ads Scraper have?

- 👀 Competitive analysis
- 💻 Market research
- 📊 Data journalism

### 🌊 How do I use Snapchat Ads Scraper to extract data?

Snapchat Ads Scraper is designed to be user-friendly, even for those who have never extracted data from the web before. Here’s how you can scrape data with this tool:

1. [Create](https://console.apify.com/sign-up) a free Apify account using your email.
2. Open Snapchat Ads Scraper.
3. Enter the necessary parameters to scrape ads.
4. Click the “Start” button and wait for the data to be extracted.
5. Download your data in JSON, XML, CSV, Excel, or HTML.

### ⬇️ Input

The input for Snapchat Ads Scraper includes various parameters to filter the ads you want to extract.

Example input:

```json
{
  "search": "Amazon",
  "country": "DE",
  "startDate": "2025-01-01",
  "endDate": "2025-12-31",
  "status": "ACTIVE",
  "maxItems": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}
```

### What are the input filter options?

- **search**: Advertiser keyword to scrape (e.g., Amazon).
- **country**: Name of the country to filter ads.
- **startDate**: Start Date.
- **endDate**: End Date.
- **status**: Status of the ad -> 'ACTIVE' or 'PAUSED'.
- **maxItems**: Maximum number of items to scrape.

### ⬆️ Output sample

The scraped data will be shown as a dataset which you can find in the **Storage** tab. Here’s an excerpt from the dataset you can get when applying the input parameters above:

```json
{
  "id": "72b378ea-a99a-4cf0-9459-62763578988a",
  "adName": "PVES25BE004_pv_digi-brand-q3_post",
  "adType": "REMOTE_WEBPAGE",
  "creativeType": "WEB_VIEW",
  "adRenderType": "STATIC",
  "payingAdName": "Amazon Snapchat EU WPP",
  "accountName": "BE PV Brand SNAP 3P Default",
  "profileLogoUrl": null,
  "profileName": null,
  "brandName": "Prime Video",
  "headline": "Watch now",
  "callToAction": "MORE",
  "destinationUrl": "https://www.primevideo.com/",
  "totalImpressions": 1842673,
  "impressionsByCountry": {
    "be": 1842673
  },
  "languages": ["fr"],
  "adStatus": "ACTIVE",
  "reviewStatus": "APPROVED",
  "snapMediaDownloadLink": "https://cf-st.sc-cdn.net/...",
  "snapMediaType": "VIDEO",
  "snapMediaCropPosition": "MIDDLE",
  "startDate": "2025-08-10T22:00:25.000Z",
  "targeting": {
    "regulated_content": false,
    "demographics": [
      {
        "min_age": "18",
        "max_age": "34",
        "languages": ["fr"]
      }
    ]
  }
}
```

### Limitations

The Snapchat Ads Scraper collects matching ads until it reaches `maxItems` or no more matching ads are available. Some optional fields may be empty when they are not provided by Snapchat Ads Library.

### ❓FAQ

#### Can I use this tool for free?

With the Apify Free plan, you get $5 worth of credits every month. You can use the Snapchat Ads Scraper with the free trial option, after which you can upgrade to a paid plan.

#### **How much does it cost?**

The cost for using the Snapchat Ads Scraper is shown on the top of this page. You can also check the Apify Store page for more information.

### Need to scrape ads from other platforms?

👉 Scrape Reddit ads with [Reddit Ads Scraper](https://apify.com/lexis-solutions/reddit-ads-scraper)

👉 Scrape Google ads with [Google Ads Scraper](https://apify.com/lexis-solutions/google-ads-scraper)

👉 Scrape Bing ads with [Bing Ads Scraper](https://apify.com/lexis-solutions/bing-ads-scraper)

👉 Scrape TikTok ads with [TikTok Ads Scraper](https://apify.com/lexis-solutions/tiktok-ads-scraper)

***

👀 p.s.

Got feedback or need an extension?

Lexis Solutions is a [certified Apify Partner](https://apify.com/partners). We can help you with custom solutions or data extraction projects.

Contact us over [Email](mailto:scraping@lexis.solutions) or [LinkedIn](https://www.linkedin.com/company/lexis-solutions)

### Support Our Work 💝

If you're happy with our work and scrapers, you're welcome to leave us a company review [here](https://apify.com/partners/find/lexis-solutions/review) and leave a review for the scrapers you're subscribed to. It will take you less than a minute but it will mean a lot to us!

Image Credit: Google Transparency Center

# Actor input Schema

## `search` (type: `string`):

Enter an advertiser keyword to search for matching ads.

## `country` (type: `string`):

Select a country from the EU.

## `startDate` (type: `string`):

Select absolute date in format YYYY-MM-DD

## `endDate` (type: `string`):

Select absolute date in format YYYY-MM-DD

## `status` (type: `string`):

Select the status of the ad.

## `maxItems` (type: `integer`):

The maximum number of items to fetch

## `proxyConfiguration` (type: `object`):

Your proxy configuration from Apify

## Actor input object example

```json
{
  "search": "Ikea",
  "maxItems": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "search": "Ikea"
};

// Run the Actor and wait for it to finish
const run = await client.actor("lexis-solutions/snapchat-ads-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "search": "Ikea" }

# Run the Actor and wait for it to finish
run = client.actor("lexis-solutions/snapchat-ads-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "search": "Ikea"
}' |
apify call lexis-solutions/snapchat-ads-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,lexis-solutions/snapchat-ads-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/YWcBTCq4EbezPcmtC/builds/Sg8GmmfgB3ZIT1geT/openapi.json