FeedMCP

Data APIs / Douyin

Douyin account search API

Find Douyin accounts by keyword: sec_user_id, name, avatar, followers, likes and videos, 30 a page.

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

Name, avatar, followers, likes and videos only; the Douyin handle, bio and verification come from the profile endpoint.

Parameters

Name Type Required Description
keyword string yes Search keyword
cursor string no Pagination cursor. Leave it out for the first page; pass page.next_cursor for the next. Each page is billed on its own

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 Account objects, with the same fields on every platform:

Field Type Description
id string Account ID, the same id the platform's account endpoints take: the username on TikTok, Instagram, X and Threads, the channel name on Telegram, the subreddit name on Reddit, the part after /in/ or /company/ on LinkedIn, the page name or number on Facebook, the UC… channel ID on YouTube, sec_user_id on Douyin, the numeric user ID on Kuaishou, v2_…@finder on WeChat Channels, the profile token on Zhihu, the user ID on Xiaohongshu, the UID on Bilibili and Weibo, the gh_… ID on WeChat
platform string Platform
name string | null Display name
handle string | null Handle: username, Douyin ID, RED ID or WeChat ID
uid string | null Numeric Douyin uid (Douyin only; the Ocean Engine creator endpoints take it)
bio string | null Bio
avatar string | null Avatar URL
url string | null Profile link
verified boolean | null Verified
verified_reason string | null Verification label or owner
metrics.followers number | null Followers
metrics.following number | null Following
metrics.posts number | null Posts
metrics.likes number | null Likes received
metrics.views number | null Total views (YouTube channels only)
metrics.employees number | null Employees (LinkedIn companies only)
metrics.weekly_active_users number | null Weekly active users (subreddits only)
metrics.articles number | null Articles (Zhihu account search only)
private boolean | null Private account (Instagram account search only)
owner object | null The registered owner: name, country, registered_at, verified_at and third_party_services (account owner endpoint only)
metrics.ads number | null Roughly how many ads (Google advertisers only)
metrics.instagram_followers number | null Followers of the linked Instagram (Meta advertisers only)
location string | null Location (LinkedIn and Facebook)
category string | null Category: Facebook page category, LinkedIn industry, or WeChat account type (Official Account, service account, Channels or mini program)
website string | null Website (LinkedIn companies and Facebook pages)
experience object[] LinkedIn: organizations shown publicly, with organization, location, start and end
education object[] LinkedIn: schools and organizations shown publicly, with school, start and end

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/users/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/users/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/users/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.users.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": [
      {
        "name": "露营叔1",
        "handle": null,
        "bio": null,
        "avatar": "https://p3.douyinpic.com/a.jpeg",
        "url": "https://www.douyin.com/user/MS4wLjABAAAAmock1",
        "verified": null,
        "metrics": {
          "followers": 1027143,
          "likes": 10795341,
          "posts": 682
        },
        "id": "MS4wLjABAAAAmock1",
        "platform": "douyin"
      },
      {
        "name": "露营叔2",
        "handle": null,
        "bio": null,
        "avatar": "https://p3.douyinpic.com/a.jpeg",
        "url": "https://www.douyin.com/user/MS4wLjABAAAAmock2",
        "verified": null,
        "metrics": {
          "followers": 1027143,
          "likes": 10795341,
          "posts": 682
        },
        "id": "MS4wLjABAAAAmock2",
        "platform": "douyin"
      }
    ]
  },
  "page": {
    "next_cursor": "eyJjdXJzb3IiOjIwfQ",
    "has_more": true
  },
  "warnings": [],
  "meta": {
    "endpoint": "douyin.users.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 account search 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. 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.users.search.