> ## Documentation Index
> Fetch the complete documentation index at: https://api-tools.memories.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok Video Detail

> Get detailed information for TikTok videos.

<Info>
  **Product**: Visual Intelligence — Social Media Scraping
  **Use case**: Fetch video metadata, transcripts, captions, and comments from YouTube, Instagram, TikTok, and Twitter/X
  **Host**: `https://mavi-backend.memories.ai/serve/api/v2`
  **Auth**: `Authorization: sk-mavi-...` (no `Bearer` prefix)
</Info>

This API is used to get detailed information for TikTok videos.

<Note>
  Channel routing guide: see [Social Media Scraping Overview](/visual-intelligence/social-media-scraping-overview). Endpoints with a `channel` request field let you choose `apify`, `rapid`, or `memories.ai`; endpoints without this field use managed routing.
</Note>

<Note>
  Each API call costs **\$0.01 USD**.
</Note>

### Channel Options

If your request supports a `channel` option, use it to control how scraper data is sourced:

| Channel       | What it means                                                                                    | Typical trade-off                                                       |
| ------------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |
| `apify`       | Uses [Apify](https://apify.com/), a dedicated web scraping platform with broad content coverage. | Most stable and most complete results, but usually more expensive.      |
| `rapid`       | Uses [RapidAPI](https://rapidapi.com/), a lower-cost aggregation platform.                       | Lower cost, but less stable and often narrower coverage.                |
| `memories.ai` | Managed routing by Memories.ai.                                                                  | Automatically selects the best price/performance path for your request. |

<Note>
  Recommendation: Start with `memories.ai` unless you need to force a specific provider.
</Note>

### Code Example

<CodeGroup>
  ```python Python theme={null}
  import requests

  BASE_URL = "https://mavi-backend.memories.ai/serve/api/v2"
  API_KEY = "sk-mavi-..."
  HEADERS = {
      "Authorization": f"{API_KEY}",
      "Content-Type": "application/json"
  }

  def tiktok_video_detail(video_id: str):
      url = f"{BASE_URL}/tiktok/video/detail"
      data = {"video_id": video_id}
      resp = requests.post(url, json=data, headers=HEADERS)
      return resp.json()

  # Usage example
  result = tiktok_video_detail("your_tiktok_video_id")
  print(result)
  ```

  ```javascript JavaScript theme={null}
  const axios = require('axios');

  const BASE_URL = 'https://mavi-backend.memories.ai/serve/api/v2';
  const API_KEY = 'sk-mavi-...';

  const headers = {
      'Authorization': API_KEY,
      'Content-Type': 'application/json'
  };

  async function tiktokVideoDetail(videoId) {
      const response = await axios.post(
          `${BASE_URL}/tiktok/video/detail`,
          { video_id: videoId },
          { headers }
      );
      return response.data;
  }

  // Usage example
  tiktokVideoDetail('your_tiktok_video_id')
      .then(result => console.log(result));
  ```

  ```bash cURL theme={null}
  curl -X POST "https://mavi-backend.memories.ai/serve/api/v2/tiktok/video/detail" \
    -H "Authorization: sk-mavi-..." \
    -H "Content-Type: application/json" \
    -d '{
      "video_id": "your_tiktok_video_id"
    }'
  ```
</CodeGroup>

### Request Body

| Field     | Type   | Required | Description                                                         |
| --------- | ------ | -------- | ------------------------------------------------------------------- |
| video\_id | string | Yes      | TikTok video ID — the numeric ID at the end of the TikTok video URL |

<Tip>
  **How to get the `video_id`**: Extract the numeric ID from the end of a TikTok video URL.

  For example, from `https://www.tiktok.com/@cutshall73/video/7543017294226558221`, the `video_id` is `7543017294226558221`.
</Tip>

### Response

Returns detailed information for the TikTok video.

<ResponseExample>
  ```json theme={null}
  {
    "code": 200,
    "msg": "success",
    "data": {
      "id": "7543017294226558221",
      "title": "Video title",
      "description": "Video description",
      "author": {
        "id": "6638037497953681414",
        "name": "username",
        "nick_name": "Display name"
      },
      "stats": {
        "like_count": 1000,
        "comment_count": 100,
        "share_count": 50,
        "view_count": 10000
      },
      "create_time": 1756245606,
      "video_url": "https://...",
      "cover_url": "https://..."
    },
    "success": true,
    "failed": false
  }
  ```
</ResponseExample>

### Response Parameters

| Parameter                 | Type    | Description                                               |
| ------------------------- | ------- | --------------------------------------------------------- |
| code                      | string  | Response code, indicates the operation result status      |
| msg                       | string  | Response message, describes the operation result          |
| data                      | object  | Response data object, contains video detailed information |
| data.id                   | string  | Video ID                                                  |
| data.title                | string  | Video title                                               |
| data.description          | string  | Video description                                         |
| data.author               | object  | Author information                                        |
| data.author.id            | string  | Author ID                                                 |
| data.author.name          | string  | Author username                                           |
| data.author.nick\_name    | string  | Author display name                                       |
| data.stats                | object  | Statistics data                                           |
| data.stats.like\_count    | number  | Like count                                                |
| data.stats.comment\_count | number  | Comment count                                             |
| data.stats.share\_count   | number  | Share count                                               |
| data.stats.view\_count    | number  | View count                                                |
| data.create\_time         | number  | Creation timestamp                                        |
| data.video\_url           | string  | Video URL                                                 |
| data.cover\_url           | string  | Cover image URL                                           |
| success                   | boolean | Indicates whether the operation was successful            |
| failed                    | boolean | Indicates whether the operation failed                    |


## OpenAPI

````yaml POST /tiktok/video/detail
openapi: 3.1.0
info:
  title: Scraper API Reference
  description: REST APIs for scraping TikTok and YouTube video data
  version: v1.0.0
servers:
  - url: https://mavi-backend.memories.ai/serve/api/v2
security:
  - ApiKeyAuth: []
paths:
  /tiktok/video/detail:
    post:
      summary: TikTok Video Detail
      description: >-
        Get detailed information for TikTok videos. Each API call costs $0.01
        USD.
      operationId: tiktok_video_detail
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                video_id:
                  type: string
                  description: TikTok video ID
                  example: '7543017294226558221'
              required:
                - video_id
      responses:
        '200':
          description: Successfully returned video detailed information
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: 200
                    description: Response code, indicates the operation result status
                  msg:
                    type: string
                    example: success
                    description: Response message, describes the operation result
                  data:
                    type: object
                    description: Response data object, contains video detailed information
                  success:
                    type: boolean
                    example: true
                    description: Indicates whether the operation was successful
                  failed:
                    type: boolean
                    example: false
                    description: Indicates whether the operation failed
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization

````