FeedMCP

Data APIs / Douyin

Douyin high-index videos API

High-index Douyin videos Ocean Engine puts forward for a keyword: caption, author, likes, index and length, optionally only low-follower hits or high completion, follow or like rates.

Item Value
Endpoint GET https://api.feedmcp.com/v1/douyin/index/videos/search
ID douyin.index.videos.search
Price $0.002 / call
Returns A page of Post objects
Auth Authorization: Bearer $FEEDMCP_API_KEY

All in one go (up to limit), no further pages. metrics.index is the Ocean Engine video index and metrics.author_followers the author’s followers; tags marks low-follower hits, high completion and so on.

Parameters

Name Type Required Description
keyword string yes Keyword
time any / 3d / 7d / 30d no Posted within: any, 3d, 7d or 30d; default any
type any / low_fans_hit / high_completion / high_follow / high_like no any, low_fans_hit, high_completion, high_follow or high_like; default any
limit integer no Items per page, default 50, at most 100

Every endpoint also takes view=full to include the platform's raw data as raw, at the same price.

Returned fields

data.items is a list of Post objects, with the same fields on every platform:

Field Type Description
id string The platform ID, which the platform's detail endpoint takes: TikTok or Douyin video ID, YouTube video ID, Instagram or Threads code, X post ID, Telegram "channel/number", Reddit short ID, LinkedIn activity number, Pinterest pin number, Kuaishou 3x… video ID, WeChat Channels object ID, Zhihu answer, question or article ID, Xiaohongshu note ID, BV ID, Weibo ID or article ID
platform string Platform: tiktok, youtube, instagram, x, threads, telegram, reddit, linkedin, facebook, pinterest, xiaohongshu, douyin, kuaishou, wechat_mp, wechat_channels, weibo, zhihu or bilibili
type string video, note, article, post (Weibo, X, Threads, Telegram, Reddit, LinkedIn, Facebook, Pinterest, Instagram photos), question or answer (Zhihu)
url string Link to the original
title string | null Title (YouTube, Reddit, Pinterest, Bilibili, Xiaohongshu and WeChat; for a Zhihu answer, its question; null elsewhere)
text string | null Body text or caption
created_at string | null Published at, ISO 8601, UTC
author.id string | null Author ID; pass it straight to that platform's account endpoints
author.name string | null Author name
metrics.views number | null Views or plays (null when the platform hides it)
metrics.likes number | null Likes (score on Reddit, total reactions on Facebook)
metrics.comments number | null Comments
metrics.shares number | null Shares or reposts (reposts on X)
metrics.quotes number | null Quotes (X and Threads)
metrics.reactions number | null Total reactions (Telegram only)
metrics.answers number | null Answers (Zhihu questions only)
metrics.upvote_ratio number | null Upvote ratio from 0 to 1 (Reddit only)
metrics.repins number | null Repins (Pinterest only)
metrics.favorites number | null Saves (bookmarks on X, saves on Pinterest)
cover string | null Cover image URL
duration_seconds number | null Video length in seconds
tags string[] Hashtags (the flair on Reddit)
community string | null Subreddit (Reddit only)
link string | null The page a pin links to (Pinterest only)

When you are charged

$0.002 per successful call, including an empty result (an empty search is still an answer). Bad parameters, platform errors and timeouts are free.

Each answer carries meta.billing: what this call cost and the balance left.

Request

cURL

curl "https://api.feedmcp.com/v1/douyin/index/videos/search?keyword=%E9%9C%B2%E8%90%A5" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/douyin/index/videos/search",
    params={"keyword": "露营"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())

JavaScript

const res = await fetch("https://api.feedmcp.com/v1/douyin/index/videos/search?keyword=%E9%9C%B2%E8%90%A5", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());

MCP

From an AI with FeedMCP installed, the call tool:

{
  "endpoint": "douyin.index.videos.search",
  "params": {
    "keyword": "露营"
  },
  "max_price": "0.002"
}

Response

The data below is made up; the shape is the real one.

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "items": [
      {
        "id": "7708330099309587551",
        "platform": "douyin",
        "type": "video",
        "url": "https://www.douyin.com/video/7708330099309587551",
        "title": null,
        "text": "雪地露营 1",
        "created_at": "2026-11-15T09:37:38.000Z",
        "author": {
          "id": null,
          "name": "摩托冒险1"
        },
        "metrics": {
          "likes": 190954,
          "index": 291537,
          "author_followers": 56286
        },
        "cover": null,
        "duration_seconds": 54,
        "tags": [
          "低粉爆款"
        ]
      },
      {
        "id": "7708330099309587552",
        "platform": "douyin",
        "type": "video",
        "url": "https://www.douyin.com/video/7708330099309587552",
        "title": null,
        "text": "雪地露营 2",
        "created_at": "2026-11-15T09:37:38.000Z",
        "author": {
          "id": null,
          "name": "摩托冒险2"
        },
        "metrics": {
          "likes": 190954,
          "index": 291537,
          "author_followers": 56286
        },
        "cover": null,
        "duration_seconds": 54,
        "tags": [
          "低粉爆款"
        ]
      }
    ]
  },
  "page": {
    "next_cursor": null,
    "has_more": false
  },
  "warnings": [],
  "meta": {
    "endpoint": "douyin.index.videos.search",
    "platform": "douyin",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.002",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}

Errors are described in Errors: each says whether you were charged (charged) and whether to retry (retry).

Other Douyin endpoints

Questions

How much does the Douyin high-index videos endpoint cost?

$0.002 per successful call, including an empty result (an empty search is still an answer). Bad parameters, platform errors and timeouts are free.

Do I need a platform account?

No. Only public data is read.

A video ID is the number after /video/; an account is the sec_user_id after /user/, not the Douyin handle.

How do I get more items?

When the answer has page.next_cursor, pass it back as cursor for the next page, up to 100 a page. Each page is billed on its own.

How do I use it from an AI?

Install the MCP server and ask; your AI calls douyin.index.videos.search.