Douyin content-link lookup
Douyin content-link lookup. Follow concrete contracts, examples and reviewable steps using Douyin.
Copy the agent prompt manually
Douyin content lookup
Paste a complete link or identifier, then explicitly run a fictional local sample. The source URL is never requested and no credits are spent.
Use a complete URL or platform identifier. Open short links yourself and copy the complete address. Editing clears the old result and does not execute anything.
Fictional fixture · 0 live calls · 0 charges
Inspect complete JSON
Input and result
This tool maps the task to douyin.videos.get. Check the input fields below, then run it in the local console; results are fixtures.
Input contract
Inspect meanings, examples and conditional rules for the selected method. view and fields control the response without changing the TEST unit price.
- GET: supply exactly one of id / url.
| Method | Field | Type | Requirement | Meaning | Enum or bound | Example |
|---|---|---|---|---|---|---|
| GET | id | string | Optional / conditional | Video ID, a string of digits. With only a link or a share text, give it as url | — | "7694940173372575014" |
| GET | url | string | Optional / conditional | Link to the video, pasted as it is: the https://www.douyin.com/video/… web link, a web link with modal_id in it, the page a share opens on a phone, the v.douyin.com short link the app copies, or a whole share text with one of these in it. A short link is opened once to see which video it leads to | — | — |
| GET | view | string | Optional / conditional | How much of each item: compact (the most used fields, long text cut short), standard, or full (adds `ext`). | ["compact","standard","full"] | — |
| GET | fields | array | Optional / conditional | Return only these fields of each item, by path (`author.name`). | maxItems: 64 | — |
Try it locally
Use demo to inspect the fields, then explicitly select simulated with a customer test key to exercise settlement. Never put a customer key in a URL.
{
"capability": "douyin.videos.get",
"method": "GET",
"params": {
"id": "7694940173372575014"
}
}Output fields and interpretation
The post object permits missing or null values; do not replace missing measurements with zero. This table shows the main structure; the object reference covers nested fields.
| Field | Type | Meaning | Source scope |
|---|---|---|---|
| id | string | null | ID; pass it unchanged to the get endpoint | Douyin |
| url | string | null | Link that opens the post | Douyin |
| type | string | null | Content format | Douyin |
| title | string | null | Title | Douyin |
| text | string | null | Body text | Douyin |
| lang | string | null | Language of the text (standard view and up) | Douyin |
| published_at | string | null | When it was published | Douyin |
| author | object | null | Author | Douyin |
| author.id | string | null | Author's account ID | Douyin |
| author.username | string | null | Author's handle | Douyin |
| author.name | string | null | Author's display name | Douyin |
| author.avatar_url | string | null | Author's avatar (standard view and up) | Douyin |
| author.verified | boolean | null | Whether the author is verified (standard view and up) | Douyin |
| author.followers | integer | null | Author's follower count (standard view and up) | Douyin |
| metrics | object | null | Engagement counts | Douyin |
| metrics.likes | integer | null | Likes | Douyin |
| metrics.comments | integer | null | Comments | Douyin |
| metrics.shares | integer | null | Shares | Douyin |
| metrics.favorites | integer | null | Saves | Douyin |
| metrics.views | integer | null | Views | Douyin |
| metrics.reposts | integer | null | Reposts | Douyin |
| images | array | null | Image addresses (standard view and up) | Douyin |
| hashtags | array | null | Hashtags, without the # (standard view and up) | Douyin |
| mentions | array | null | Accounts mentioned in the text (standard view and up) | Douyin |
| mentions[].id | string | null | Account ID (standard view and up) | Douyin |
| mentions[].username | string | null | Handle (standard view and up) | Douyin |
| mentions[].name | string | null | Display name (standard view and up) | Douyin |
| is_pinned | boolean | null | Whether the author pinned it (standard view and up) | Douyin |
| post_id | string | null | ID of the thread's root post when this is a reply; otherwise null | Douyin |
| parent_id | string | null | ID of the item it replies to directly; otherwise null | Douyin |
| root_id | string | null | ID of the first-level reply its thread hangs under | Douyin |
| approximate | array | null | Which numbers of this item are approximate or lower bounds; absent when all are exact | Douyin |
| approximate[].field | string | null | Path of the field, such as metrics.views | Douyin |
| approximate[].kind | string | null | Approximate, or a lower bound | Douyin |
| ext | object | The platform's own fields (full view). | Douyin |
| ext.duration | number | null | Length of the video, in seconds (full view) | Douyin |
| ext.cover_url | string | null | Address of the cover image (full view) | Douyin |
| ext.category | string | null | The section the video is filed under, in the platform's words (数码, 美食制作, say) (full view) | Douyin |
| ext.new_followers | integer | null | Followers the post gained its author (full view) | Douyin |
| ext.like_rate | number | null | Like rate: likes over views, 0 to 1 (full view) | Douyin |
| ext.follow_rate | number | null | Follow rate: new followers over views, 0 to 1 (full view) | Douyin |
| ext.index | integer | null | The index 巨量算数 gives the video: a score, not a count of plays (full view) | Douyin |
| ext.video_url | string | null | Address the video plays from: a signed address of the platform's that expires, so use it soon; an image post has none (full view) | Douyin |
| ext.finish_rate | number | null | Completion rate: the share of plays watched to the end, 0 to 1 (Xingtu's figure) (full view) | Douyin |
| ext.interaction_rate | number | null | Interaction rate: interactions over plays, 0 to 1 (Xingtu's figure) (full view) | Douyin |
| ext.categories | array | null | What the platform files the post under, from the first level to the third, in its words (such as 美食 › 美食教程 › 饮品教程, food › food tutorials › drink tutorials); null where it filed it under none (full view) | Douyin |
| ext.author_xingtu_id | string | null | The author's Xingtu creator ID, as the other Xingtu endpoints take it (Xingtu's figure) (full view) | Douyin |
| ext.author_uid | string | null | The numeric ID (uid) of the author's Douyin account, what the trend-index creator endpoints take (Xingtu's figure) (full view) | Douyin |
Clear inputs. Inspectable output.
Each click runs a local fixture. Advanced JSON inputs are checked against the selected method. Editing does not execute a request.
Copying does not execute. CLI quote is read-only and needs a local customer TEST key. Configure MCP in demo mode first. GET and POST batches both return only fictional local fixtures.
Download contract example (no execution) ↗For TEST budgets, Key scopes or failure scenarios, open the account console. Customer sandbox ↗