Contract
input_schema.json
{
"type": "object",
"required": [
"aid"
],
"properties": {
"aid": {
"type": "string",
"examples": [
"114902186396822"
],
"description": "Video id"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"code": {
"type": "number",
"description": "The upstream call's own status code; 0 on success."
},
"data": {
"type": "object",
"properties": {
"Card": {
"type": "object",
"properties": {
"card": {
"type": "object",
"properties": {
"mid": {
"type": "string"
},
"sex": {
"type": "string",
"description": "The uploader's self-reported gender label on their public profile, e.g. '男'."
},
"vip": {
"type": "object",
"properties": {
"type": {
"type": "number",
"description": "0 = none, otherwise a paid-membership tier."
},
"status": {
"type": "number",
"description": "1 = active."
}
},
"additionalProperties": true
},
"face": {
"type": [
"string",
"null"
],
"description": "The uploader's avatar, withheld the same way as `View.owner.face`."
},
"fans": {
"type": "number",
"description": "Follower count."
},
"name": {
"type": "string",
"description": "The uploader's public display name."
},
"sign": {
"type": "string",
"description": "The uploader's public bio/signature text."
},
"friend": {
"type": "number",
"description": "Following count."
},
"attention": {
"type": "number",
"description": "Following count (duplicate of `friend`)."
},
"level_info": {
"type": "object",
"properties": {
"current_level": {
"type": "number"
}
},
"additionalProperties": true
},
"official_verify": {
"type": "object",
"properties": {
"desc": {
"type": "string",
"description": "e.g. 'bilibili 知名军事UP主'."
},
"type": {
"type": "number",
"description": "-1 = not verified."
}
},
"description": "Bilibili's own official-account verification badge, when granted.",
"additionalProperties": true
}
},
"additionalProperties": true
},
"follower": {
"type": "number"
},
"like_num": {
"type": "number",
"description": "Total likes across this uploader's channel."
},
"following": {
"type": "boolean",
"description": "Whether the requesting viewer follows this uploader."
},
"archive_count": {
"type": "number",
"description": "Total videos this uploader has published."
}
},
"description": "The uploader's own public profile card.",
"additionalProperties": true
},
"Tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tag_id": {
"type": "number"
},
"tag_name": {
"type": "string"
},
"tag_type": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Topic tags attached to this video."
},
"View": {
"type": "object",
"properties": {
"aid": {
"type": "number"
},
"cid": {
"type": "number",
"description": "Internal id for the video's default playable stream."
},
"pic": {
"type": [
"string",
"null"
],
"description": "The video's thumbnail image. Value withheld (returned `null` regardless of what the upstream response held) -- only whether a thumbnail exists is observable here, not the image itself."
},
"bvid": {
"type": "string",
"description": "The video's alternate string-form id."
},
"stat": {
"type": "object",
"properties": {
"coin": {
"type": "number",
"description": "Count of Bilibili 'coins' given to this video."
},
"like": {
"type": "number"
},
"view": {
"type": "number"
},
"reply": {
"type": "number",
"description": "Comment count."
},
"share": {
"type": "number"
},
"danmaku": {
"type": "number",
"description": "Count of scrolling on-screen comments."
},
"dislike": {
"type": "number"
},
"favorite": {
"type": "number"
}
},
"additionalProperties": true
},
"ctime": {
"type": "number",
"description": "Unix seconds, upload/submission time."
},
"owner": {
"type": "object",
"properties": {
"mid": {
"type": "number",
"description": "The uploader's numeric account id."
},
"face": {
"type": [
"string",
"null"
],
"description": "The uploader's avatar image, withheld the same way as `pic`."
},
"name": {
"type": "string",
"description": "The uploader's public username."
}
},
"description": "The uploader.",
"additionalProperties": true
},
"pages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cid": {
"type": "number"
},
"vid": {
"type": "string"
},
"page": {
"type": "number"
},
"part": {
"type": "string",
"description": "This page's own title."
},
"ctime": {
"type": "number"
},
"weblink": {
"type": "string"
},
"duration": {
"type": "number"
},
"dimension": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"rotate": {
"type": "number"
}
},
"additionalProperties": true
},
"first_frame": {
"type": [
"string",
"null"
],
"description": "This page's own thumbnail, withheld the same way as `pic`."
}
},
"additionalProperties": true
},
"description": "One entry per part/page of a multi-part upload."
},
"title": {
"type": "string"
},
"tname": {
"type": "string",
"description": "The video's category name."
},
"rights": {
"type": "object",
"properties": {
"hd5": {
"type": "number",
"description": "1 if an HD stream is available."
},
"pay": {
"type": "number",
"description": "1 if this video requires payment to view."
},
"movie": {
"type": "number"
},
"ugc_pay": {
"type": "number"
},
"autoplay": {
"type": "number"
},
"download": {
"type": "number",
"description": "1 if downloadable, 0 otherwise."
},
"no_reprint": {
"type": "number",
"description": "1 if reposting elsewhere is disallowed."
}
},
"description": "Permission flags for this video, e.g. whether it can be downloaded.",
"additionalProperties": true
},
"videos": {
"type": "number",
"description": "Number of parts/pages this video has."
},
"dynamic": {
"type": "string",
"description": "A short caption the uploader attached alongside the video; often empty."
},
"pubdate": {
"type": "number",
"description": "Unix seconds, first-published time."
},
"duration": {
"type": "number",
"description": "Seconds."
},
"subtitle": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"allow_submit": {
"type": "boolean"
}
},
"additionalProperties": true
},
"tname_v2": {
"type": "string",
"description": "A newer-scheme category name; may match `tname` or differ."
},
"copyright": {
"type": "number",
"description": "1 = the uploader's own original work, 2 = reprinted/reposted."
},
"dimension": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"rotate": {
"type": "number"
}
},
"additionalProperties": true
},
"argue_info": {
"type": "object",
"properties": {
"argue_msg": {
"type": "string"
},
"argue_link": {
"type": "string"
},
"argue_type": {
"type": "number"
}
},
"description": "A community-controversy notice, when the platform has attached one to this video. All three fields observed empty on the one real video calibrated.",
"additionalProperties": true
},
"ugc_season": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"mid": {
"type": "number",
"description": "The series owner's account id."
},
"stat": {
"type": "object",
"properties": {
"fav": {
"type": "number"
},
"coin": {
"type": "number"
},
"like": {
"type": "number"
},
"view": {
"type": "number"
},
"reply": {
"type": "number"
},
"share": {
"type": "number"
},
"danmaku": {
"type": "number"
}
},
"additionalProperties": true
},
"cover": {
"type": [
"string",
"null"
],
"description": "The series' cover image, withheld the same way as `pic`."
},
"intro": {
"type": "string"
},
"title": {
"type": "string",
"description": "The series' own title."
},
"ep_count": {
"type": "number"
},
"sections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"title": {
"type": "string"
},
"episodes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"aid": {
"type": "number"
},
"cid": {
"type": "number"
},
"bvid": {
"type": "string"
},
"title": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "One entry per episode in this section. Deliberately narrow -- see verification.notes on why per-episode owner/rights/stat detail is left out."
}
},
"additionalProperties": true
}
},
"is_pay_season": {
"type": "boolean"
}
},
"description": "Observed populated on the one real video calibrated (a video that is itself part of a 168-episode series). Whether this field is absent/differently-shaped for a standalone video not part of any series is unconfirmed -- only one real video, itself part of a series, was calibrated.",
"additionalProperties": true
}
},
"description": "The video's own record.",
"additionalProperties": true
},
"Related": {
"type": "array",
"items": {
"type": "object",
"properties": {
"aid": {
"type": "number"
},
"pic": {
"type": [
"string",
"null"
],
"description": "Thumbnail, withheld the same way as `View.pic`."
},
"bvid": {
"type": "string"
},
"stat": {
"type": "object",
"properties": {
"coin": {
"type": "number"
},
"like": {
"type": "number"
},
"view": {
"type": "number"
},
"reply": {
"type": "number"
},
"share": {
"type": "number"
},
"danmaku": {
"type": "number"
},
"favorite": {
"type": "number"
}
},
"additionalProperties": true
},
"owner": {
"type": "object",
"properties": {
"mid": {
"type": "number"
},
"face": {
"type": [
"string",
"null"
],
"description": "Withheld the same way as `View.owner.face`."
},
"name": {
"type": "string"
}
},
"additionalProperties": true
},
"title": {
"type": "string"
},
"tname": {
"type": "string"
},
"is_ogv": {
"type": "boolean",
"description": "True when this related video is licensed/official (OGV) content."
},
"videos": {
"type": "number"
},
"cover43": {
"type": [
"string",
"null"
],
"description": "A 4:3 crop of the thumbnail, withheld the same way as `View.pic`."
},
"pubdate": {
"type": "number"
},
"tnamev2": {
"type": "string"
},
"duration": {
"type": "number"
},
"copyright": {
"type": "number",
"description": "Same 1/2 meaning as `View.copyright`."
},
"dimension": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"rotate": {
"type": "number"
}
},
"additionalProperties": true
},
"first_frame": {
"type": [
"string",
"null"
],
"description": "Withheld the same way as `View.pic`."
},
"pid_name_v2": {
"type": "string",
"description": "A broader partition/category name."
},
"rcmd_reason": {
"type": "string",
"description": "Why this video was recommended, when the platform states one; often empty."
},
"season_type": {
"type": "number"
},
"pub_location": {
"type": "string",
"description": "The public region label Bilibili shows next to this video (e.g. '广东'), when set."
},
"short_link_v2": {
"type": [
"string",
"null"
],
"description": "A shareable short link for this video, withheld the same way as `View.pic`."
}
},
"additionalProperties": true
},
"description": "Other videos Bilibili recommends alongside this one."
}
},
"additionalProperties": true
},
"message": {
"type": "string",
"description": "e.g. 'OK'."
}
},
"description": "The video record, as returned at routing.responseResultPath ($.output). Observed as an empty object `{}` when the given `aid` does not resolve to an existing video.",
"additionalProperties": true
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.0020475 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Sep 15, 2026