抖音用户搜索 API

curl -G "https://api.dataxapi.com/v1/douyin/users/search" \
  --data-urlencode "query=博物馆" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

{
  "code": "ok",
  "request_id": "b0f3b606-db10-414c-8957-8c8ef30196a9",
  "data": {
    "items": [
      {
        "id": "MS4wLjABAAAAQyB8tdkhu0nIT5L6sov74H0ObWv_pTgxnWI-cR6TAEi",
        "name": "老周说装备",
        "url": "https://www.douyin.com/user/MS4wLjABAAAAQyB8tdkhu0nIT5L6sov74H0ObWv_pTgxnWI-cR6TAEi",
        "avatar_url": "https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_250800d2aaa04de76963.jpeg",
        "metrics": { "followers": 5566247, "posts": 488 }
      },
      // … 另有 29 条
    ]
  },
  "page": {
    "next_cursor": "c1.TCL7sZb0hkLPfs1m_OgfD7-LmOm2UItTR_rC0aJQ",
    "cursor_expires_at": "2026-10-12T19:44:13.000Z",
    "has_more": true,
    "returned": 30
  },
  "warnings": [],
  "meta": {
    "capability": "douyin.users.search",
    "result_status": "complete",
    "fetched_at": "2026-10-12T18:44:13.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "username": "capability",
      "bio": "capability",
      "verified": "capability",
      "created_at": "platform",
      "metrics.following": "capability"
    },
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}

取自 2026-10-12 18:44 UTC 录下的真实返回。名字、正文和编号是示例，链接也是，都不是录到的原文（页面不展示任何人的个人信息）；数字是原样。长列表做了截断。请求号、游标和余额是示意。

返回大小：标准档 11.7 KB（精简 7.7 KB，完整 12.4 KB）。

{
  "code": "ok",
  "request_id": "9f2714fa-1273-4900-98b8-01fdbc7f971a",
  "data": { "items": [] },
  "page": {
    "next_cursor": null,
    "cursor_expires_at": null,
    "has_more": false,
    "returned": 0
  },
  "warnings": [],
  "meta": {
    "capability": "douyin.users.search",
    "result_status": "empty",
    "fetched_at": "2026-10-12T18:44:13.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "username": "capability",
      "bio": "capability",
      "verified": "capability",
      "created_at": "platform",
      "metrics.following": "capability"
    },
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}

取自 2026-10-12 18:44 UTC 的录制，为演示这种情况人工改过。请求号和余额是示意。

返回大小：标准档 525 B（精简 525 B，完整 525 B）。

curl -G "https://api.dataxapi.com/v1/douyin/users/search" \
  --data-urlencode "query=博物馆" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

# pip install dataxapi
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.douyin.users.search(query="博物馆")
print(result["data"]["items"])

// npm i @dataxapi/sdk
import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.douyin.users.search({ query: "博物馆" });
console.log(result.data.items);

dataxapi call douyin.users.search 'query=博物馆'

{
  "mcpServers": {
    "dataxapi": {
      "type": "http",
      "url": "https://api.dataxapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DATAXAPI_API_KEY}"
      }
    }
  }
}

把这段加进你的 MCP 客户端，然后让你的 AI 调用 douyin.users.search。