Auto backup: 2026-02-19 12:11

2026-02-19 12:11:01 +00:00
parent ad3bcbcc45
commit b33a4d2390
178 changed files with 26760 additions and 48 deletions
--- a/skills/api-gateway/references/snapchat.md
+++ b/skills/api-gateway/references/snapchat.md
@@ -0,0 +1,150 @@
+# Snapchat Routing Reference
+
+**App name:** `snapchat`
+**Base URL proxied:** `adsapi.snapchat.com`
+
+## API Path Pattern
+
+```
+/snapchat/v1/{resource}
+```
+
+## Common Endpoints
+
+### Current User
+
+#### Get Current User
+```bash
+GET /snapchat/v1/me
+```
+
+#### List Organizations
+```bash
+GET /snapchat/v1/me/organizations
+```
+
+### Organizations
+
+#### Get Organization
+```bash
+GET /snapchat/v1/organizations/{organizationId}
+```
+
+#### List Ad Accounts
+```bash
+GET /snapchat/v1/organizations/{organizationId}/adaccounts
+```
+
+#### List Funding Sources
+```bash
+GET /snapchat/v1/organizations/{organizationId}/fundingsources
+```
+
+### Ad Accounts
+
+#### Get Ad Account
+```bash
+GET /snapchat/v1/adaccounts/{adAccountId}
+```
+
+### Campaigns
+
+#### List Campaigns
+```bash
+GET /snapchat/v1/adaccounts/{adAccountId}/campaigns
+```
+
+#### Create Campaign
+```bash
+POST /snapchat/v1/adaccounts/{adAccountId}/campaigns
+Content-Type: application/json
+
+{
+  "campaigns": [{
+    "name": "Campaign Name",
+    "status": "PAUSED",
+    "ad_account_id": "{adAccountId}",
+    "start_time": "2026-02-15T00:00:00.000-08:00"
+  }]
+}
+```
+
+### Ad Squads
+
+#### List Ad Squads
+```bash
+GET /snapchat/v1/adaccounts/{adAccountId}/adsquads
+```
+
+### Ads
+
+#### List Ads
+```bash
+GET /snapchat/v1/adaccounts/{adAccountId}/ads
+```
+
+### Creatives
+
+#### List Creatives
+```bash
+GET /snapchat/v1/adaccounts/{adAccountId}/creatives
+```
+
+### Media
+
+#### List Media
+```bash
+GET /snapchat/v1/adaccounts/{adAccountId}/media
+```
+
+### Stats
+
+#### Get Ad Account Stats
+```bash
+GET /snapchat/v1/adaccounts/{adAccountId}/stats?granularity=DAY&start_time=2026-02-01&end_time=2026-02-14
+```
+
+### Targeting
+
+#### Get Countries
+```bash
+GET /snapchat/v1/targeting/geo/country
+```
+
+#### Get Regions
+```bash
+GET /snapchat/v1/targeting/geo/{countryCode}/region
+```
+
+### Ads Gallery (Public Ads Library)
+
+#### List Sponsored Content
+```bash
+GET /snapchat/v1/ads_library/sponsored_content
+```
+
+#### Search Ads
+```bash
+POST /snapchat/v1/ads_library/ads/search
+Content-Type: application/json
+
+{
+  "paying_advertiser_name": "Nike",
+  "countries": ["fr", "de"],
+  "limit": 50
+}
+```
+
+## Notes
+
+- Monetary values use micro-currency (1 USD = 1,000,000 micro)
+- Bulk operations accept arrays for batch create/update
+- Pagination uses `limit` (50-1000) and cursor via `next_link`
+- Sorting: `sort=updated_at-desc` or `sort=created_at-desc`
+- Ads Gallery: Use lowercase 2-letter ISO country codes (e.g., `fr`, `de`). US may not be available.
+
+## Resources
+
+- [Snapchat Ads API Introduction](https://developers.snap.com/api/marketing-api/Ads-API/introduction)
+- [API Patterns](https://developers.snap.com/api/marketing-api/Ads-API/api-patterns)
+- [Ads Gallery API](https://developers.snap.com/api/marketing-api/Ads-Gallery-Api/using-the-api)