# Snapchat Story Viewer (`igview-owner/snapchat-story-viewer`) Actor

Anonymous Snapchat story viewer for public profiles. This actor fetches public Snapchat stories from one or more usernames, extracts media URLs and metadata, and saves everything into an Apify dataset.

- **URL**: https://apify.com/igview-owner/snapchat-story-viewer.md
- **Developed by:** [Sachin Kumar Yadav](https://apify.com/igview-owner) (community)
- **Categories:** Social media, Videos, Developer tools
- **Stats:** 159 total users, 8 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Snapchat Story Viewer (Apify Actor) 📲

An **anonymous Snapchat story viewer** built as an **Apify actor**. View and export public Snapchat stories from multiple usernames in one run — no Snapchat login required.

***

### 📚 Table of Contents

1. [Overview](#overview)
2. [Key Features](#key-features)
3. [Input Configuration](#input-configuration)
4. [Output & Dataset Structure](#output--dataset-structure)
5. [How to Run on Apify](#how-to-run-on-apify)
6. [Use Cases](#use-cases)
7. [FAQ](#faq)

***

### 🔍 Overview

The **Snapchat Story Viewer** actor lets you:

- Fetch **public Snapchat stories** from one or more usernames.
- View stories **without logging into Snapchat**.
- Save all data to an **Apify dataset** for download (JSON, CSV, Excel, etc.).

This is ideal for creators, analysts, and marketers who want to monitor public Snapchat content safely and programmatically.

***

### ⭐ Key Features

| Feature | Description |
|--------|-------------|
| 🧑‍🤝‍🧑 Multiple usernames | Fetch stories from many Snapchat usernames in a single run. |
| 🔐 No login required | Works only with public profiles, no Snapchat account needed. |
| 🔗 Smart username parsing | Accepts plain usernames or full Snapchat profile URLs. |
| 📊 Structured dataset | Saves clean, structured story and snap data to Apify dataset. |
| 🖼️ Media metadata | Includes media URLs, thumbnails, timestamps, and basic metadata. |

***

### 🧾 Input Configuration

This actor uses a **single input field**: an array of usernames.

#### `usernames` (required)

- **Type**: array of strings
- **Editor**: string list (add usernames with the `+` button)
- **Description**: Snapchat usernames or full profile URLs.

##### ✅ Example – Basic input

```json
{
  "usernames": [
    "loren",
    "kyliejenner",
    "shumate.anna"
  ]
}
```

##### ✅ Example – With profile URLs

```json
{
  "usernames": [
    "https://www.snapchat.com/@loren",
    "https://www.snapchat.com/@kyliejenner"
  ]
}
```

The actor will automatically **extract the username** from supported Snapchat URLs.

***

### 📦 Output & Dataset Structure

All results are stored in the **default Apify dataset**. You can export data as JSON, CSV, or Excel.

Each story entry typically looks like this (simplified):

```json
{
  "username": "loren",
  "fetchedAt": "2025-10-08T01:35:02.687Z",
  "storyIndex": 1,
  "storyTitle": "kendall's 30th birthday",
  "storyType": 3,
  "highlightId": "7b67f3a6-87f6-4a98-8cab-16a9bd6caf30",
  "thumbnailUrl": "https://...",
  "snapCount": 17,
  "snaps": [
    {
      "snapIndex": 0,
      "mediaType": "image",
      "mediaUrl": "https://...",
      "previewUrl": "https://...",
      "timestamp": "1762406924"
    }
  ]
}
```

#### Main fields

| Field | Type | Description |
|-------|------|-------------|
| `username` | string | Snapchat username processed. |
| `fetchedAt` | string (ISO datetime) | When the data was fetched. |
| `storyIndex` | number | Story order for that username. |
| `storyTitle` | string | Title of the story or highlight. |
| `highlightId` | string | Highlight identifier (if available). |
| `snapCount` | number | Total snaps in the story. |
| `snaps` | array | List of snaps with media URLs and metadata. |

***

### ▶️ How to Run on Apify

1. **Open the actor** on Apify.
2. Go to the **Input** tab.
3. In **Snapchat Usernames**, add one or more usernames or profile URLs:
   - `loren`
   - `kyliejenner`
   - `https://www.snapchat.com/@shumate.anna`
4. Click **Run**.
5. After the run finishes, open the **Dataset** tab to view or download results.

You can also schedule this actor using Apify **schedules** to monitor profiles regularly.

***

### 💡 Use Cases

- 📈 **Social media research** – Track how public Snapchat profiles post content over time.
- 🎨 **Content inspiration** – Discover visual ideas, trends, and formats from public stories.
- 🗂️ **Story archiving** – Save public stories and highlights into your own research archive.
- 🔍 **Brand & creator monitoring** – Observe public activity of influencers or brands.

***

### ❓ FAQ

**Q: Do I need a Snapchat account to use this actor?**\
A: No. The actor works only with **public profiles** and does not log in to Snapchat.

**Q: Can this actor see private stories or friends-only content?**\
A: No. It can only access **publicly available** Snapchat stories and highlights.

**Q: How many usernames can I add in one run?**\
A: By default, the input supports **1–50 usernames** in the `usernames` array.

**Q: Where can I download the data?**\
A: After the run, go to the actor run **Dataset** on Apify, and export as **JSON, CSV, or Excel**.

**Q: What if a username is invalid or has no public stories?**\
A: The dataset will contain an item with `success: false` and a human-readable `error` message for that username.

***

- *Snapchat Story Viewer*, *anonymous Snapchat stories*, *view Snapchat stories without account*, *download Snapchat stories dataset*, and *Apify actor* keywords.

If you have issues or suggestions, please use the **Apify actor page** to report them or contact the author through Apify.

# Actor input Schema

## `usernames` (type: `array`):

Add Snapchat usernames or profile URLs to fetch stories from multiple accounts. You can add usernames one by one using the + button below.

## Actor input object example

```json
{
  "usernames": [
    "loren",
    "https://www.snapchat.com/@kyliejenner",
    "@shumate.anna"
  ]
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "usernames": [
        "loren",
        "https://www.snapchat.com/@kyliejenner",
        "@shumate.anna"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("igview-owner/snapchat-story-viewer").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "usernames": [
        "loren",
        "https://www.snapchat.com/@kyliejenner",
        "@shumate.anna",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("igview-owner/snapchat-story-viewer").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "usernames": [
    "loren",
    "https://www.snapchat.com/@kyliejenner",
    "@shumate.anna"
  ]
}' |
apify call igview-owner/snapchat-story-viewer --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=igview-owner/snapchat-story-viewer",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/hdanDELz0nO2tCHe2/builds/1UT4gcTAcmNbK1d29/openapi.json