Stories & Spotlight

A plain post becomes a Story: contentType defaults to "story". Set it to "saved_story" or "spotlight" for the other 2 types.

Story

A Story is visible for 24 hours and carries no caption, so content is not used:

const { data: published } = await zernio.posts.createPost({
  body: {
    mediaItems: [
      { type: 'video', url: 'https://cdn.example.com/backstage.mp4' }
    ],
    platforms: [
      {
        platform: 'snapchat',
        accountId: '66b2e19d8c3f5a7e9d0b1c2d',
        platformSpecificData: { contentType: 'story' }
      }
    ],
    publishNow: true
  }
});

console.log(published.post.status);

Response (201):

{
  "post": {
    "_id": "65f1c0a9e2b5af0012ab34cd",
    "status": "published",
    "platforms": [
      {
        "platform": "snapchat",
        "status": "published"
      }
    ]
  }
}

Every sample below changes only the content or the platforms entry of this request. An image works the same way with { "type": "image", "url": "https://cdn.example.com/backstage.jpg" }.

Saved Story

A Saved Story stays on the Public Profile. content becomes its title, at most 45 characters:

{
  "content": "Behind the scenes",
  "platforms": [
    {
      "platform": "snapchat",
      "accountId": "66b2e19d8c3f5a7e9d0b1c2d",
      "platformSpecificData": { "contentType": "saved_story" }
    }
  ]
}

Spotlight

Spotlight is Snapchat's public video feed and takes video only. content becomes the description, at most 160 characters including hashtags:

{
  "content": "Sunset over the pier #sunset #nature",
  "platforms": [
    {
      "platform": "snapchat",
      "accountId": "66b2e19d8c3f5a7e9d0b1c2d",
      "platformSpecificData": { "contentType": "spotlight" }
    }
  ]
}

Platform fields

All fields go in platformSpecificData on the Snapchat entry.