API Reference

Snapchat API

Snapchat's Marketing API requires Business Manager approval, Public Profile setup, and separate media upload flows. Zernio gives you one endpoint for Stories, Spotlight, and Saved Stories.

Get API Key Full Documentation

Quick Start

1.
Get API Key
Sign up for free and get your API key in seconds.
2.
Connect Account
Use our OAuth flow to connect Snapchat accounts.
3.
Start Posting
Make API calls to post content to Snapchat.

Post to Snapchat Spotlight

JavaScript

const response = await fetch('https://zernio.com/api/v1/posts', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    content: 'Check out this amazing view! 🌅',
    mediaItems: [{ type: 'video', url: 'https://example.com/sunset.mp4' }],
    platforms: [{
      platform: 'snapchat',
      accountId: 'acc_snap123',
      options: {
        contentType: 'spotlight' // 'story', 'spotlight', or 'saved_story'
      }
    }],
    publishNow: true
  })
});

const post = await response.json();
console.log(post.post._id); // '65f1c0a9e2b5af0012ab34cd'

Snapchat Endpoints

POST/v1/posts

Create or schedule a Snapchat post (Stories, Spotlight, or Saved Stories)

GET/v1/posts/{id}

Get status and details of a Snapchat post

DELETE/v1/posts/{id}

Cancel a scheduled Snapchat post or delete a published post

GET/v1/posts/{id}/analytics

Get views, shares, screenshots, and unique viewers for a post

GET/v1/profiles

List all connected Snapchat Public Profiles

GET/v1/connect/snapchat

Generate OAuth URL to connect a Snapchat account

View full API reference →

Media Requirements

Type	Format	Max Size	Notes
Video	MP4, MOV	32 MB	3-60 seconds, 9:16 aspect ratio recommended
Image	JPEG, PNG	5 MB	1080x1920 (9:16) recommended
Spotlight Video	MP4, MOV	32 MB	Up to 60 seconds, vertical format required
Story	Image or Video	32 MB	Disappears after 24 hours

Zernio automatically transcodes and optimizes media for Snapchat's requirements.

API Limits

Snapchat has strict rate limits on their Marketing API. Zernio handles these automatically with intelligent queuing and token refresh for reliable posting.

Zernio handles all rate limiting automatically. We queue and retry requests as needed.

Features

✓Post to Stories, Spotlight, and Saved Stories
✓Schedule posts for optimal engagement times
✓Automatic media optimization for Snapchat
✓Public Profile support for brands and creators
✓View count and engagement analytics
✓Screenshot and share tracking
✓Automatic token refresh
✓Webhook notifications for post status

Response Example

Response

JSON

{
  "post": {
    "_id": "65f1c0a9e2b5af0012ab34cd",
    "status": "published",
    "content": "Check out this amazing view! 🌅",
    "platforms": [{
      "platform": "snapchat",
      "accountId": { "_id": "acc_snap123", "username": "MyBrand" },
      "status": "published",
      "platformPostId": "snap_media_123",
      "options": { "contentType": "spotlight" }
    }],
    "publishedAt": "2025-01-10T10:30:00Z"
  },
  "message": "Post published successfully"
}

Start building with Snapchat API

Free tier available · No credit card required · 99.97% uptime

Get Free API Key Read Documentation →