> ## 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 profile followers > Use this operation to list a sample of public follower accounts for one TikTok profile. Pass a tiktok.com profile URL, a bare @handle, or a plain username. The response contains up to 50 follower profiles with public metadata. Only public accounts are supported; the returned list is a sample of the follower set, not the complete follower list. ## OpenAPI ````yaml /api-reference/openapi.json post /v1/tiktok/profile/followers 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/profile/followers: post: tags: - tiktok summary: List TikTok profile followers description: >- Use this operation to list a sample of public follower accounts for one TikTok profile. Pass a tiktok.com profile URL, a bare @handle, or a plain username. The response contains up to 50 follower profiles with public metadata. Only public accounts are supported; the returned list is a sample of the follower set, not the complete follower list. operationId: post_v1_tiktok_profile_followers parameters: - $ref: '#/components/parameters/IdempotencyKey' requestBody: content: application/json: schema: $ref: '#/components/schemas/TikTokProfileFollowersRequest' required: true responses: '200': $ref: '#/components/responses/TikTokProfileFollowersSuccess' '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: TikTokProfileFollowersRequest: additionalProperties: false properties: max_results: default: 50 description: Maximum number of follower profiles to return (1-50). format: int32 maximum: 50 minimum: 1 type: integer username: description: >- TikTok account reference — profile URL (tiktok.com/@handle), bare @handle, or plain username. The account must be public. type: string required: - username type: object TikTokProfileFollowersResult: additionalProperties: false properties: items: items: additionalProperties: false properties: avatar_url: format: uri type: string bio: type: string display_name: type: string followers: format: int64 type: integer following: format: int64 type: integer likes: format: int64 type: integer profile_url: format: uri type: string username: type: string verified: type: boolean required: - username - profile_url - verified type: object type: array total: format: int64 type: integer username: description: The normalized username of the profile whose followers were listed. type: string required: - username - total - items type: object responses: TikTokProfileFollowersSuccess: content: application/json: example: items: - avatar_url: https://example.com/avatar.jpg bio: example bio display_name: Example User followers: 1200 following: 300 likes: 45000 profile_url: https://www.tiktok.com/@example username: example verified: false total: 1 username: khaby.lame schema: $ref: '#/components/schemas/TikTokProfileFollowersResult' description: Sample of public follower profiles for the TikTok account. 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.