Skip to content
Managed gateway · LeanPool

Stories

A user's active 24-hour stories.

GETapi.tikultra.com/v1/user/storiesStandard · 5 credits
Upstream/tiktok/story/archive/detail/v1/tiktok/story/archive/list/v1Exclusive{ cursor, has_more }Every plan

Parameters

NameTypeDescription
usernameone of thesestringThe @username, without the @.
e.g. acme
sec_uidone of thesestringThe stable account ID used by the mobile API.
uidone of thesestringThe numeric user ID.
cursorstringThe cursor from the previous page. Omit it for the first page.
countintegerItems per page.
e.g. 20

Pricing

PlanPer callPer 1,000 calls
Starter5 credits$0.58
Growth5 credits$0.40
Scale5 credits$0.29

Responses

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Errors return a JSON body with a stable code and cost 0 credits. Error codes

curl -G https://api.tikultra.com/v1/user/stories \
  -H "x-api-key: $TIKULTRA_KEY" \
  --data-urlencode "username=acme"
{
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "story_id": "7705870000111222333",
      "create_time": 1762870000,
      "expires_at": 1762956400,
      "media": "video",
      "view_count": 18204
    }
  ]
}
Try it in the playgroundFull reference in the docs

More in Users & profiles

GET/v1/userGet profile5 crGET/v1/user/postsProfile posts5 crGET/v1/user/with-postsProfile with posts10 crPOST/v1/user/stories/batchBatch stories10 crGET/v1/user/repostsReposts5 crGET/v1/user/favoritesFavorites5 crGET/v1/user/playlistsPlaylists5 crGET/v1/user/followersFollowers10 crGET/v1/user/followingsFollowings10 crGET/v1/user/followers/searchSearch followers10 crGET/v1/user/followings/searchSearch followings10 crGET/v1/user/similarSimilar creators10 crGET/v1/user/collectionsCollections5 crGET/v1/user/collections/videosCollection videos5 crGET/v1/user/locate-postLocate post10 crGET/v1/user/seriesCreator series10 crGET/v1/user/auditCreator audit25 crGET/v1/user/visibilityVisibility check25 crGET/v1/user/compareCompare creators25 crGET/v1/user/check-usernameCheck username2 crPOST/v1/user/bulk-checkBulk profile check5 cr / item

Ready to build?

Start with 2,500 free credits and test every public endpoint, then pick a plan.

Get an API keySee pricing