TikTok

Authentication Type: API Key
Description: Integrate with TikTok to fetch post details, user posts, and user information with comprehensive video analytics and engagement metrics.

Posts

Operations for TikTok posts and videos.

Get Post Details

Retrieves detailed information about a specific TikTok post using its video ID.

Operation Type: Query (Read)

Parameters:

• videoId string (required): The TikTok video ID to get details for

Returns:

• id string: The video ID
• desc string: The video description
• createTime string: When the video was created
• author object: Video author information
  • id string: Author ID
  • nickname string: Author nickname
  • uniqueId string: Author unique ID
  • verified boolean: Whether the author is verified
  • signature string (nullable): Author bio/signature
  • avatarThumb string (nullable): Author avatar thumbnail URL
• stats object: Video statistics
  • diggCount number: Number of likes
  • shareCount number: Number of shares
  • commentCount number: Number of comments
  • playCount number: Number of plays
• video object: Video file information
  • id string: Video file ID
  • height number: Video height
  • width number: Video width
  • duration number: Video duration in seconds
  • cover string (nullable): Video cover image URL
  • playAddr string (nullable): Video play URL
  • downloadAddr string (nullable): Video download URL

Example Usage:

{
  "videoId": "7123456789012345678"
}

Get User Posts

Retrieves a list of posts from a specific TikTok user with pagination support.

Operation Type: Query (Read)

Parameters:

• secUid string (required): The user security ID to get posts for
• count string (nullable): Number of posts to retrieve (default: 35)
• cursor string (nullable): Pagination cursor (default: 0)

Returns:

• hasMore boolean: Whether there are more posts available
• cursor string: Next pagination cursor
• itemList array of objects: List of user posts
  • id string: Post ID
  • desc string: Post description
  • createTime number: Post creation timestamp
  • author object: Post author information
    • id string: Author ID
    • nickname string: Author nickname
    • uniqueId string: Author unique ID
    • verified boolean: Whether the author is verified
  • stats object: Post statistics
    • diggCount number: Number of likes
    • shareCount number: Number of shares
    • commentCount number: Number of comments
    • playCount number: Number of plays
  • video object: Video information
    • height number: Video height
    • width number: Video width
    • duration number: Video duration

Example Usage:

{
  "secUid": "MS4wLjABAAAA...",
  "count": "20",
  "cursor": "0"
}

Users

Operations for TikTok user information.

Get User Info

Retrieves user profile information and recent posts for a TikTok user.

Operation Type: Query (Read)

Parameters:

• uniqueId string (required): The unique username/ID to get user info for

Returns:

• userInfo object: User information and statistics
  • user object: User profile information
    • id string: User ID
    • nickname string: User display name
    • uniqueId string: User unique ID/username
    • verified boolean: Whether the user is verified
    • signature string: User bio/signature
    • avatarThumb string: User avatar thumbnail URL
    • avatarMedium string: User avatar medium URL
    • avatarLarger string: User avatar large URL
    • secUid string: User security ID
    • privateAccount boolean: Whether account is private
    • bioLink object (nullable): Bio link information
      • link string: Bio link URL
      • risk number: Link risk score
  • stats object: User statistics
    • followerCount number: Number of followers
    • followingCount number: Number of following
    • heartCount number: Total hearts received
    • videoCount number: Number of videos posted
    • diggCount number: Number of likes given
    • friendCount number: Number of friends
• shareMeta object: Share metadata
  • title string: Page title
  • desc string: Page description

Example Usage:

{
  "uniqueId": "tiktokcreator"
}

Common Use Cases

Content Analysis:

• Analyze video performance and engagement metrics
• Track viral content patterns and trending topics
• Monitor video reach and audience engagement

Creator Research:

• Research TikTok creators and influencers
• Analyze creator content strategies and posting patterns
• Track creator growth and audience engagement

Trend Monitoring:

• Monitor trending videos and viral content
• Analyze hashtag performance and content themes
• Track content performance across different demographics