Xingtu creator videos API
A creator's videos with the views, likes, comments, completion and interaction rates Xingtu shows, 20 a page.
| Item | Value |
|---|---|
| Endpoint | GET https://api.feedmcp.com/v1/douyin/xingtu/creators/videos/list |
| ID | douyin.xingtu.creators.videos.list |
| Price | $0.004 / call |
| Returns | A page of Post objects |
| Auth | Authorization: Bearer $FEEDMCP_API_KEY |
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Xingtu creator ID (from douyin.xingtu.creators.lookup or the creator search) |
cursor |
string | no | Pagination cursor. Leave it out for the first page; pass page.next_cursor for the next. Each page is billed on its own |
Every endpoint also takes view=full to include the platform's raw data as raw, at the same price.
Returned fields
data.items is a list of Post objects, 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.004 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
curl "https://api.feedmcp.com/v1/douyin/xingtu/creators/videos/list?id=7439277672863105076" \
-H "Authorization: Bearer $FEEDMCP_API_KEY"
Python
import os, requests
r = requests.get(
"https://api.feedmcp.com/v1/douyin/xingtu/creators/videos/list",
params={"id": "7439277672863105076"},
headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
timeout=30,
)
print(r.json())
JavaScript
const res = await fetch("https://api.feedmcp.com/v1/douyin/xingtu/creators/videos/list?id=7439277672863105076", {
headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());
MCP
From an AI with FeedMCP installed, the call tool:
{
"endpoint": "douyin.xingtu.creators.videos.list",
"params": {
"id": "7439277672863105076"
},
"max_price": "0.004"
}
Response
The data below is made up; the shape is the real one.
{
"code": "ok",
"request_id": "req_7Qm2kXb9TzLp",
"data": {
"items": [
{
"id": "7709359557318823171",
"platform": "douyin",
"type": "video",
"url": "https://www.douyin.com/video/7709359557318823171",
"title": null,
"text": "雪地里的木屋 1",
"created_at": "2025-11-17T21:06:40.000Z",
"author": {
"id": "7439277672863105076",
"name": null
},
"metrics": {
"views": 2950162,
"likes": 18731,
"comments": 676,
"shares": null,
"favorites": null,
"completion_rate": 0.1285,
"interaction_rate": 0.0063
},
"cover": null,
"duration_seconds": 291
},
{
"id": "7709359557318823172",
"platform": "douyin",
"type": "video",
"url": "https://www.douyin.com/video/7709359557318823172",
"title": null,
"text": "雪地里的木屋 2",
"created_at": "2025-11-16T21:06:40.000Z",
"author": {
"id": "7439277672863105076",
"name": null
},
"metrics": {
"views": 2950162,
"likes": 18731,
"comments": 676,
"shares": null,
"favorites": null,
"completion_rate": 0.1285,
"interaction_rate": 0.0063
},
"cover": null,
"duration_seconds": 291
}
]
},
"page": {
"next_cursor": "eyJjdXJzb3IiOjIwfQ",
"has_more": true
},
"warnings": [],
"meta": {
"endpoint": "douyin.xingtu.creators.videos.list",
"platform": "douyin",
"fetched_at": "2026-11-19T08:00:00.000Z",
"source": "FeedMCP",
"catalog_revision": "d09a736bd39e8b3f",
"billing": {
"charged": true,
"amount": "0.004",
"currency": "USD",
"balance": "9.98"
}
}
}
Errors are described in Errors: each says whether you were charged (charged) and whether to retry (retry).
Other Douyin endpoints
- Douyin video:$0.002
- Douyin video comments:$0.002
- Douyin account:$0.002
- Douyin account videos:$0.002
- Douyin trending list:$0.002
- Douyin video search:$0.02
- Douyin comment replies:$0.002
- Douyin account search:$0.002
- Douyin account to Xingtu ID:$0.002
- Xingtu creator search:$0.004
- Xingtu creator profile:$0.004
- Xingtu creator rates:$0.04
- Xingtu creator follower profile:$0.004
- Xingtu creator viewer profile:$0.004
- Xingtu creator performance:$0.004
- Xingtu creator cost estimate:$0.006
- Xingtu creator content mix:$0.004
- Xingtu similar creators:$0.002
- Xingtu video report:$0.004
- Douyin keyword index:$0.006
- Douyin related keywords:$0.002
- Douyin keyword audience:$0.002
- Douyin live topics:$0.002
- Douyin high-index videos:$0.002
- Douyin creator core figures:$0.002
- Douyin creator audience (Ocean Engine):$0.002
- Douyin creator top videos:$0.002
- Douyin account daily figures:$0.002
Questions
How much does the Xingtu creator videos endpoint cost?
$0.004 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/; an account is the sec_user_id after /user/, not the Douyin handle.
How do I get more items?
When the answer has page.next_cursor, pass it back as cursor for the next page. Each page is billed on its own.
How do I use it from an AI?
Install the MCP server and ask; your AI calls douyin.xingtu.creators.videos.list.