cotera
Logo

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.

Authentication

To authenticate, you'll need a RapidAPI key for the TikTok API.

Note: The free plan includes 10 requests per day (100 per month).

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"
}

Search operations for TikTok content and accounts.

Search General

Search TikTok for videos, users, and other content by keyword with pagination support.

Operation Type: Query (Read)

Parameters:

  • keyword string (required): Search keyword
  • cursor number (nullable): Pagination cursor (default: 0). Use value from previous response for next page.
  • searchId string (nullable): Search ID for pagination (default: 0). Use value from previous response for next page.

Returns:

  • cursor number: Cursor for next page
  • hasMore boolean: Whether there are more results
  • searchId string: Search ID for pagination
  • items array of objects: List of search results
    • id string (nullable): Video ID
    • desc string (nullable): Video description
    • createTime number (nullable): Video creation timestamp
    • author object (nullable): Video author information
      • id string (nullable): Author ID
      • uniqueId string (nullable): Author unique username
      • nickname string (nullable): Author display name
      • avatarThumb string (nullable): Author avatar thumbnail URL
      • verified boolean (nullable): Whether the author is verified
    • music object (nullable): Video music information
      • id string (nullable): Music ID
      • title string (nullable): Music title
      • authorName string (nullable): Music author name
      • original boolean (nullable): Whether the music is original
    • video object (nullable): Video file information
      • id string (nullable): Video file ID
      • height number (nullable): Video height in pixels
      • width number (nullable): Video width in pixels
      • duration number (nullable): Video duration in seconds
      • ratio string (nullable): Video ratio/quality
      • cover string (nullable): Video cover image URL
    • stats object (nullable): Video statistics
      • diggCount number (nullable): Number of likes
      • shareCount number (nullable): Number of shares
      • commentCount number (nullable): Number of comments
      • playCount number (nullable): Number of plays
      • collectCount number (nullable): Number of saves/collects

Example Usage:

{
  "keyword": "cooking recipes",
  "cursor": null,
  "searchId": null
}

Search Videos

Search TikTok specifically for videos by keyword with pagination support.

Operation Type: Query (Read)

Parameters:

  • keyword string (required): Search keyword
  • cursor number (nullable): Pagination cursor (default: 0). Use value from previous response for next page.
  • searchId string (nullable): Search ID for pagination (default: 0). Use value from previous response for next page.

Returns:

  • cursor number: Cursor for next page
  • hasMore boolean: Whether there are more results
  • searchId string: Search ID for pagination
  • items array of objects: List of video results
    • id string (nullable): Video ID
    • desc string (nullable): Video description
    • createTime number (nullable): Video creation timestamp
    • author object (nullable): Video author information
      • id string (nullable): Author ID
      • uniqueId string (nullable): Author unique username
      • nickname string (nullable): Author display name
      • avatarThumb string (nullable): Author avatar thumbnail URL
      • verified boolean (nullable): Whether the author is verified
    • music object (nullable): Video music information
      • id string (nullable): Music ID
      • title string (nullable): Music title
      • authorName string (nullable): Music author name
      • original boolean (nullable): Whether the music is original
    • video object (nullable): Video file information
      • id string (nullable): Video file ID
      • height number (nullable): Video height in pixels
      • width number (nullable): Video width in pixels
      • duration number (nullable): Video duration in seconds
      • ratio string (nullable): Video ratio/quality
      • cover string (nullable): Video cover image URL
    • stats object (nullable): Video statistics
      • diggCount number (nullable): Number of likes
      • shareCount number (nullable): Number of shares
      • commentCount number (nullable): Number of comments
      • playCount number (nullable): Number of plays
      • collectCount number (nullable): Number of saves/collects

Example Usage:

{
  "keyword": "cat videos",
  "cursor": null,
  "searchId": null
}

Search Accounts

Search TikTok for user accounts by keyword with pagination support.

Operation Type: Query (Read)

Parameters:

  • keyword string (required): Search keyword (e.g., username or name)
  • cursor number (nullable): Pagination cursor (default: 0). Use value from previous response for next page.
  • searchId string (nullable): Search ID for pagination (default: 0). Use value from previous response for next page.

Returns:

  • cursor number: Cursor for next page
  • hasMore boolean: Whether there are more results
  • searchId string: Search ID for pagination
  • users array of objects: List of user results
    • id string (nullable): User ID
    • uniqueId string (nullable): User unique username
    • nickname string (nullable): User display name
    • signature string (nullable): User bio/signature
    • avatarThumb string (nullable): User avatar thumbnail URL
    • verified boolean (nullable): Whether the user is verified
    • followerCount number (nullable): Number of followers
    • totalFavorited number (nullable): Total likes received
    • secUid string (nullable): User security ID for API calls

Example Usage:

{
  "keyword": "taylor swift",
  "cursor": null,
  "searchId": null
}

Transcript

Transcription operations for TikTok videos. Note: This endpoint uses the Video Transcript Scraper API which requires a separate RapidAPI subscription.

Get Transcript

Extracts the transcript/captions from a TikTok video with timestamps.

Operation Type: Query (Read)

Parameters:

Returns:

  • videoInfo object (nullable): Video metadata
    • title string (nullable): Video title
    • description string (nullable): Video description
    • thumbnail string (nullable): Video thumbnail URL
    • duration number (nullable): Video duration in seconds
    • views number (nullable): Number of views
  • transcript array of objects: Transcript segments with timestamps
    • text string: Transcribed text segment
    • start number: Start time in seconds
    • end number: End time in seconds

Example Usage:

{
  "videoUrl": "https://www.tiktok.com/@user/video/1234567890123456789"
}

Common Use Cases

Content Discovery:

  • Search for videos by keyword to find relevant content
  • Discover trending topics and viral videos
  • Find content related to specific hashtags or themes

Content Analysis:

  • Analyze video performance and engagement metrics
  • Track viral content patterns and trending topics
  • Monitor video reach and audience engagement
  • Extract transcripts for content analysis and text mining

Creator Research:

  • Search for TikTok creators and influencers by name
  • Research creator content strategies and posting patterns
  • Track creator growth and audience engagement
  • Find creators in specific niches or industries

Trend Monitoring:

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

Accessibility & Transcription:

  • Extract video transcripts for accessibility purposes
  • Convert spoken content to searchable text
  • Analyze what creators are saying in their videos