Douyin Video Lookup (by Share Link)
omnial/douyin-web-fetch-one-video-by-share-url
Given a Douyin share link, returns that video's public metadata: caption and its hashtags, the creator's name and follower count, like/comment/share counters, the soundtrack title and whether it is an original sound, resolution and encoding details, and whether play, download, and cover addresses exist. An invalid or unknown share link returns an empty shell rather than an error.
activeper callv4
Price
Up to $0.00205 per call; you pay what the call used
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.
Data source
Data from Douyin.
Use it
Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.
Connect once and your AI can find and run this tool, and any other it needs.
For developers: the calls your assistant makes
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/douyin-web-fetch-one-video-by-share-url" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/douyin-web-fetch-one-video-by-share-url" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/douyin-web-fetch-one-video-by-share-url", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/douyin-web-fetch-one-video-by-share-url", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.00205 |
- Updated
- Oct 27, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"required": [
"share_url"
],
"properties": {
"share_url": {
"type": "string",
"examples": [
"https://v.douyin.com/e3x2fjE/"
],
"description": "Share link"
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"properties": {
"aweme_detail": {
"type": "object",
"properties": {
"desc": {
"type": "string",
"description": "The video's caption text, hashtags inline."
},
"rate": {
"type": "number",
"description": "Playback quality/rate code."
},
"music": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "The soundtrack's public title."
},
"duration": {
"type": "number",
"description": "Soundtrack length in seconds (16 in testing)."
},
"is_original": {
"type": "boolean"
},
"is_original_sound": {
"type": "boolean"
}
},
"description": "The soundtrack this video uses. Its creator's handle is not included.",
"additionalProperties": true
},
"video": {
"type": "object",
"properties": {
"cover": {
"type": "object",
"properties": {
"url_list": {
"type": [
"array",
"null"
],
"description": "Cover image URLs. Value withheld (stripped to `null`) -- only that a cover exists is observable."
}
},
"additionalProperties": true
},
"ratio": {
"type": "string",
"description": "Aspect label, e.g. '720p' in testing."
},
"width": {
"type": "number"
},
"format": {
"type": "string",
"description": "Container, e.g. 'mp4' in testing."
},
"height": {
"type": "number"
},
"bit_rate": {
"type": "array",
"items": {
"type": "object",
"properties": {
"FPS": {
"type": "number"
},
"format": {
"type": "string"
},
"bit_rate": {
"type": "number"
},
"gear_name": {
"type": "string",
"description": "The encoding tier's label (e.g. 'normal_720_0') -- a quality tag, not a person."
},
"play_addr": {
"type": "object",
"properties": {
"url_list": {
"type": [
"array",
"null"
],
"description": "Playback URLs for this tier. Always null (URLs not returned)."
}
},
"additionalProperties": true
},
"quality_type": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "One entry per encoding quality tier; a single 720p tier in testing."
},
"duration": {
"type": "number",
"description": "Milliseconds, mirrors aweme_detail.duration."
},
"play_addr": {
"type": "object",
"properties": {
"url_list": {
"type": [
"array",
"null"
],
"description": "Direct playback URLs. Value withheld (stripped to `null`) -- only that a playable address exists is observable."
}
},
"additionalProperties": true
},
"download_addr": {
"type": "object",
"properties": {
"url_list": {
"type": [
"array",
"null"
],
"description": "Direct download URLs (watermarked in testing). Always null (URLs not returned)."
}
},
"additionalProperties": true
},
"has_watermark": {
"type": "boolean"
}
},
"description": "Encoding details for the playable video file.",
"additionalProperties": true
},
"author": {
"type": "object",
"properties": {
"uid": {
"type": "string",
"description": "The author's numeric Douyin id."
},
"sec_uid": {
"type": "string",
"description": "The author's secure account id."
},
"nickname": {
"type": "string",
"description": "The author's public display name -- the subject of this lookup."
},
"unique_id": {
"type": "string",
"description": "The author's public handle."
},
"follower_count": {
"type": "number"
}
},
"description": "The queried video's own author (the creator who published this exact video).",
"additionalProperties": true
},
"region": {
"type": "string",
"description": "Region code, e.g. 'CN' in testing."
},
"aweme_id": {
"type": "string",
"description": "The video's public Douyin id."
},
"duration": {
"type": "number",
"description": "Video length in milliseconds (18134 in testing)."
},
"share_url": {
"type": [
"string",
"null"
],
"description": "The video's canonical share URL. Value withheld (stripped to `null`) in this tool's output -- only that a share destination exists is observable, not the URL."
},
"statistics": {
"type": "object",
"properties": {
"digg_count": {
"type": "number",
"description": "Likes."
},
"play_count": {
"type": "number",
"description": "Plays."
},
"share_count": {
"type": "number",
"description": "Shares."
},
"admire_count": {
"type": "number"
},
"collect_count": {
"type": "number",
"description": "Favorites/saves."
},
"comment_count": {
"type": "number",
"description": "Comments."
},
"recommend_count": {
"type": "number"
}
},
"description": "Engagement counters for this video.",
"additionalProperties": true
},
"text_extra": {
"type": "array",
"items": {
"type": "object",
"properties": {
"hashtag_id": {
"type": "string"
},
"hashtag_name": {
"type": "string",
"description": "The hashtag topic (e.g. a game/theme tag) -- public topic, not a person's name."
}
},
"additionalProperties": true
},
"description": "Hashtag mentions parsed out of the caption."
},
"create_time": {
"type": "number",
"description": "Publish time, Unix seconds."
}
},
"description": "The queried video's own public metadata. Absent entirely on the not-found case (`{}`).",
"additionalProperties": true
}
},
"description": "The video record, limited to the fields below. Built as `{ aweme_detail: { ... } }` for a video that resolves; an invalid or unknown `share_url` returns `{}` instead (the call still completes successfully).",
"additionalProperties": true
}