> ## Documentation Index
> Fetch the complete documentation index at: /dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# videos_get

> Everything about one video: stats, comments, transcript, breakdown.

> [!NOTE]
>
> Uses credits · Your own key only

Pick the parts you want. Each part is billed on its own in Constella credits. If some parts fail, the rest still come back with `errors`.

Call it at `POST /platform/v1/me/tools/videos_get`. On MCP, your AI tool calls `videos_get` with the same arguments.

## Arguments

Send these inside `arguments`.

**url** `string` *required*

The video's TikTok, Instagram or YouTube link.

**include** `string[]` (default: \["stats"])

Any of `stats`, `comments`, `transcript` and `breakdown` (a frame-by-frame breakdown of TikTok or Instagram videos up to 3 minutes; about 40 credits).

**save** `boolean` (default: true)

Copy the cover and video to lasting links.

**pages** `integer` (default: 3)

Comment pages, 1-5, about 20 comments each.

## Returns

The tool's answer comes back under `result`.

**stats** `Video`

The video's numbers. `outlier` is views divided by followers.

**comments** `object`

`count_fetched`, `comments` (most liked first), `buy_questions` and `intent_rate`.

**transcript** `object`

`text` and `language`.

**breakdown** `object`

`frames`, `parts`, `style_card` and `pattern_notes`.

```bash Your key theme={"system"}
curl https://api.constella.app/platform/v1/me/tools/videos_get \
  -H "Authorization: Bearer $CONSTELLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"url": "https://www.tiktok.com/@example/video/123", "include": ["stats", "transcript"]}}'
```

```python Python theme={"system"}
import os, requests

r = requests.post(
    "https://api.constella.app/platform/v1/me/tools/videos_get",
    headers={"Authorization": f"Bearer {os.environ['CONSTELLA_API_KEY']}", "X-Constella-Client": "my-script"},
    json={"arguments": {"url": "https://www.tiktok.com/@example/video/123", "include": ["stats", "transcript"]}},
)
print(r.json()["result"])
```

```javascript JavaScript theme={"system"}
const res = await fetch("https://api.constella.app/platform/v1/me/tools/videos_get", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CONSTELLA_API_KEY}`,
    "X-Constella-Client": "my-script",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"arguments": {"url": "https://www.tiktok.com/@example/video/123", "include": ["stats", "transcript"]}}),
});
const { result } = await res.json();
```

```json 200 theme={"system"}
{
  "result": {
    "stats": {
      "views": 2100000,
      "outlier": 51.2
    },
    "transcript": {
      "text": "Here is my morning...",
      "language": "en"
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.