API Reference
Snapchat API
Post videos and images to Snapchat Stories, Spotlight, and Saved Stories via Public Profiles.
Quick Start
Get started in 3 steps
Get API Key
Sign up for free and get your API key in seconds.
Connect Account
Use our OAuth flow to connect Snapchat accounts.
Start Posting
Make API calls to post content to Snapchat.
const response = await fetch('https://getlate.dev/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'Endpoints
Snapchat Endpoints
/v1/postsCreate or schedule a Snapchat post (Stories, Spotlight, or Saved Stories)
/v1/posts/{id}Get status and details of a Snapchat post
/v1/posts/{id}Cancel a scheduled Snapchat post or delete a published post
/v1/posts/{id}/analyticsGet views, shares, screenshots, and unique viewers for a post
/v1/profilesList all connected Snapchat Public Profiles
/v1/connect/snapchatGenerate OAuth URL to connect a Snapchat account
Media Specs
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 |
Late automatically transcodes and optimizes media for Snapchat's requirements.
Rate Limits
API Limits
Snapchat has strict rate limits on their Marketing API. Late handles these automatically with intelligent queuing and token refresh for reliable posting.
Late handles all rate limiting automatically. We queue and retry requests as needed.
Capabilities
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
Response Example
{
"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
Skip the Snapchat Marketing API complexity. Late handles OAuth, Public Profile selection, media uploads, and rate limits so you can ship faster.
Free tier available • No credit card required • 99.97% uptime