> ## 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 Ads
> Snapchat advertising API for managing the full ad lifecycle on Snapchat.
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](https://developers.snap.com/api/marketing-api/Ads-API/introduction) 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\}](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](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` — Free
```typescript theme={null}
const data = await lava.gateway('https://adsapi.snapchat.com/v1/me', { method: 'GET' });
```
```bash theme={null}
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` — Free
```typescript theme={null}
const data = await lava.gateway('https://adsapi.snapchat.com/v1/me/organizations', { method: 'GET' });
```
```bash theme={null}
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` — Free
```typescript theme={null}
const data = await lava.gateway('https://adsapi.snapchat.com/v1/organizations/{organization_id}/adaccounts', { method: 'GET' });
```
```bash theme={null}
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` — Free
```typescript theme={null}
const data = await lava.gateway('https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/campaigns', { method: 'GET' });
```
```bash theme={null}
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` — Free
```typescript theme={null}
const 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"
}
]
},
});
```
```bash theme={null}
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` — Free
```typescript theme={null}
const data = await lava.gateway('https://adsapi.snapchat.com/v1/campaigns/{campaign_id}/adsquads', { method: 'GET' });
```
```bash theme={null}
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` — Free
```typescript theme={null}
const data = await lava.gateway('https://adsapi.snapchat.com/v1/adsquads/{ad_squad_id}/ads', { method: 'GET' });
```
```bash theme={null}
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 performance stats for a campaign (impressions, swipes, spend)
**GET** `https://adsapi.snapchat.com/v1/campaigns/{campaign_id}/stats?granularity=TOTAL&fields=impressions,swipes,spend` — Free
```typescript theme={null}
const data = await lava.gateway('https://adsapi.snapchat.com/v1/campaigns/{campaign_id}/stats?granularity=TOTAL&fields=impressions,swipes,spend', { method: 'GET' });
```
```bash theme={null}
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
Browse all supported AI providers
Learn how to construct proxy URLs and authenticate requests