API para 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.
Preços e provedores
Preços do endpoint User stories da API para TikTok: uma API, 2 provedores intercambiáveis
O provedor mais barato atende primeiro. Se ele falhar, o próximo assume na mesma chamada.
Teste
Obtenha User stories do TikTok em uma só requisição
{
"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"
}Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.
Referência
Uma requisição, um formato de resposta.
Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.
Última verificação em 2026-10-19 · disponibilidade e latência medidas em 30d
Corpo da requisição
JSON, enviado via POST para este 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.
Resposta
JSON, um valor de exemplo por 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.
- expiresUtcnumberpode ser exigido
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.
Dúvidas frequentes
Sobre o endpoint User stories da API para TikTok
O endpoint User stories da AnyAPI para TikTok retorna dados de TikTok em JSON normalizado com uma chamada POST para /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. A AnyAPI distribui cada requisição entre 2 fontes, com failover automático quando uma falha. Custa a partir de US$ 1,10 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint User stories da API para TikTok feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,3 segundos, em 1 chamadas medidas.