Documentation Index Fetch the complete documentation index at: https://lava.so/docs/llms.txt
Use this file to discover all available pages before exploring further.
Snapchat advertising API for managing the full ad lifecycle on Snapchat. Use to create and manage campaigns, ad squads, ads, creatives, audiences, and pull performance reporting against Snap’s Marketing API. Strongest for reaching Gen Z and AR-format ad surfaces (Lenses, Stories, Spotlight) that other major ad platforms don’t offer.
8 example endpoints available through Lava’s AI Gateway. See the Snapchat Ads API docs for full documentation.
This provider requires your own credentials — connect your API key or OAuth account before use.
This is a
catch-all provider — any valid URL under
https://adsapi.snapchat.com/v1 is supported. Any Snapchat Marketing API endpoint. Construct URL as
https://adsapi.snapchat.com/v1/{path} . Pagination uses the
limit query param (50–1000) with response
paging.next_link carrying the next-page URL. Errors return JSON with
request_status: "ERROR",
debug_message,
display_message,
error_code (e.g., E3003 for not-found). Rate limits: 20 req/sec per app, 10 req/sec per access token. Full reference:
https://developers.snap.com/api/marketing-api/Ads-API/introduction The endpoints below are curated examples.
Endpoints Get the authenticated user (id, organization_id, display_name, email) GET https://adsapi.snapchat.com/v1/me — Freeconst data = await lava . gateway ( 'https://adsapi.snapchat.com/v1/me' , { method: 'GET' });
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fadsapi.snapchat.com%2Fv1%2Fme" \ -H "Authorization: Bearer $LAVA_SECRET_KEY "
List organizations the authenticated user belongs to GET https://adsapi.snapchat.com/v1/me/organizations — Freeconst data = await lava . gateway ( 'https://adsapi.snapchat.com/v1/me/organizations' , { method: 'GET' });
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fadsapi.snapchat.com%2Fv1%2Fme%2Forganizations" \ -H "Authorization: Bearer $LAVA_SECRET_KEY "
List ad accounts under an organization GET https://adsapi.snapchat.com/v1/organizations/{organization_id}/adaccounts — Freeconst data = await lava . gateway ( 'https://adsapi.snapchat.com/v1/organizations/{organization_id}/adaccounts' , { method: 'GET' });
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fadsapi.snapchat.com%2Fv1%2Forganizations%2F%7Borganization_id%7D%2Fadaccounts" \ -H "Authorization: Bearer $LAVA_SECRET_KEY "
List campaigns under an ad account GET https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/campaigns — Freeconst data = await lava . gateway ( 'https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/campaigns' , { method: 'GET' });
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fadsapi.snapchat.com%2Fv1%2Fadaccounts%2F%7Bad_account_id%7D%2Fcampaigns" \ -H "Authorization: Bearer $LAVA_SECRET_KEY "
Create a campaign in an ad account POST https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/campaigns — Freeconst data = await lava . gateway ( 'https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/campaigns' , { body: { "campaigns" : [ { "name" : "Summer Launch" , "ad_account_id" : "{ad_account_id}" , "status" : "PAUSED" , "start_time" : "2026-06-01T00:00:00Z" , "objective" : "BRAND_AWARENESS" } ] }, });
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fadsapi.snapchat.com%2Fv1%2Fadaccounts%2F%7Bad_account_id%7D%2Fcampaigns" \ -H "Authorization: Bearer $LAVA_SECRET_KEY " \ -H "Content-Type: application/json" \ -d '{"campaigns":[{"name":"Summer Launch","ad_account_id":"{ad_account_id}","status":"PAUSED","start_time":"2026-06-01T00:00:00Z","objective":"BRAND_AWARENESS"}]}'
List ad squads under a campaign GET https://adsapi.snapchat.com/v1/campaigns/{campaign_id}/adsquads — Freeconst data = await lava . gateway ( 'https://adsapi.snapchat.com/v1/campaigns/{campaign_id}/adsquads' , { method: 'GET' });
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fadsapi.snapchat.com%2Fv1%2Fcampaigns%2F%7Bcampaign_id%7D%2Fadsquads" \ -H "Authorization: Bearer $LAVA_SECRET_KEY "
List ads under an ad squad GET https://adsapi.snapchat.com/v1/adsquads/{ad_squad_id}/ads — Freeconst data = await lava . gateway ( 'https://adsapi.snapchat.com/v1/adsquads/{ad_squad_id}/ads' , { method: 'GET' });
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fadsapi.snapchat.com%2Fv1%2Fadsquads%2F%7Bad_squad_id%7D%2Fads" \ -H "Authorization: Bearer $LAVA_SECRET_KEY "
GET https://adsapi.snapchat.com/v1/campaigns/{campaign_id}/stats?granularity=TOTAL&fields=impressions,swipes,spend — Freeconst data = await lava . gateway ( 'https://adsapi.snapchat.com/v1/campaigns/{campaign_id}/stats?granularity=TOTAL&fields=impressions,swipes,spend' , { method: 'GET' });
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fadsapi.snapchat.com%2Fv1%2Fcampaigns%2F%7Bcampaign_id%7D%2Fstats%3Fgranularity%3DTOTAL%26fields%3Dimpressions%2Cswipes%2Cspend" \ -H "Authorization: Bearer $LAVA_SECRET_KEY "
Next Steps
All Providers Browse all supported AI providers
Forward Proxy Learn how to construct proxy URLs and authenticate requests
