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.
Цены и поставщики
Цена API TikTok User stories: один API, поставщиков 2, и любой может заменить другого
Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.
Попробовать
Получите TikTok User stories одним запросом
{
"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"
}Полный справочник по параметрам и ответу: каждое поле, тип и пример для этого эндпоинта.
Справочник
Один запрос, один формат ответа.
Каждое поле, которое вы отправляете, и каждое поле, которое получаете, с реальным примером.
Проверено 2026-10-19 · доступность и задержка измерены за 30d
Тело запроса
JSON, отправляется на этот эндпоинт.
- 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.
Ответ
JSON, по одному примеру значения на поле.
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.
- expiresUtcnumberможет потребовать
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.
Вопросы и ответы
Об API TikTok User stories
AnyAPI TikTok User stories API возвращает данные TikTok в виде нормализованного JSON одним вызовом POST к /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 направляет каждый запрос по источникам (их 2) и автоматически переключается, если один из них отказывает. Это стоит от 1,10 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. За последние 30 дней 100,0% вызовов TikTok User stories через AnyAPI завершились успешно, медианное время ответа 1,3 с, измерено вызовов: 1.