> ## Documentation Index
> Fetch the complete documentation index at: https://tiktools.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Hashtag List

> Get currently trending live stream hashtags from TikTok. Returns hashtag names, live viewer counts, and associated metadata.

## `GET` `/webcast/hashtag_list`

Get currently trending live stream hashtags from TikTok. Returns hashtag names, live viewer counts, and associated metadata.

**Response data:** Each hashtag includes `id`, `title` (the hashtag text), `user_count` (total viewers across all streams using this hashtag), and related metadata. Results are sorted by popularity.

**Use cases:** Discover trending topics for content strategy, build hashtag explorers, analyze live streaming trends over time, or filter the feed by popular hashtags.

**Pagination:** Use the `count` parameter to control results per page (default: 20, max: 50). The endpoint uses TikTok's internal trending algorithm, so results update frequently as trending topics shift.

### Parameters

| Parameter | Type   | Required | Description                              |
| --------- | ------ | -------- | ---------------------------------------- |
| `count`   | number | No       | Number of results (default: 20, max: 50) |

### Response

```json theme={null}
{ "status_code": 0, "data": [{ "id": "...", "title": "#gaming", "user_count": 15000 }, ...] }
```

### Examples

<CodeGroup>
  ```javascript Node.js theme={null}
  const res = await fetch('https://api.tik.tools/webcast/hashtag_list?count=10&apiKey=YOUR_KEY');
  const { data } = await res.json();
  data.forEach(tag => console.log(tag.title));
  ```

  ```python Python theme={null}
  import requests
  res = requests.get('https://api.tik.tools/webcast/hashtag_list',
      params={'count': 10, 'apiKey': 'YOUR_KEY'})
  for tag in res.json()['data']:
      print(tag['title'])
  ```

  ```bash cURL theme={null}
  curl "https://api.tik.tools/webcast/hashtag_list?count=10&apiKey=YOUR_KEY"
  ```

  ```java Java theme={null}
  HttpClient client = HttpClient.newHttpClient();
  HttpRequest req = HttpRequest.newBuilder()
      .uri(URI.create("https://api.tik.tools/webcast/hashtag_list?count=10&apiKey=YOUR_KEY"))
      .GET().build();
  HttpResponse<String> res = client.send(req, HttpResponse.BodyHandlers.ofString());
  System.out.println(res.body());
  ```

  ```go Go theme={null}
  resp, err := http.Get("https://api.tik.tools/webcast/hashtag_list?count=10&apiKey=YOUR_KEY")
  if err != nil { log.Fatal(err) }
  defer resp.Body.Close()
  body, _ := io.ReadAll(resp.Body)
  fmt.Println(string(body))
  ```

  ```csharp C# theme={null}
  using var client = new HttpClient();
  var res = await client.GetStringAsync(
      "https://api.tik.tools/webcast/hashtag_list?count=10&apiKey=YOUR_KEY");
  Console.WriteLine(res);
  ```
</CodeGroup>