Snapchat Ads MCP Server

Snapchat Ads MCP Server exposes Snapchat's EU Ads Gallery as MCP tools for AI agents. It returns ad ID, advertiser name, brand, ad account, headline, call to action, impressions, ad type, creative type, campaign start date, review status, and media URLs. Covers 27 EU countries under the Digital Services Act.

Tools

search_snapchat_ads

Search the Snapchat Ads Gallery by advertiser or brand name with optional filters.

Parameter	Type	Required	Default	Description
query	string	Yes	—	Advertiser or brand name (e.g. "Nike, Inc.")
country	string	No	DE	EU country code — 27 countries supported
start_date	string	No	—	Activity start filter (YYYY-MM-DD)
end_date	string	No	—	Activity end filter (YYYY-MM-DD)
status	string	No	—	ACTIVE or PAUSED
max_results	integer	No	20	Maximum ads to return (1–50)

get_advertiser_ads

Shortcut for retrieving all ads from a specific advertiser in a country.

Parameter	Type	Required	Default	Description
advertiser_name	string	Yes	—	Advertiser's legal name (e.g. "Zalando SE")
country	string	No	DE	EU country code
max_results	integer	No	20	Maximum ads to return (1–50)

Output example

{
  "totalAds": 3,
  "ads": [
    {
      "adId": "1043c3dc-b78f-432e-8208-34ac81706787",
      "adType": "REMOTE_WEBPAGE",
      "creativeType": "WEB_VIEW",
      "advertiserName": "Nike, Inc.",
      "brandName": "Nike",
      "adAccountName": "Nike EMEA - Initiative - Marketplace",
      "headline": "Jetzt auf Nike.com",
      "callToAction": "SHOP NOW",
      "impressionsTotal": 18819708,
      "impressionsCountry": 18819708,
      "status": "ACTIVE",
      "reviewStatus": "APPROVED",
      "campaignStartDate": "2024-11-12",
      "mediaType": "DYNAMIC",
      "mediaUrl": "https://cf-st.sc-cdn.net/d/C3CFWTMYLi...",
      "profileLogoUrl": "https://cf-st.sc-cdn.net/aps/bolt/...",
      "country": "DE"
    }
  ],
  "query": "Nike",
  "country": "DE"
}

How to connect

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "snapchat-ads": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server"],
      "env": {
        "ACTOR_ID": "zadexinho/snapchat-ads-mcp-server",
        "APIFY_TOKEN": "your_apify_token"
      }
    }
  }
}

Other MCP clients

Use the Apify MCP server connector with actor ID zadexinho/snapchat-ads-mcp-server.

How much does it cost?

Pricing is per tool call.

Calls	Cost
100	$0.50
500	$2.50
1,000	$5.00

Tips

• Use the legal entity name — Search under the paying advertiser's registered name (e.g. "adidas AG" not "Adidas"). If totalAds is 0, try variations.
• Try different countries — Ad coverage varies by country. A brand with 0 results in NL may have 50 in DE.
• For bulk data — Use the Snapchat Ads Scraper instead. It handles pagination and pushes to a dataset.
• mediaUrl available for DYNAMIC ads only — VIDEO, IMAGE, and LENS_PACKAGE types do not expose direct media URLs.

Limitations

• EU countries only (27 member states under DSA)
• Last 12 months of ad data
• 50 ads per tool call (use the scraper for larger volumes)
• mediaUrl populated for DYNAMIC-type ads only
• No campaign end date (API limitation)