TikTok-User stories-API
Get a TikTok creator's active public stories by username: video or photo links, cover, posting and expiry times, and view, like, share and save counts.
Preise und Anbieter
Preise der TikTok-User stories-API: eine API, 2 austauschbare Anbieter
Der günstigste Anbieter bedient zuerst. Fällt er aus, übernimmt der nächste im selben Aufruf.
Ausprobieren
TikTok User stories mit einer Anfrage abrufen
{
"data": {
"stories": [
{
"authorHandle": "alex_rivera",
"caption": "A short example description of this item.",
"comments": 12500,
"createdUtc": 12.5,
"durationSeconds": 12.5,
"expiresUtc": 12.5,
"id": "a1b2c3d4",
"image": "https://example.com/image.jpg",
"imageUrls": [
"https://example.com/image.jpg"
],
"likes": 12500,
"saves": 42,
"shares": 13,
"soundTitle": "Example title",
"url": "https://example.com/page",
"videoUrl": "https://example.com/page",
"views": 12500
}
]
},
"found": true,
"reason": "not_found"
}Vollständige Parameter- und Antwortreferenz: jedes Feld, jeder Typ und jedes Beispiel für diesen Endpoint.
Referenz
Eine Anfrage, eine Antwortstruktur.
Jedes Feld, das du sendest, und jedes Feld, das du zurückbekommst, jeweils mit einem echten Beispiel.
Zuletzt geprüft 2026-10-19 · Verfügbarkeit und Latenz gemessen über 30d
Request-Body
JSON, per POST an diesen Endpoint gesendet.
- handlestring
jasonderulo
TikTok username, without the @ (e.g. "jasonderulo").
- requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `expiresUtc`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a story that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Antwort
JSON, ein Beispielwert pro Feld.
The account's active public stories, up to 20, oldest first. Populated whenever the provider has data for the entity.
- authorHandlestring
Author's TikTok handle, without the leading @.
- captionstring
Caption text; usually empty on stories.
- commentsinteger
Comment count.
- createdUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.
- durationSecondsnumber
Video length in seconds; 0 for a photo story.
- expiresUtcnumberkann erfordern
When the story stops being visible. UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Null when this source does not report it.
- idstring
Story (video or photo post) id. Populated whenever the provider has data for the entity.
- imagestring
Cover image URL. Signed and short-lived, so keep the query string. Populated whenever the provider has data for the entity.
- imageUrlsstring[]
Photo URLs for a photo story; empty for a video story. Signed and short-lived.
- likesinteger
Like count.
- savesinteger
Save (favorite) count.
- sharesinteger
Share count.
- soundTitlestring
Name of the sound the story uses; null when it has none.
- urlstring
The story on tiktok.com. Populated whenever the provider has data for the entity.
- videoUrlstring
Playable video URL for a video story; null for a photo story. Signed and short-lived, so keep the query string.
- viewsinteger
Play count.
- foundboolean
True when the account has active public stories; false when it has none right now or the account does not exist. Stories last 24 hours, so the same account can flip between the two.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
Über die TikTok-User stories-API
Die AnyAPI-TikTok-User stories-API liefert TikTok-Daten als normalisiertes JSON aus einem POST-Aufruf an /v1/run/tiktok.user_stories. Get a TikTok creator's active public stories by username: video or photo links, cover, posting and expiry times, and view, like, share and save counts. AnyAPI routet jede Anfrage über 2 Quellen und weicht automatisch aus, wenn eine ausfällt. Sie kostet ab 1,10 USD pro 1.000 Anfragen, in US-Dollar, ohne Abo und ohne monatliches Minimum. In den letzten 30 Tagen waren 100,0% der TikTok User stories-Aufrufe über AnyAPI erfolgreich, bei einer mittleren Antwortzeit von 1,3 Sekunden über 1 gemessene Aufrufe.