Get user stories

What it does

Returns a paginated list of active stories for a TikTok user. Stories expire after 24 hours and include both images and videos with engagement data.

Tool details

Field	Value
Tool name	`tiktok_get_user_stories`
Platform	TikTok
REST endpoint	`GET /v1/tiktok/users/{username}/stories`
Result type	Collection tool

Parameters

Parameter	Type	Required	Description
`username`	`string`	Yes	TikTok username (with or without @ symbol)
`count`	`integer`	No	Number of stories to fetch (maximum: 35) Default: `4`.
`cursor`	`string`	No	Pagination cursor Default: `0`.
`projection_preset`	`string`	No	Defaults to `minimal`. Allowed values: `full`, `minimal`, `identity`, `engagement`, `content`.
`data_fields`	`string[]`	No	Adds top-level keys from `data` on top of the selected `projection_preset`.
`item_fields`	`string[]`	No	Adds keys from `data.orderedItems[]` on top of the selected `projection_preset`.

Example

{
  "name": "tiktok_get_user_stories",
  "arguments": {
    "username": "khaby.lame",
    "count": 4,
    "projection_preset": "minimal",
    "data_fields": [
      "orderedItems",
      "nextCursor",
      "cursor",
      "itemCount"
    ],
    "item_fields": [
      "entityId",
      "published",
      "content",
      "url",
      "viewCount"
    ]
  }
}

Available data fields

@context
type
partOf
totalItems
cursor
nextCursor
next
itemCount
orderedItems

Available item fields

type
id
url
entityId
content
published
endTime
viewCount
likeCount
commentCount
repostCount
shareCount
saveCount
attributedTo
duration
attachment
image
preview
audio

Response notes

Successful calls return a JSON object with a top-level data field and, when available, metadata.creditsUsed and metadata.creditsRemaining. See response format, pagination, and credits.

Get user collections Get user following list

MCP

Tools

Chat

Automation

Code

What it does

Tool details

Parameters

Example

Available data fields

Available item fields

Response notes

​What it does

​Tool details

​Parameters

​Example

​Available data fields

​Available item fields

​Response notes

What it does

Tool details

Parameters

Example

Available data fields

Available item fields

Response notes