Douyin Video Stats Lookup (by Video ID, up to 20 at once)

{
  "type": "object",
  "required": [
    "item_ids"
  ],
  "properties": {
    "item_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "视频(item) ID列表，一次最多20个/Video (item) ID list, up to 20 per call"
    },
    "need_cover_url": {
      "type": "boolean",
      "default": true,
      "description": "是否返回封面URL/Whether to return cover URL"
    },
    "platform_source": {
      "type": "integer",
      "default": 1,
      "description": "平台来源/Platform source"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "base_resp"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "video_id",
          "author_id",
          "title",
          "duration",
          "create_time",
          "status",
          "stats"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The video id, matching one of the requested item_ids."
          },
          "stats": {
            "type": "object",
            "required": [
              "watch_cnt",
              "like_cnt",
              "comment_cnt",
              "share_cnt",
              "favorite_cnt",
              "avg_watch_dura",
              "interact_rate"
            ],
            "properties": {
              "like_cnt": {
                "type": "string"
              },
              "share_cnt": {
                "type": "string"
              },
              "watch_cnt": {
                "type": "string",
                "description": "View count, as a numeric string."
              },
              "comment_cnt": {
                "type": "string"
              },
              "favorite_cnt": {
                "type": "string"
              },
              "interact_rate": {
                "type": "number",
                "description": "Fraction, e.g. 0.0206 for 2.06%, not a 0-100 percentage."
              },
              "avg_watch_dura": {
                "type": "string",
                "description": "Observed as the literal string \"0\" on the one real fixture captured -- the shape of a genuinely populated value is unconfirmed."
              }
            },
            "additionalProperties": true
          },
          "title": {
            "type": "string"
          },
          "status": {
            "type": "number",
            "description": "Vendor status code for this item; 102 observed on the one real, found video -- the meaning of other values is unconfirmed."
          },
          "duration": {
            "type": "number",
            "description": "Seconds."
          },
          "video_id": {
            "type": "string",
            "description": "A second, internal video identifier distinct from `id`."
          },
          "author_id": {
            "type": "string",
            "description": "The numeric id of the account that posted the video."
          },
          "topic_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Hashtag/topic ids attached to the video."
          },
          "create_time": {
            "type": "string",
            "description": "Unix timestamp (seconds), as a numeric string, of when the video was posted."
          }
        },
        "additionalProperties": true
      },
      "description": "One entry per requested item_id that resolved to real stats. ABSENT ENTIRELY (not an empty array) when none of the requested item_ids resolved -- confirmed against the invalid-item-id fixture, whose shaped output is `{base_resp}` with no `items` key at all."
    },
    "base_resp": {
      "type": "object",
      "required": [
        "status_code",
        "status_message"
      ],
      "properties": {
        "status_code": {
          "type": "number",
          "description": "0 on both real calls observed (one found video, one nonexistent id) -- this field does not distinguish a found item_id from a not-found one; check whether `items` is present instead."
        },
        "status_message": {
          "type": "string",
          "description": "Empty string on both real calls observed."
        }
      },
      "description": "Present on every real call observed, found or not-found alike.",
      "additionalProperties": true
    }
  },
  "description": "The stats-lookup response, narrowed to the fields this tool ships.",
  "additionalProperties": true
}