# TikTok

> Integrate with TikTok to fetch post details, user posts, user information, and search for videos and accounts with comprehensive video analytics.

Source: https://cotera.co/docs/reference/tools/individual-tools/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](https://rapidapi.com/Lundehund/api/tiktok-api23).

**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:**

```json
{
  "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:**

```json
{
  "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:**

```json
{
  "uniqueId": "tiktokcreator"
}
```

***

## Search

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:**

```json
{
  "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:**

```json
{
  "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:**

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

***

## Transcript

Transcription operations for TikTok videos. **Note:** This endpoint uses the [Video Transcript Scraper API](https://rapidapi.com/invideoiq-invideoiq-default/api/video-transcript-scraper) which requires a separate RapidAPI subscription.

### Get Transcript

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

**Operation Type:** Query (Read)

**Parameters:**

* **videoUrl** `string` (required): The full TikTok video URL (e.g., <https://www.tiktok.com/@user/video/1234567890>)

**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:**

```json
{
  "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

