---
description: Fetch information about a video
---

# Video Details

> <mark style="color:purple;">GENERAL ENDPOINT</mark>

## Get the details of a video

<mark style="color:blue;">`GET`</mark> `https://kitkot.xyz/api/video/detail`

Returns the details of a video from `video_url` or `aweme_id`

#### Query Parameters

| Name                                       | Type   | Description                                                                                                                                                                                                                          |
| ------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| api\_key<mark style="color:red;">\*</mark> | String | The `api_key` you got when purchasing our service                                                                                                                                                                                    |
| query<mark style="color:red;">\*</mark>    | String | The `query` to fetch information from, this can be a tiktok share url or the `id` of a tiktok video. You can also query more than 1 video at a time by seperating them by commas: `video_url,video_url,video_url,video_id,video_url` |
| session\_key                               | String | The `session_key` you got from our login endpoint                                                                                                                                                                                    |

{% tabs %}
{% tab title="200: OK VIDEOS_FOUND" %}
{% code overflow="wrap" lineNumbers="true" %}
```json
{
  code: 200,
  video_details: [
    {
      download_urls: [Object],
      author: [Object],       
      stats: [Object],        
      music: [Object],
      created_at_timestamp: ,
      created_at: '',
      video_url: '',
      video_id: '',
      description: '',
      video_length: 28.233,
      status: [Object]
    },
    {
      download_urls: [Object],
      author: [Object],       
      stats: [Object],        
      music: [Object],
      created_at_timestamp: ,
      created_at: '',
      video_url: '',
      video_id: '',
      description: '',
      video_length: 28.233,
      status: [Object]
    }
  ]
}
```
{% endcode %}
{% endtab %}

{% tab title="400: Bad Request INVALID_QUERY" %}
{% code lineNumbers="true" %}
```json
{
  code: 400,
  msg: 'Invalid video_id sent in parameters, must be one of: mobile_url website_url video_id'       
}
```
{% endcode %}
{% endtab %}

{% tab title="200: OK VIDEO_IMAGES_FOUND" %}
{% code overflow="wrap" lineNumbers="true" %}
```json
{
  code: 200,
  video_details: [
    {
      images: [Object],
      author: [Object],
      stats: [Object],
      music: [Object],
      status: [Object],
      created_at_timestamp: ,
      created_at: '',
      video_url: '',
      video_id: '',
      text_extra: [Array],
      is_hash_tag: 1,
      is_ads: false,
      item_duet: 0,
      description: '',
      video_length: 0
    }
  ]
}
```
{% endcode %}
{% endtab %}

{% tab title="400: Bad Request VIDEO_NOT_FOUND" %}
```json
{ 
    code: 400,
    video_details: [],
    msg: 'Invalid parameters'
}
```
{% endtab %}

{% tab title="400: Bad Request INVALID_PARAMETERS" %}
```json
{
    code: 400,
    msg: "Invalid parameters"
}
```
{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="NodeJS" %}
{% code overflow="wrap" lineNumbers="true" %}
```javascript
const fetch = require('node-fetch');

const BASEURL = "https://kitkot.xyz/api";
const API_KEY = "my-api-key";
const query = "https://www.tiktok.com/@tiktok/video/7174475464457588011,https://www.tiktok.com/@tiktok/video/7176740582209883434?is_copy_url=1&is_from_webapp=v1";

const request = await fetch(`${BASEURL}/video/detail?api_key=${API_KEY}&query=${query}`);
const response = await request.json();
console.log(response);
```
{% endcode %}
{% endtab %}

{% tab title="Python" %}
{% code overflow="wrap" lineNumbers="true" %}
```python
import requests

BASEURL = "https://kitkot.xyz/api"
API_KEY = "my-api-key"
query = "https://www.tiktok.com/@tiktok/video/7174475464457588011,https://www.tiktok.com/@tiktok/video/7176740582209883434?is_copy_url=1&is_from_webapp=v1";

request = requests.get(f"{BASEURL}/video/detail?api_key={API_KEY}&query={query}")
response = request.json()
print(response)
```
{% endcode %}
{% endtab %}
{% endtabs %}
