Douyin Video Search with Trend and Fan-Rise Flags

omnial/douyin-index-fetch-item-query

Given a search keyword, returns a page of matching Douyin (Chinese short-video platform) clips: each result's title, video id, like and fan counts, publish time, duration, and the poster's public display name, plus Douyin's own engagement flags (low-fans-but-hot, high like rate, high play rate, high fan-rise rate). A keyword matching nothing returns an empty list 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

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.

Install it Create an account

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-index-fetch-item-query" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/douyin-index-fetch-item-query" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/douyin-index-fetch-item-query", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/douyin-index-fetch-item-query", 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.

Charge	Price
Per call	$0.00205

Updated: Oct 27, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search keyword"
    },
    "date_type": {
      "type": "integer",
      "default": 0,
      "description": "发布时间类型（可通过 fetch_item_filter_options 获取）/Date type (get from fetch_item_filter_options), 0=不限/unlimited"
    },
    "label_type": {
      "type": "integer",
      "default": 0,
      "description": "视频类型（可通过 fetch_item_filter_options 获取）/Label type (get from fetch_item_filter_options), 0=不限/unlimited"
    },
    "category_id": {
      "type": "string",
      "default": "0",
      "description": "垂类ID（可通过 fetch_item_filter_options 获取）/Category ID (get from fetch_item_filter_options), 0=全部/all"
    },
    "duration_type": {
      "type": "integer",
      "default": 0,
      "description": "时长类型（可通过 fetch_item_filter_options 获取）/Duration type (get from fetch_item_filter_options), 0=不限/unlimited"
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": [
              "string",
              "null"
            ],
            "description": "The video's page URL. Value withheld (stripped to null) in this tool's output -- only whether a URL is present is a given, not the link itself."
          },
          "fans": {
            "type": "number",
            "description": "The posting account's follower count."
          },
          "likes": {
            "type": "string",
            "description": "Like count, as a numeric string (e.g. \"590486\")."
          },
          "title": {
            "type": "string",
            "description": "The video's full title."
          },
          "itemId": {
            "type": "string",
            "description": "The video's numeric id, as a string."
          },
          "duration": {
            "type": "number",
            "description": "Video length in seconds."
          },
          "nickname": {
            "type": "string",
            "description": "The posting account's public display name."
          },
          "avatarUrl": {
            "type": [
              "string",
              "null"
            ],
            "description": "The poster's avatar image URL. Value withheld (stripped to null) in this tool's output -- only whether an avatar is present is a given, not the image."
          },
          "thumbnail": {
            "type": [
              "string",
              "null"
            ],
            "description": "The video's thumbnail image URL. Value withheld (stripped to null) in this tool's output -- only whether a thumbnail is present is a given, not the image."
          },
          "createTime": {
            "type": "string",
            "description": "Publish time, e.g. \"2026-09-20 09:46:27\"."
          },
          "isHighLikeRate": {
            "type": "number",
            "description": "1 when the platform flags a high like rate; 0 otherwise."
          },
          "isLowFansButHot": {
            "type": "number",
            "description": "1 when the platform flags this video low-fans-but-hot; 0 otherwise."
          },
          "isHighFansRiseRate": {
            "type": "number",
            "description": "1 when the platform flags a high fan-growth rate; 0 otherwise."
          },
          "isHighPlayOverRate": {
            "type": "number",
            "description": "1 when the platform flags a high play-through rate; 0 otherwise."
          }
        },
        "additionalProperties": true
      },
      "description": "One entry per matching video. Empty array `[]` when the keyword matches nothing (e.g. a gibberish keyword)."
    }
  },
  "description": "The search result page: `{ data: [...] }`. Confirmed against two real calls -- a keyword search for 美食/food that returned a populated `data` array, and a gibberish keyword that returned `data: []` (no videos matched -- an empty list, not an error).",
  "additionalProperties": true
}