Skip to content
Eden Engine

Douyin Video Search with Douplus Paid-Placement Flag

omnial/douyin-douplus-search-video

Given a keyword, searches Douyin's video catalog and returns matching videos with the creator's public profile, engagement counts (comments/likes/shares), post time, and whether the post is a paid (Douplus) placement, plus a cursor for the next page.

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.

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-douplus-search-video" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/douyin-douplus-search-video" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/douyin-douplus-search-video", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/douyin-douplus-search-video", 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.00205
Updated
Oct 27, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 12,
      "example": 12,
      "description": "每页数量/Page size"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "example": 0,
      "description": "翻页游标,首页传 0,后续传上一页响应里的 cursor/Pagination cursor, 0 for first page"
    },
    "keyword": {
      "type": "string",
      "example": "major",
      "description": "视频标题/关键词/Video title or keyword"
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "properties": {
    "msg": {
      "type": "string",
      "description": "Vendor status message, observed as the literal string 'success' on all three real captures."
    },
    "code": {
      "type": "integer",
      "description": "Vendor status code, observed as 0 on all three real captures."
    },
    "data": {
      "type": "object",
      "properties": {
        "cursor": {
          "type": "integer",
          "description": "Pass this value back as the next call's `cursor` input to fetch the following page."
        },
        "hasMore": {
          "type": "boolean",
          "description": "Whether a further page is available."
        },
        "itemList": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "IsAd": {
                "type": "boolean",
                "description": "Whether the video is a paid/boosted placement. Observed false on every item across all three real captures; a true value was never observed."
              },
              "AwemeInfo": {
                "type": "object",
                "properties": {
                  "Desc": {
                    "type": "string",
                    "description": "The video's caption text, as posted (often includes hashtags)."
                  },
                  "Video": {
                    "type": "object",
                    "properties": {
                      "Title": {
                        "type": "string",
                        "description": "Observed identical to Desc on every real item captured."
                      },
                      "PlayAddr": {
                        "type": "object",
                        "properties": {
                          "Width": {
                            "type": "integer",
                            "description": "Source video pixel width."
                          },
                          "Height": {
                            "type": "integer",
                            "description": "Source video pixel height."
                          }
                        },
                        "additionalProperties": true
                      },
                      "CreateTime": {
                        "type": "string",
                        "description": "Post time, epoch SECONDS as a string -- a different precision than AwemeInfo.CreateTime's milliseconds, both observed on every item."
                      }
                    },
                    "additionalProperties": true
                  },
                  "Author": {
                    "type": "object",
                    "properties": {
                      "SecUid": {
                        "type": "string",
                        "description": "The creator's public account identifier."
                      },
                      "Nickname": {
                        "type": "string",
                        "description": "The creator's public display name."
                      },
                      "UniqueId": {
                        "type": "string",
                        "description": "The creator's public @handle. Observed empty on at least one real item -- not every account has one set."
                      },
                      "FollowerCount": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  },
                  "AwemeId": {
                    "type": "string",
                    "description": "The video's unique id."
                  },
                  "IsPhoto": {
                    "type": "boolean",
                    "description": "True for a photo-mode post rather than a video."
                  },
                  "CreateTime": {
                    "type": "string",
                    "description": "Post time, epoch MILLISECONDS as a string."
                  },
                  "Statistics": {
                    "type": "object",
                    "properties": {
                      "DiggCount": {
                        "type": "integer",
                        "description": "Like count."
                      },
                      "ShareCount": {
                        "type": "integer"
                      },
                      "CommentCount": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  }
                },
                "additionalProperties": true
              },
              "ItemSource": {
                "type": "object",
                "properties": {
                  "SourceType": {
                    "type": "integer"
                  },
                  "ItemGeneraion": {
                    "type": "integer",
                    "description": "The vendor's own field name (their spelling, kept as observed)."
                  }
                },
                "additionalProperties": true
              },
              "PlayletType": {
                "type": "integer"
              },
              "HasLocalAnchor": {
                "type": "boolean"
              }
            },
            "additionalProperties": true
          },
          "description": "Matching videos, up to `count` per page. Observed as 11 items on every one of the three real captures, including a nonsense keyword expected to return zero results -- a genuinely empty result set was never observed; its shape is unconfirmed."
        }
      },
      "additionalProperties": true
    }
  },
  "description": "The search response.",
  "additionalProperties": true
}