Contract
input_schema.json
{
"type": "object",
"anyOf": [
{
"required": [
"av_id"
]
},
{
"required": [
"bv_id"
]
}
],
"properties": {
"av_id": {
"type": "string",
"examples": [
"115568241811221"
],
"description": "AV ID"
},
"bv_id": {
"type": "string",
"examples": [
"BV18SCrBGE9E"
],
"description": "BV ID"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"aid": {
"type": "number",
"description": "The video's numeric AV id."
},
"cid": {
"type": "number",
"description": "The default page's content id."
},
"pic": {
"type": [
"string",
"null"
],
"description": "The video's cover image URL. Value withheld (stripped to `null`) in this tool's output -- only whether a cover exists is a given, not the image itself."
},
"tid": {
"type": "number",
"description": "Category id."
},
"bvid": {
"type": "string",
"description": "The video's BV id."
},
"desc": {
"type": "string"
},
"stat": {
"type": "object",
"properties": {
"vt": {
"type": "number"
},
"vv": {
"type": "number"
},
"coin": {
"type": "number"
},
"like": {
"type": "number"
},
"view": {
"type": "number"
},
"fav_g": {
"type": "number"
},
"reply": {
"type": "number"
},
"share": {
"type": "number"
},
"like_g": {
"type": "number"
},
"danmaku": {
"type": "number"
},
"dislike": {
"type": "number"
},
"favorite": {
"type": "number"
},
"his_rank": {
"type": "number"
},
"now_rank": {
"type": "number"
}
},
"description": "Engagement counters for this video.",
"additionalProperties": true
},
"ctime": {
"type": "number",
"description": "Unix seconds."
},
"owner": {
"type": "object",
"properties": {
"mid": {
"type": "number",
"description": "The uploader's numeric Bilibili member id."
},
"face": {
"type": [
"string",
"null"
],
"description": "The uploader's public avatar image URL. Value withheld (stripped to `null`) in this tool's output."
},
"name": {
"type": "string",
"description": "The uploader's public display name."
}
},
"description": "The video's uploader -- the account that published this exact video.",
"additionalProperties": true
},
"pages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cid": {
"type": "number"
},
"vid": {
"type": "string"
},
"from": {
"type": "string"
},
"page": {
"type": "number"
},
"part": {
"type": "string"
},
"ctime": {
"type": "number"
},
"metas": {
"type": "array",
"items": {
"type": "object",
"properties": {
"size": {
"type": "number",
"description": "Bytes."
},
"format": {
"type": "string",
"description": "Empty string on both videos observed."
},
"quality": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "Available quality tiers for this page."
},
"dmlink": {
"type": [
"string",
"null"
],
"description": "A danmaku XML endpoint URL. Value withheld (stripped to `null`) in this tool's output."
},
"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": "First-frame thumbnail URL. Value withheld (stripped to `null`) in this tool's output."
},
"download_title": {
"type": "string"
},
"download_subtitle": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "One entry per video part/page."
},
"state": {
"type": "number",
"description": "Video state code, e.g. 0 for a normal video."
},
"tidv2": {
"type": "number",
"description": "Category id, v2 taxonomy."
},
"title": {
"type": "string"
},
"tname": {
"type": "string",
"description": "Category name."
},
"pid_v2": {
"type": "number",
"description": "Parent category id, v2 taxonomy."
},
"rights": {
"type": "object",
"properties": {
"bp": {
"type": "number"
},
"hd5": {
"type": "number"
},
"pay": {
"type": "number"
},
"elec": {
"type": "number"
},
"movie": {
"type": "number"
},
"arc_pay": {
"type": "number"
},
"ugc_pay": {
"type": "number"
},
"autoplay": {
"type": "number"
},
"download": {
"type": "number"
},
"no_reprint": {
"type": "number"
},
"no_background": {
"type": "number"
},
"is_cooperation": {
"type": "number"
},
"pay_free_watch": {
"type": "number"
},
"ugc_pay_preview": {
"type": "number"
}
},
"description": "Boolean-as-number permission flags the platform set for this video.",
"additionalProperties": true
},
"videos": {
"type": "number",
"description": "Number of video parts/pages."
},
"cover43": {
"type": [
"string",
"null"
],
"description": "A 4:3-cropped cover image URL. Value withheld (stripped to `null`) in this tool's output."
},
"dynamic": {
"type": "string",
"description": "Attached feed text. Empty string on the one real video observed."
},
"pubdate": {
"type": "number",
"description": "Unix seconds."
},
"tnamev2": {
"type": "string",
"description": "Category name, v2 taxonomy."
},
"desc_tag": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uri": {
"type": [
"string",
"null"
],
"description": "An in-app deep link to search this tag. Value withheld (stripped to `null`) in this tool's output."
},
"cover": {
"type": "string",
"description": "Empty string on both videos observed."
},
"hated": {
"type": "number"
},
"hates": {
"type": "number"
},
"liked": {
"type": "number"
},
"likes": {
"type": "number"
},
"tag_id": {
"type": "number"
},
"tag_name": {
"type": "string"
},
"tag_type": {
"type": "string"
},
"attribute": {
"type": "number"
},
"is_activity": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "Topic/keyword tags attached to the video."
},
"duration": {
"type": "number",
"description": "Seconds."
},
"copyright": {
"type": "number",
"description": "1 or 2 on the one real video observed."
},
"dimension": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"rotate": {
"type": "number"
}
},
"additionalProperties": true
},
"owner_ext": {
"type": "object",
"properties": {
"vip": {
"type": "object",
"properties": {
"label": {
"type": "object",
"properties": {
"path": {
"type": [
"string",
"null"
],
"description": "Badge image URL. Value withheld (stripped to `null`) in this tool's output."
},
"text": {
"type": "string"
},
"bg_color": {
"type": "string"
},
"bg_style": {
"type": "number"
},
"label_id": {
"type": "number"
},
"label_goto": {
"type": "object",
"properties": {
"mobile": {
"type": [
"string",
"null"
],
"description": "Membership purchase link. Value withheld (stripped to `null`) in this tool's output."
},
"pc_web": {
"type": [
"string",
"null"
],
"description": "Membership purchase link. Value withheld (stripped to `null`) in this tool's output."
}
},
"additionalProperties": true
},
"label_type": {
"type": "number"
},
"text_color": {
"type": "string"
},
"label_theme": {
"type": "string"
},
"border_color": {
"type": "string"
},
"use_img_label": {
"type": "boolean"
},
"img_label_uri_hans": {
"type": "string"
},
"img_label_uri_hant": {
"type": "string"
},
"img_label_uri_i18n": {
"type": "string"
},
"img_label_uri_hans_static": {
"type": [
"string",
"null"
],
"description": "Badge image URL. Value withheld (stripped to `null`) in this tool's output."
},
"img_label_uri_hant_static": {
"type": [
"string",
"null"
],
"description": "Badge image URL. Value withheld (stripped to `null`) in this tool's output."
},
"img_label_uri_i18n_static": {
"type": "string"
}
},
"description": "The membership badge's display styling.",
"additionalProperties": true
},
"vipType": {
"type": "number"
},
"dueRemark": {
"type": "string"
},
"themeType": {
"type": "number"
},
"vipStatus": {
"type": "number"
},
"vipDueDate": {
"type": "number",
"description": "Unix milliseconds."
},
"accessStatus": {
"type": "number"
},
"vipStatusWarn": {
"type": "string"
}
},
"description": "The uploader's membership (paid subscription tier) status.",
"additionalProperties": true
},
"fans": {
"type": "number",
"description": "The uploader's follower count."
},
"arc_count": {
"type": "string",
"description": "The uploader's total video count as a locale string, e.g. \"2097视频\"."
},
"official_verify": {
"type": "object",
"properties": {
"desc": {
"type": "string"
},
"type": {
"type": "number"
}
},
"additionalProperties": true
}
},
"description": "Extended, public information about the video's own uploader.",
"additionalProperties": true
},
"short_link": {
"type": [
"string",
"null"
],
"description": "Short link URL. Value withheld (stripped to `null`) in this tool's output."
},
"vt_display": {
"type": "string",
"description": "A human-readable, locale-formatted view-count string, e.g. \"228.2万\"."
},
"first_frame": {
"type": [
"string",
"null"
],
"description": "First-frame thumbnail URL. Value withheld (stripped to `null`) in this tool's output."
},
"pid_name_v2": {
"type": "string",
"description": "Parent category name, v2 taxonomy."
},
"pub_location": {
"type": "string",
"description": "The uploader's declared publish location (a city name)."
},
"short_link_v2": {
"type": [
"string",
"null"
],
"description": "Short link URL, v2 form. Value withheld (stripped to `null`) in this tool's output."
}
},
"additionalProperties": true
}
},
"description": "The video record, as returned at routing.responseResultPath ($.output), rooted under `data`. Both calibration fixtures were a real, existing video (looked up two different ways) -- a not-found/invalid-id shape was never observed and is UNCONFIRMED.",
"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 23, 2026