Skip to content
Eden Engine

Recommended Videos for a Douyin Xingtu KOL (by Account ID)

omnial/douyin-xingtu-kol-rec-videos

Given a Douyin Xingtu KOL's numeric account ID, returns the recommended-video lists for that KOL -- signature/masterpiece picks, newest uploads, and order-hot trending picks -- each video with its video ID, publish time, and play count. A KOL with no recommended videos on record returns an empty result rather than an error.

activeper callv2

Price

Up to $0.041 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

Douyin

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-xingtu-kol-rec-videos" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/douyin-xingtu-kol-rec-videos" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/douyin-xingtu-kol-rec-videos", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/douyin-xingtu-kol-rec-videos", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not 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.

ChargePrice
Per call
$0.041
Updated
Nov 6, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "kolId"
  ],
  "properties": {
    "kolId": {
      "type": "string",
      "examples": [
        "7048929565493690398"
      ],
      "description": "User kolId"
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "properties": {
    "base_resp": {
      "type": "object",
      "properties": {
        "status_code": {
          "type": "number",
          "description": "0 observed; nonzero meaning unconfirmed."
        },
        "status_message": {
          "type": "string",
          "description": "Empty string observed on success; error text would land here."
        }
      },
      "description": "The call's own response envelope. Observed as `{ status_code: 0, status_message: \"\" }` on the one real non-empty capture.",
      "additionalProperties": true
    },
    "newest_videos": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Video page URL. Empty string on all six captured rows."
          },
          "like": {
            "type": "number",
            "description": "Like count; 0 on all six captured rows."
          },
          "play": {
            "type": "number",
            "description": "View/play count. The only non-zero engagement counter on the captured rows (observed 1,459 to 898,536)."
          },
          "repin": {
            "type": "number",
            "description": "Repost count; 0 on all six captured rows."
          },
          "share": {
            "type": "number",
            "description": "Share count; 0 on all six captured rows."
          },
          "width": {
            "type": "string",
            "description": "Video width returned as a numeric string; \"0\" on all captured rows."
          },
          "height": {
            "type": "string",
            "description": "Video height returned as a numeric string; \"0\" on all captured rows."
          },
          "is_hot": {
            "type": "boolean",
            "description": "Whether the video is flagged hot; false on all six captured rows."
          },
          "status": {
            "type": "number",
            "description": "Video status code; 0 on all six captured rows."
          },
          "barrage": {
            "type": "number",
            "description": "Danmaku (on-video comment) count; 0 on all six captured rows."
          },
          "comment": {
            "type": "number",
            "description": "Comment count; 0 on all six captured rows."
          },
          "item_id": {
            "type": "string",
            "description": "The video's canonical Douyin id -- a 19-digit numeric string (a video id, not a phone number despite the digit shape)."
          },
          "duration": {
            "type": "number",
            "description": "Video length in seconds; 0 on all six captured rows."
          },
          "favorite": {
            "type": "string",
            "description": "Favorite count returned as a numeric string; \"0\" on all captured rows."
          },
          "read_cnt": {
            "type": "string",
            "description": "Read count returned as a numeric string; \"0\" on all captured rows."
          },
          "item_title": {
            "type": "string",
            "description": "Empty string on all six captured rows."
          },
          "media_type": {
            "type": "string",
            "description": "Media type code returned as a numeric string; \"0\" on all captured rows."
          },
          "create_time": {
            "type": "number",
            "description": "Publish time in Unix seconds; populated on all six captured rows."
          },
          "interact_rate": {
            "type": "number",
            "description": "Engagement rate; 0 on all six captured rows."
          },
          "play_over_5min": {
            "type": "number",
            "description": "Plays for videos over five minutes; 0 on all six captured rows."
          }
        },
        "additionalProperties": true
      },
      "description": "The KOL's newest uploads. Two entries on the one real capture; row count varies by KOL."
    },
    "order_hot_videos": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Video page URL. Empty string on all six captured rows."
          },
          "like": {
            "type": "number",
            "description": "Like count; 0 on all six captured rows."
          },
          "play": {
            "type": "number",
            "description": "View/play count. The only non-zero engagement counter on the captured rows (observed 1,459 to 898,536)."
          },
          "repin": {
            "type": "number",
            "description": "Repost count; 0 on all six captured rows."
          },
          "share": {
            "type": "number",
            "description": "Share count; 0 on all six captured rows."
          },
          "width": {
            "type": "string",
            "description": "Video width returned as a numeric string; \"0\" on all captured rows."
          },
          "height": {
            "type": "string",
            "description": "Video height returned as a numeric string; \"0\" on all captured rows."
          },
          "is_hot": {
            "type": "boolean",
            "description": "Whether the video is flagged hot; false on all six captured rows."
          },
          "status": {
            "type": "number",
            "description": "Video status code; 0 on all six captured rows."
          },
          "barrage": {
            "type": "number",
            "description": "Danmaku (on-video comment) count; 0 on all six captured rows."
          },
          "comment": {
            "type": "number",
            "description": "Comment count; 0 on all six captured rows."
          },
          "item_id": {
            "type": "string",
            "description": "The video's canonical Douyin id -- a 19-digit numeric string (a video id, not a phone number despite the digit shape)."
          },
          "duration": {
            "type": "number",
            "description": "Video length in seconds; 0 on all six captured rows."
          },
          "favorite": {
            "type": "string",
            "description": "Favorite count returned as a numeric string; \"0\" on all captured rows."
          },
          "read_cnt": {
            "type": "string",
            "description": "Read count returned as a numeric string; \"0\" on all captured rows."
          },
          "item_title": {
            "type": "string",
            "description": "Empty string on all six captured rows."
          },
          "media_type": {
            "type": "string",
            "description": "Media type code returned as a numeric string; \"0\" on all captured rows."
          },
          "create_time": {
            "type": "number",
            "description": "Publish time in Unix seconds; populated on all six captured rows."
          },
          "interact_rate": {
            "type": "number",
            "description": "Engagement rate; 0 on all six captured rows."
          },
          "play_over_5min": {
            "type": "number",
            "description": "Plays for videos over five minutes; 0 on all six captured rows."
          }
        },
        "additionalProperties": true
      },
      "description": "Ordered hot/trending video picks for the KOL. Two entries on the one real capture; row count varies by KOL."
    },
    "masterpiece_videos": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Video page URL. Empty string on all six captured rows."
          },
          "like": {
            "type": "number",
            "description": "Like count; 0 on all six captured rows."
          },
          "play": {
            "type": "number",
            "description": "View/play count. The only non-zero engagement counter on the captured rows (observed 1,459 to 898,536)."
          },
          "repin": {
            "type": "number",
            "description": "Repost count; 0 on all six captured rows."
          },
          "share": {
            "type": "number",
            "description": "Share count; 0 on all six captured rows."
          },
          "width": {
            "type": "string",
            "description": "Video width returned as a numeric string; \"0\" on all captured rows."
          },
          "height": {
            "type": "string",
            "description": "Video height returned as a numeric string; \"0\" on all captured rows."
          },
          "is_hot": {
            "type": "boolean",
            "description": "Whether the video is flagged hot; false on all six captured rows."
          },
          "status": {
            "type": "number",
            "description": "Video status code; 0 on all six captured rows."
          },
          "barrage": {
            "type": "number",
            "description": "Danmaku (on-video comment) count; 0 on all six captured rows."
          },
          "comment": {
            "type": "number",
            "description": "Comment count; 0 on all six captured rows."
          },
          "item_id": {
            "type": "string",
            "description": "The video's canonical Douyin id -- a 19-digit numeric string (a video id, not a phone number despite the digit shape)."
          },
          "duration": {
            "type": "number",
            "description": "Video length in seconds; 0 on all six captured rows."
          },
          "favorite": {
            "type": "string",
            "description": "Favorite count returned as a numeric string; \"0\" on all captured rows."
          },
          "read_cnt": {
            "type": "string",
            "description": "Read count returned as a numeric string; \"0\" on all captured rows."
          },
          "item_title": {
            "type": "string",
            "description": "Empty string on all six captured rows."
          },
          "media_type": {
            "type": "string",
            "description": "Media type code returned as a numeric string; \"0\" on all captured rows."
          },
          "create_time": {
            "type": "number",
            "description": "Publish time in Unix seconds; populated on all six captured rows."
          },
          "interact_rate": {
            "type": "number",
            "description": "Engagement rate; 0 on all six captured rows."
          },
          "play_over_5min": {
            "type": "number",
            "description": "Plays for videos over five minutes; 0 on all six captured rows."
          }
        },
        "additionalProperties": true
      },
      "description": "Signature/masterpiece video picks for the KOL. Two entries on the one real capture; row count varies by KOL."
    },
    "personal_hot_videos": {
      "type": "array",
      "items": {},
      "description": "Personal hot videos. Empty array on the one real capture; a populated item shape was never observed and is unconfirmed (each item would likely mirror the other three lists' per-video shape)."
    }
  },
  "description": "The recommended-video lists. Returned as `{}` (completely empty) when the given account ID has no videos on record. No top-level `required` fields on purpose, so that empty shape validates.",
  "additionalProperties": true
}