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.
Prezzi e provider
Prezzi dell'API TikTok User stories: una sola API, 2 provider intercambiabili
Serve per primo il provider più economico. Se fallisce, subentra il successivo nella stessa chiamata.
Provalo
Ottieni TikTok User stories in una sola richiesta
{
"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"
}Riferimento completo di parametri e risposta - ogni campo, tipo ed esempio per questo endpoint.
Riferimento
Una richiesta, una sola forma di risposta.
Ogni campo che invii e ogni campo che ricevi, ciascuno con un esempio reale.
Ultima verifica 2026-10-19 · disponibilità e latenza misurate su 30d
Corpo della richiesta
JSON, inviato a questo endpoint.
- 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.
Risposta
JSON, un valore di esempio per campo.
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.
- expiresUtcnumberpuò richiedere
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
Sull'API TikTok User stories
L'API TikTok User stories di AnyAPI restituisce dati TikTok come JSON normalizzato da una sola chiamata POST a /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 instrada ogni richiesta su 2 fonti e passa automaticamente a un'altra quando una fallisce. Costa da 1,10 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Negli ultimi 30 giorni, il 100,0% delle chiamate TikTok User stories tramite AnyAPI è riuscito, con un tempo di risposta mediano di 1,3 secondi su 1 chiamate misurate.