TikTok 热门搜索

通过查询搜索 TikTok 的“热门”结果 — 同时返回视频和照片轮播，这与仅返回视频的关键字搜索不同。

1 credits / 次请求

GET /v1/tiktok/search/top 试用

TikTok 热门搜索
GET /v1/tiktok/search/top

通过查询搜索 TikTok 的“热门”结果 — 同时返回视频和照片轮播，这与仅返回视频的关键字搜索不同。

鉴权：x-api-key
示例 URL: https://api.datawake.ai/v1/tiktok/search/top?query=funny&publish_time=all-time&sort_by=relevance

参数：
- query (query · string · 必填) = funny
- publish_time (query · string · 可选) = all-time
- sort_by (query · string · 可选) = relevance
- region (query · string · 可选)
- cursor (query · number · 可选)

概览

WakeScrap exposes this TikTok endpoint as a live-data API. The platform keeps the documented request and response shape stable while unifying auth, request tracking, and credits billing.

通过查询搜索 TikTok 的“热门”结果 — 同时返回视频和照片轮播，这与仅返回视频的关键字搜索不同。返回“items”，一个对象数组，每个对象包含“id”、“desc”（标题）、“content_type”（视频或照片轮播）、“statistics”（play_count、digg_count/likes、comment_count、share_count）、“video”信息和轮播的“images”。使用“光标”分页。

必填参数：query。

请求头

x-api-key string 必填

你的 Wake API 访问密钥。

示例：

YOUR_API_KEY

查询参数

query string 必填

要搜索的关键字

示例：

funny

publish_time string

时间范围 TikTok 发布

示例：

all-time

枚举： yesterday, this-week, this-month, last-3-months, last-6-months, all-time

sort_by string

排序方式

示例：

relevance

枚举： relevance, most-liked, date-posted

region string

该参数不直接按地区过滤结果；它设置用于请求的区域。如果您想抓取仅适用于某些国家/地区的帖子，请使用它。使用 2 个字母的国家/地区代码，例如 US、GB、FR 等

cursor number

光标可获取更多视频。从先前的响应中获取“光标”。


              curl 'https://api.datawake.ai/v1/tiktok/search/top?query=funny&publish_time=all-time&sort_by=relevance' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'


              const response = await fetch("https://api.datawake.ai/v1/tiktok/search/top?query=funny&publish_time=all-time&sort_by=relevance", {
  method: "GET",
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Accept': 'application/json',
  },
});

const data = await response.json();
console.log(data);


              import requests

response = requests.request(
    "GET",
    "https://api.datawake.ai/v1/tiktok/search/top?query=funny&publish_time=all-time&sort_by=relevance",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Accept": "application/json",
    },
)

print(response.json())


              $ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.datawake.ai/v1/tiktok/search/top?query=funny&publish_time=all-time&sort_by=relevance",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        'x-api-key: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;


              client := &http.Client{}
req, err := http.NewRequest("GET", "https://api.datawake.ai/v1/tiktok/search/top?query=funny&publish_time=all-time&sort_by=relevance", nil)
if err != nil {
    panic(err)
}

req.Header.Set("x-api-key", "YOUR_API_KEY")
req.Header.Set("Accept", "application/json")

resp, err := client.Do(req)
if err != nil {
    panic(err)
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))


              HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.datawake.ai/v1/tiktok/search/top?query=funny&publish_time=all-time&sort_by=relevance"))
    .header("x-api-key", "YOUR_API_KEY")
    .header("Accept", "application/json")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());


              {
  "success": true,
  "items": [
    {
      "id": "7528150371680767263",
      "desc": "Last two brain cells at 3 am 💀 (IB: @Marearo) #dance #trend #fun ",
      "content_type": "video",
      "create_time": "2025-07-17T20:28:28.000Z",
      "desc_language": "en",
      "region": "US",
      "is_top": 0,
      "statistics": {
        "aweme_id": "7528150371680767263",
        "collect_count": 101,
        "comment_count": 83,
        "digg_count": 1895,
        "download_count": 3,
        "forward_count": 0,
        "lose_comment_count": 0,
        "lose_count": 0,
        "play_count": 17897,
        "repost_count": 0,
        "share_count": 27,
        "whatsapp_share_count": 1
      },
      "video": {
        "CoverTsp": 11.37871674085026,
        "ai_dynamic_cover": {
          "uri": "...",
          "url_list": "...",
          "url_prefix": "..."
        },
        "ai_dynamic_cover_bak": {
          "uri": "...",
          "url_list": "...",
          "url_prefix": "..."
        },
        "animated_cover": {
          "uri": "...",
          "url_list": "...",
          "url_prefix": "..."
        },
        "big_thumbs": [],
        "bit_rate": [
          "..."
        ],
        "bit_rate_audio": [],
        "cdn_url_expired": 0,
        "cla_info": {
          "caption_infos": "...",
          "captions_type": "...",
          "creator_edited_caption_id": "...",
          "enable_auto_caption": "...",
          "has_original_audio": "...",
          "hide_original_caption": "...",
          "no_caption_reason": "...",
          "vertical_positions": "..."
        },
        "cover": {
          "height": "...",
          "uri": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "cover_is_custom": true,
        "did_profile_labels": "",
        "download_addr": {
          "data_size": "...",
          "file_cs": "...",
          "height": "...",
          "uri": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "download_no_watermark_addr": {
          "data_size": "...",
          "file_cs": "...",
          "file_hash": "...",
          "height": "...",
          "uri": "...",
          "url_key": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "duration": 14700,
        "dynamic_cover": {
          "height": "...",
          "uri": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "has_watermark": true,
        "height": 1024,
        "...": "14 more fields"
      },
      "author": {
        "accept_private_policy": false,
        "account_labels": null,
        "ad_cover_url": null,
        "advance_feature_item_order": null,
        "advanced_feature_info": null,
        "authority_status": 0,
        "avatar_168x168": {
          "height": "...",
          "uri": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "avatar_300x300": {
          "height": "...",
          "uri": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "avatar_larger": {
          "height": "...",
          "uri": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "avatar_medium": {
          "height": "...",
          "uri": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "avatar_thumb": {
          "height": "...",
          "uri": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "avatar_uri": "tos-useast5-avt-0068-tx/7321410560359137323",
        "aweme_count": 0,
        "bold_fields": null,
        "can_message_follow_status_list": null,
        "can_set_geofencing": null,
        "cha_list": null,
        "comment_filter_status": 0,
        "...": "76 more fields"
      },
      "is_eligible_for_commission": true,
      "is_paid_partnership": false,
      "create_time_utc": "2025-09-03T18:37:38.000Z",
      "url": "https://www.tiktok.com/@branttakes/video/7545933721589910798",
      "shop_product_url": "https://www.tiktok.com/shop/pdp/1729494515984797858"
    }
  ],
  "cursor": 30
}


              {
  "error": {
    "code": "invalid_request",
    "message": "One or more required parameters are missing or invalid."
  }
}


              {
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing x-api-key header."
  }
}


              {
  "error": {
    "code": "insufficient_credits",
    "message": "This request requires available credits before execution."
  }
}