> ## 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.

# Get DOU+ video ranking

> Get DOU+ video ranking

Get DOU+ video ranking

**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 -X POST "https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'  # see request schema below
```


## OpenAPI

````yaml openapi/tikhub-en.json POST /tikhub/douyin/douplus/fetch_video_ranking
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/douplus/fetch_video_ranking:
    post:
      tags:
        - TikHub - Douyin
      summary: Get DOU+ video ranking
      description: Get DOU+ video ranking
      operationId: post_tikhub_douyin_douplus_fetch_video_ranking
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoRankingRequest'
            example:
              time_range: 2
              tag_id: 634
              dim_type: 5
              adv_id: ''
        required: true
      responses:
        '200':
          description: >-
            Successful response. Response structure varies; refer to the actual
            API response.
components:
  schemas:
    VideoRankingRequest:
      properties:
        time_range:
          title: Time Range
          description: 'Time range: 1 / 2 / 3'
          default: 2
          example: 2
          nullable: true
          type: integer
        tag_id:
          title: Tag Id
          description: >-
            Category id. 601 Drama, 602 Celebrity, 606 Music, 607 Anime, 608
            Gaming, 609 Current Affairs, 612 Dance, 614 Agriculture, 615
            Technology, 616 Finance, 617 Parenting, 619 Lifestyle, 621 Health,
            623 Emotions, 624 Culture, 625 Workplace, 626 Education, 627
            Photography, 628 Food, 629 Travel, 631 Fashion, 633 Sports, 634
            Entertainment, 635 Automotive
          default: 634
          example: 634
          nullable: true
          type: integer
        dim_type:
          title: Dim Type
          description: >-
            Ranking dimension: 1=Low-follower Viral, 2=High Completion Rate,
            3=High Like Rate, 4=High Follower Growth Rate, 5=Popularity Index
          default: 5
          example: 5
          nullable: true
          type: integer
        adv_id:
          title: Adv Id
          description: Advertiser id (optional)
          default: ''
          example: ''
          nullable: true
          type: string
      type: object
      title: VideoRankingRequest
      description: DOU+ Video Ranking Request Model
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: AIsa API key. Get yours at https://aisa.one

````