TikTok 获取流行歌曲

获取 TikTok 上当前流行的歌曲/声音，源自 TikTok 创意中心。

1 credits / 次请求

GET /v1/tiktok/songs/popular 试用

TikTok 获取流行歌曲
GET /v1/tiktok/songs/popular

获取 TikTok 上当前流行的歌曲/声音，源自 TikTok 创意中心。

鉴权：x-api-key
示例 URL: https://api.datawake.ai/v1/tiktok/songs/popular?page=1&timePeriod=7&rankType=popular&countryCode=US

参数：
- page (query · number · 可选) = 1
- timePeriod (query · string · 可选) = 7
- rankType (query · string · 可选) = popular
- newOnBoard (query · boolean · 可选)
- commercialMusic (query · boolean · 可选)
- countryCode (query · string · 可选) = US

概览

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 上当前流行的歌曲/声音，源自 TikTok 创意中心。返回“sound_list”，一个歌曲对象数组，每个歌曲对象包含“title”、“author”、“clip_id”、“rank”、“cover”图像 URL、“duration”、声音页面的“link”以及显示随时间变化的流行度的“trend”数组。按国家/地区、时间段（7/30/120 天）、排名类型（流行与热潮）和商业音乐认可进行过滤。

可选查询参数可以组合在同一个请求里。

请求头

x-api-key string 必填

你的 Wake API 访问密钥。

示例：

YOUR_API_KEY

查询参数

page number

页码

示例：

timePeriod string

获取流行歌曲的时间段

示例：

枚举： 7, 30, 130

rankType string

获取流行或澎湃的歌曲

示例：

popular

枚举： popular, surging

newOnBoard boolean

新晋前 100 名

commercialMusic boolean

批准用于商业用途？

countryCode string

用于获取流行歌曲的国家/地区代码

示例：

枚举： AR, AU, AT, BH, BD, BY, BE, BR, BG, KH, CA, CL, CO, HR, CZ, DK, EG, EE, FI, FR, DE, GR, HU, IS, ID, IQ, IE, IL, IT, JP, JO, KZ, KW, LV, LB, LT, LU, MO, MY, MX, MA, MM, NL, NZ, NG, NO, OM, PK, PE, PH, PL, PT, QA, RO, SA, SG, SK, ZA, KR, ES, SE, CH, TW, TH, TR, UA, AE, GB, US, UZ, VN


              curl 'https://api.datawake.ai/v1/tiktok/songs/popular?page=1&timePeriod=7&rankType=popular&countryCode=US' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'


              const response = await fetch("https://api.datawake.ai/v1/tiktok/songs/popular?page=1&timePeriod=7&rankType=popular&countryCode=US", {
  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/songs/popular?page=1&timePeriod=7&rankType=popular&countryCode=US",
    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/songs/popular?page=1&timePeriod=7&rankType=popular&countryCode=US",
    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/songs/popular?page=1&timePeriod=7&rankType=popular&countryCode=US", 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/songs/popular?page=1&timePeriod=7&rankType=popular&countryCode=US"))
    .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());


              {
  "pagination": {
    "page": 1,
    "size": 20,
    "total": 99,
    "has_more": true
  },
  "sound_list": [
    {
      "author": "Kendrick Lamar & SZA",
      "clip_id": "7439295283975702544",
      "country_code": "US",
      "cover": "https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA.jpeg",
      "duration": 59,
      "if_cml": false,
      "is_search": false,
      "link": "https://www.tiktok.com/music/x-7439295283975702544",
      "on_list_times": null,
      "promoted": false,
      "rank": 1,
      "rank_diff": 1,
      "rank_diff_type": 1,
      "related_items": [
        {
          "item_id": "...",
          "cover_uri": "..."
        }
      ],
      "song_id": "7440101671265486864",
      "title": "luther",
      "trend": [
        {
          "time": "...",
          "value": "..."
        }
      ],
      "url_title": "luther"
    }
  ]
}


              {
  "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."
  }
}