> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Snapchat API

> Options for posting using the Snapchat API

## Posting to Snapchat

The Snapchat API enables direct publishing of content to both Stories and Spotlight.
Stories are temporary posts that disappear after 24 hours, while Spotlight posts are permanent and can help creators and businesses reach a wider audience.

There are three types of posts you can create on Snapchat:

<ul className="custom-bullets">
  <li>[Stories](/apis/post/social-networks/snapchat#stories)</li>
  <li>[Saved Stories](/apis/post/social-networks/snapchat#saved-stories)</li>
  <li>[Spotlight](/apis/post/social-networks/snapchat#spotlight)</li>
</ul>

Snapchat accepts either video or image media. Only one media item is allowed per post.

You can learn more using Snapchat's API:

<ul className="custom-bullets">
  <li>[Snapchat Media Guidelines](/media-guidelines/snapchat) and [Snapchat Authorization](/dashboard/connect-social-accounts/snapchat).</li>
  <li>[Snapchat API integration guide](https://www.ayrshare.com/complete-guide-to-snapchat-api-integration/) to learn more about how to post or get analytics on Snapchat.</li>
</ul>

## Stories

Stories are ephemeral Snaps viewable by friends, subscribers, and non-subscribers in the Snapchat app's 4th tab Discover feed for up to 24-hours.

Publish a Snapchat story as you would any other post:

```json Publish a Snapchat story theme={"system"}
{
  "post": "An amazing story", // empty string is allowed
  "platforms": ["snapchat"],
  "mediaUrl": ["https://img.ayrshare.com/video.mp4"]
}
```

## Saved Stories

Saved Stories are permanent Stories that are viewable on a Public Profile indefinitely.

Publish a Snapchat story with `snapChatOptions` and the `savedStory` option:

```json Publish a Snapchat saved story theme={"system"}
{
  "post": "An amazing saved story",
  "platforms": ["snapchat"],
  "mediaUrl": ["https://img.ayrshare.com/video.mp4"],
  "snapChatOptions": {
    "savedStory": true
  }
}
```

## Spotlight

Spotlights are permanent video Snaps that are distributed and viewable on Spotlight, Snapchat's entertainment platform for user-generated content.
Spotlight offers a channel for creators and businesses to grow their audience on Snapchat.

Publish a Snapchat story with `snapChatOptions` and the `spotlight` option:

```json Publish a Snapchat spotlight theme={"system"}
{
  "post": "An amazing spotlight",
  "platforms": ["snapchat"],
  "mediaUrl": ["https://img.ayrshare.com/video.mp4"],
  "snapChatOptions": {
    "spotlight": true
  }
}
```

## Snapchat Mentions

Currently, user mentions (@username) in Spotlight posts don't resolve as interactive mentions through the API. The text will appear as plain text in your Spotlight posts rather than creating clickable user links.

```json Example with mentions (displays as plain text) theme={"system"}
{
  "post": "Check out this awesome content from @johndoe and @janedoe!",
  "platforms": ["snapchat"],
  "mediaUrl": ["https://img.ayrshare.com/image.jpg"],
  "snapChatOptions": {
    "spotlight": true
  }
}
```

## Snapchat Hashtags

Hashtags are fully supported in Spotlight posts and help increase discoverability. You can include multiple hashtags in your post content to categorize your content and reach relevant audiences. Hashtags are also clickable.

```json Example with hashtags theme={"system"}
{
  "post": "Just launched our new product! 🚀 #ayrshare #tech #exciting",
  "platforms": ["snapchat"],
  "mediaUrl": ["https://img.ayrshare.com/product-launch.mp4"],
  "snapChatOptions": {
    "spotlight": true
  }
}
```

## Character Limits

Please see [Snapchat Character Limits](/help-center/technical-support/character_limits#snapchat-character-limits) for more information.