POST/v1/tiktok/user-story

TikTok User Story API

Get a TikTok user's active stories. Ephemeral content tracking from $0.01/call.

Fetch the current active stories for a TikTok user. Returns story content and metadata.

Full Docs Get API Key — Free $5 Credit $0.01 / call

Try it live

Fill in the fields and hit Run to see a real response.

POST/v1/tiktok/user-storytt-user-story$0.01/call

Response

Example response — hit "Send Request" to see a live result

{
  "ok": true,
  "data": {
    "stories": [
      {
        "id": "story123",
        "createTime": 1700000000
      }
    ]
  }
}

Features

✓

Active stories

Provide a username and retrieve the creator's currently active stories before they expire, returned as a stories array.

✓

Story metadata

Each story includes its id and a createTime timestamp, so you know exactly what was posted and when.

✓

Ephemeral content access

Stories disappear after a short window; this endpoint captures them on demand while they are still live.

✓

Real-time data

Results reflect the creator's stories at the moment of the call, making it suited to time-sensitive monitoring.

Use cases

Story Monitoring

Monitor creators' stories for time-sensitive content and announcements.

Content Strategy

Analyze how creators use stories as part of their content strategy.

Quick start

Copy this snippet and start making calls.

const res = await fetch('https://api.yepapi.com/v1/tiktok/user-story', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "unique_id": "tiktok"
  }),
});
const data = await res.json();
console.log(data);

TikTok User Story API for ephemeral content tracking

The YepAPI TikTok User Story API fetches a creator's currently active stories. Pass a username and get the live story content — with IDs and creation timestamps — while it is still available, before the short expiry window closes.

It is the endpoint for capturing time-sensitive content that vanishes. Unlike posts or favorites, stories are ephemeral, so pair this with scheduled polling and the TikTok User Profile API to monitor announcements as they happen.

What is a TikTok User Story API?

A TikTok User Story API returns a creator's active, short-lived story content — the ephemeral format that disappears after a brief window — rather than their permanent posts. With YepAPI you POST a unique_id (username) to /v1/tiktok/user-story and receive a stories array where each entry carries an id and a createTime timestamp. Because this content is temporary and TikTok has no open endpoint for it, the API must be called while stories are live; it gives you a real-time snapshot of what a creator is sharing in the moment.

Build your own story-monitoring tool

This endpoint is built for a story-monitoring tool. Maintain a watchlist of creators and poll their stories on a regular interval, capturing each one with its createTime before it expires. Stories often carry announcements, drops, and behind-the-scenes content that never appear as permanent posts, so this is the only way to archive that material reliably. Use the User Profile API to manage your watchlist by handle. One YepAPI key also covers Instagram, where story monitoring is an equally common need.

TikTok User Story API pricing — $0.01 per call

Each story fetch costs $0.01 and returns the creator's currently active stories. Because stories expire quickly, the cost depends on your polling frequency: checking 50 creators every few hours costs roughly a few dollars a day. You pay only per poll, with no subscription, so you can tune frequency to balance freshness against spend.

Why ephemeral content needs real-time polling

Stories differ fundamentally from every other TikTok endpoint: the data exists only briefly, so there is no historical catalog to crawl after the fact. Capturing them requires polling while they are live, which is why createTime matters — it lets you dedupe and detect new stories between polls. For tracking time-sensitive announcements and limited drops, this real-time, snapshot-based approach is the only one that works.

Try the TikTok User Story API free

Start with $5 in free credit and no credit card. That is 500 story polls — enough to run a monitoring tool across a watchlist before you pay. Sign up, copy your key, and check your first creator's stories now.

Start making API calls in 30 seconds

$5 free credit on signup. No credit card required. Pay per call.

Get API Key — Free $5 Credit

What developers say

“Switched from SerpAPI and cut our SERP costs by 80%. Same data quality, way simpler billing.”
Marcus T.
SEO Platform Founder

“One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.”
Priya S.
Full-Stack Developer

“The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.”
Jake R.
Indie Hacker

Frequently asked questions

Fetch the current active stories for a TikTok user. Returns story content and metadata.

Each API call costs $0.01. No monthly minimums or subscriptions — you only pay for what you use.

Sign up for a free API key, then send a POST request to /v1/tiktok/user-story. Check the code example above for a ready-to-use snippet in JavaScript, cURL, or Python.

YepAPI bundles SEO, AI, and web scraping APIs under one key with no monthly minimums. You get lower per-call pricing, a unified dashboard, and one billing account instead of managing multiple providers.