<p class="crumbs"><a href="/apis/">Data APIs</a> / <a href="/apis/tiktok/">TikTok</a></p>

# TikTok video API

One video: caption, hashtags, cover, duration, author, and its views, likes, comments, shares and saves.

| Item | Value |
| --- | --- |
| Endpoint | `GET https://api.feedmcp.com/v1/tiktok/videos/get` |
| ID | `tiktok.videos.get` |
| Price | **$0.002** / call |
| Returns | One Post object |
| Auth | `Authorization: Bearer $FEEDMCP_API_KEY` |

> Takes a video ID or a full link; vm.tiktok.com short links are not supported yet: open them once and copy the full link.

## Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | <span class="nw">one of</span> | Video ID |
| `url` | string | <span class="nw">one of</span> | Video link (tiktok.com/@user/video/number); vm.tiktok.com short links are not supported yet |

Every endpoint also takes `view=full` to include the platform's raw data as `raw`, at the same price.

## Returned fields

`data.item` is one Post object, with the same fields on every platform:

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | The platform ID, which the platform's detail endpoint takes: TikTok or Douyin video ID, YouTube video ID, Instagram or Threads code, X post ID, Telegram "channel/number", Reddit short ID, LinkedIn activity number, Pinterest pin number, Kuaishou 3x… video ID, WeChat Channels object ID, Zhihu answer, question or article ID, Xiaohongshu note ID, BV ID, Weibo ID or article ID |
| `platform` | string | Platform: tiktok, youtube, instagram, x, threads, telegram, reddit, linkedin, facebook, pinterest, xiaohongshu, douyin, kuaishou, wechat_mp, wechat_channels, weibo, zhihu or bilibili |
| `type` | string | video, note, article, post (Weibo, X, Threads, Telegram, Reddit, LinkedIn, Facebook, Pinterest, Instagram photos), question or answer (Zhihu) |
| `url` | string | Link to the original |
| `title` | string \| null | Title (YouTube, Reddit, Pinterest, Bilibili, Xiaohongshu and WeChat; for a Zhihu answer, its question; null elsewhere) |
| `text` | string \| null | Body text or caption |
| `created_at` | string \| null | Published at, ISO 8601, UTC |
| `author.id` | string \| null | Author ID; pass it straight to that platform's account endpoints |
| `author.name` | string \| null | Author name |
| `metrics.views` | number \| null | Views or plays (null when the platform hides it) |
| `metrics.likes` | number \| null | Likes (score on Reddit, total reactions on Facebook) |
| `metrics.comments` | number \| null | Comments |
| `metrics.shares` | number \| null | Shares or reposts (reposts on X) |
| `metrics.quotes` | number \| null | Quotes (X and Threads) |
| `metrics.reactions` | number \| null | Total reactions (Telegram only) |
| `metrics.answers` | number \| null | Answers (Zhihu questions only) |
| `metrics.upvote_ratio` | number \| null | Upvote ratio from 0 to 1 (Reddit only) |
| `metrics.repins` | number \| null | Repins (Pinterest only) |
| `metrics.favorites` | number \| null | Saves (bookmarks on X, saves on Pinterest) |
| `cover` | string \| null | Cover image URL |
| `duration_seconds` | number \| null | Video length in seconds |
| `tags` | string[] | Hashtags (the flair on Reddit) |
| `community` | string \| null | Subreddit (Reddit only) |
| `link` | string \| null | The page a pin links to (Pinterest only) |

## When you are charged

$0.002 per call that returns data. Not found, no data, bad parameters, platform errors and timeouts are free.

Each answer carries `meta.billing`: what this call cost and the balance left.

## Request

### cURL

```bash
curl "https://api.feedmcp.com/v1/tiktok/videos/get?id=7700200904678559006" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"
```

### Python

```python
import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/tiktok/videos/get",
    params={"id": "7700200904678559006"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())
```

### JavaScript

```js
const res = await fetch("https://api.feedmcp.com/v1/tiktok/videos/get?id=7700200904678559006", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());
```

### MCP

From an AI with FeedMCP installed, the `call` tool:

```json
{
  "endpoint": "tiktok.videos.get",
  "params": {
    "id": "7700200904678559006"
  },
  "max_price": "0.002"
}
```

## Response

The data below is made up; the shape is the real one.

```json
{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "item": {
      "id": "7700200904678559001",
      "platform": "tiktok",
      "type": "video",
      "url": "https://www.tiktok.com/@trail.mia/video/7700200904678559001",
      "title": null,
      "text": "Rainy night in a tiny tent #camping #outdoors 1",
      "created_at": "2025-11-18T20:06:40.000Z",
      "author": {
        "id": "trail.mia",
        "name": "Mia on the Trail",
        "avatar": "https://p16-sign.tiktokcdn.com/avatar.jpg"
      },
      "metrics": {
        "views": 1220001,
        "likes": 77600,
        "comments": 511,
        "shares": 3089,
        "favorites": 6282
      },
      "cover": "https://p16-sign.tiktokcdn.com/cover.jpg",
      "duration_seconds": 47,
      "tags": [
        "camping",
        "outdoors"
      ]
    }
  },
  "page": null,
  "warnings": [],
  "meta": {
    "endpoint": "tiktok.videos.get",
    "platform": "tiktok",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.002",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}
```

Errors are described in [Errors](/docs/errors/): each says whether you were charged (`charged`) and whether to retry (`retry`).

## Other TikTok endpoints

- [TikTok video search](/apis/tiktok/videos/search/)：$0.002
- [TikTok video comments](/apis/tiktok/videos/comments/list/)：$0.002
- [TikTok profile](/apis/tiktok/users/get/)：$0.002
- [TikTok account videos](/apis/tiktok/users/videos/list/)：$0.002
- [TikTok trending searches](/apis/tiktok/trends/list/)：$0.002
- [TikTok ad search](/apis/tiktok/ads/search/)：$0.002
- [TikTok ad](/apis/tiktok/ads/get/)：$0.002
- [TikTok Shop product search](/apis/tiktok/shop/products/search/)：$0.002
- [TikTok Shop product](/apis/tiktok/shop/products/get/)：$0.002
- [TikTok Shop product reviews](/apis/tiktok/shop/products/reviews/list/)：$0.002
- [TikTok Shop seller products](/apis/tiktok/shop/sellers/products/list/)：$0.002
- [TikTok comment replies](/apis/tiktok/videos/comments/replies/list/)：$0.002
- [TikTok account search](/apis/tiktok/users/search/)：$0.002
- [TikTok transcript](/apis/tiktok/videos/transcript/get/)：$0.002

## Questions

### How much does the TikTok video endpoint cost?

$0.002 per call that returns data. Not found, no data, bad parameters, platform errors and timeouts are free.

### Do I need a platform account?

No. Only public data is read.

### Where do I find the ID or link?

A video ID is the number after /video/ in a video link; an account is the username after @ (without the @); a TikTok Shop product is the number after /pdp/, a shop is shop.id in a product.

### How do I use it from an AI?

Install the [MCP server](/mcp/) and ask; your AI calls `tiktok.videos.get`.

---

HTML version: https://feedmcp.com/apis/tiktok/videos/get/
