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

# Fetch hot list category

> Fetch hot list category

Fetch hot list category

**Pricing** — base \$0.00145 per successful call (provider cost × 1.45; final charge scales by your plan multiplier). Charged only when the upstream response body `code` is `200`.

<Note>
  Response structure is not yet fully documented — **refer to the actual API response**.
</Note>

## Example

```bash theme={null}
curl "https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_category_list?billboard_type=rise" \
  -H "Authorization: Bearer YOUR_API_KEY"
```


## OpenAPI

````yaml openapi/tikhub-en.json GET /tikhub/douyin/billboard/fetch_hot_category_list
openapi: 3.0.0
info:
  title: TikHub API
  description: >-
    Multi-platform social media data via TikHub — Douyin, TikTok, Bilibili,
    Kuaishou, Weibo, Xiaohongshu, Zhihu, and commercial
    (Xingtu/Huahuo/Billboard) endpoints.
  version: 1.0.0
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - bearerAuth: []
paths:
  /tikhub/douyin/billboard/fetch_hot_category_list:
    get:
      tags:
        - TikHub - Douyin
      summary: Fetch hot list category
      description: Fetch hot list category
      operationId: get_tikhub_douyin_billboard_fetch_hot_category_list
      parameters:
        - name: billboard_type
          in: query
          required: true
          schema:
            type: string
            description: Ranking type
            title: Billboard Type
          description: Ranking type
          example: rise
        - name: snapshot_time
          in: query
          required: false
          schema:
            type: string
            description: Snapshot time, yyyyMMddHHmmss format
            default: '20250106151500'
            title: Snapshot Time
          description: Snapshot time, yyyyMMddHHmmss format
        - name: start_date
          in: query
          required: false
          schema:
            type: string
            description: Snapshot start time, yyyyMMdd format
            default: ''
            title: Start Date
          description: Snapshot start time, yyyyMMdd format
        - name: end_date
          in: query
          required: false
          schema:
            type: string
            description: Snapshot end time, yyyyMMdd format
            default: ''
            title: End Date
          description: Snapshot end time, yyyyMMdd format
        - name: keyword
          in: query
          required: false
          schema:
            type: string
            description: Hot search keyword
            default: ''
            title: Keyword
          description: Hot search keyword
      responses:
        '200':
          description: >-
            Successful response. Response structure varies; refer to the actual
            API response.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: AIsa API key. Get yours at https://aisa.one

````