> ## Documentation Index > Fetch the complete documentation index at: https://docs.agentbody.io/llms.txt > Use this file to discover all available pages before exploring further. # List TikTok story posts > Use this operation to list the active public stories of one TikTok account with direct no-watermark and watermarked video URLs, covers, music metadata, and engagement counts. Pass a tiktok.com profile URL, a bare @handle, or a plain username. Returns up to 10 current story items while the 24-hour story window is open. This is separately billed. ## OpenAPI ````yaml /api-reference/openapi.json post /v1/tiktok/story/posts openapi: 3.1.0 info: description: >- Direct authenticated APIs for public social data, people data, transcripts, documents, text, and SEO. Send an API key as a Bearer token. Responses never include provider credentials or raw provider payloads. license: name: Proprietary url: https://agentbody.io title: AgentBody API version: 2026-10-09.1 servers: - url: https://api.agentbody.io security: - bearerAuth: [] paths: /v1/tiktok/story/posts: post: tags: - tiktok summary: List TikTok story posts description: >- Use this operation to list the active public stories of one TikTok account with direct no-watermark and watermarked video URLs, covers, music metadata, and engagement counts. Pass a tiktok.com profile URL, a bare @handle, or a plain username. Returns up to 10 current story items while the 24-hour story window is open. This is separately billed. operationId: post_v1_tiktok_story_posts parameters: - $ref: '#/components/parameters/IdempotencyKey' requestBody: content: application/json: schema: $ref: '#/components/schemas/TikTokStoryPostsRequest' required: true responses: '200': $ref: '#/components/responses/TikTokStoryPostsSuccess' '400': content: application/json: example: error: code: INVALID_ARGUMENT message: example error schema: additionalProperties: false properties: error: additionalProperties: false properties: code: const: INVALID_ARGUMENT type: string message: type: string required: - code - message type: object required: - error type: object description: Correct the input; do not retry unchanged. headers: X-Request-Id: description: Gateway request identifier for support and audit. schema: format: uuid type: string '401': content: application/json: example: error: code: UNAUTHENTICATED message: example error schema: additionalProperties: false properties: error: additionalProperties: false properties: code: const: UNAUTHENTICATED type: string message: type: string required: - code - message type: object required: - error type: object description: Configure a valid API key; do not retry unchanged. headers: X-Request-Id: description: Gateway request identifier for support and audit. schema: format: uuid type: string '409': content: application/json: example: error: code: CONFLICT message: example error schema: additionalProperties: false properties: error: additionalProperties: false properties: code: const: CONFLICT type: string message: type: string required: - code - message type: object required: - error type: object description: Follow the documented Idempotency-Key behavior before retrying. headers: X-Request-Id: description: Gateway request identifier for support and audit. schema: format: uuid type: string '502': content: application/json: example: error: code: UPSTREAM_INVALID_RESPONSE message: example error schema: additionalProperties: false properties: error: additionalProperties: false properties: code: const: UPSTREAM_INVALID_RESPONSE type: string message: type: string required: - code - message type: object required: - error type: object description: Retry with backoff, then report temporary unavailability. headers: X-Request-Id: description: Gateway request identifier for support and audit. schema: format: uuid type: string '503': content: application/json: example: error: code: UPSTREAM_UNAVAILABLE message: example error schema: additionalProperties: false properties: error: additionalProperties: false properties: code: const: UPSTREAM_UNAVAILABLE type: string message: type: string required: - code - message type: object required: - error type: object description: Retry with backoff, then report temporary unavailability. headers: X-Request-Id: description: Gateway request identifier for support and audit. schema: format: uuid type: string '504': content: application/json: example: error: code: UPSTREAM_TIMEOUT message: example error schema: additionalProperties: false properties: error: additionalProperties: false properties: code: const: UPSTREAM_TIMEOUT type: string message: type: string required: - code - message type: object required: - error type: object description: Retry with backoff, then report temporary unavailability. headers: X-Request-Id: description: Gateway request identifier for support and audit. schema: format: uuid type: string components: parameters: IdempotencyKey: description: Optional key for safely retrying a billable write request. example: request-20260819-001 in: header name: Idempotency-Key required: false schema: maxLength: 255 minLength: 1 type: string schemas: TikTokStoryPostsRequest: additionalProperties: false properties: username: description: >- TikTok account reference — profile URL (tiktok.com/@handle), bare @handle, or plain username. Only public accounts with active stories are supported. type: string required: - username type: object TikTokStoryPostsResult: additionalProperties: false properties: items: items: $ref: '#/components/schemas/TikTokStoryItem' type: array total: format: int64 type: integer username: description: The normalized username of the profile whose stories were listed. type: string required: - username - items - total type: object TikTokStoryItem: additionalProperties: false properties: comment_count: format: int64 type: integer cover_url: format: uri type: string created_at: description: Story publish time (RFC3339) when reported upstream. type: string duration_seconds: type: number id: type: string like_count: format: int64 type: integer music_author: type: string music_title: type: string play_count: format: int64 type: integer region: type: string share_count: format: int64 type: integer video_url: description: Direct no-watermark story video URL (short-lived upstream CDN link). format: uri type: string video_url_watermark: description: >- Direct story video URL with TikTok watermark (short-lived upstream CDN link). format: uri type: string required: - id - video_url type: object responses: TikTokStoryPostsSuccess: content: application/json: example: items: - comment_count: 0 cover_url: https://example.com/cover.jpg created_at: '2026-03-23T06:40:35.280Z' duration_seconds: 15 id: '7620014841440341270' like_count: 549 music_author: Cartoonnasx music_title: original sound - cartoonnasx play_count: 5266 region: AT share_count: 30 video_url: https://v31-jp.tiktokcdn.com/story.mp4 video_url_watermark: https://v31-jp.tiktokcdn.com/story-wm.mp4 total: 1 username: isi.cos schema: $ref: '#/components/schemas/TikTokStoryPostsResult' description: Active public stories for the TikTok account with direct media URLs. headers: X-Request-Id: description: Gateway request identifier for support and audit. schema: format: uuid type: string securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.