> ## 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 top contents list

> Get top contents list

Get top contents list

**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/tiktok/ads/get_top_contents_list" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'  # see request schema below
```


## OpenAPI

````yaml openapi/tikhub-en.json POST /tikhub/tiktok/ads/get_top_contents_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/tiktok/ads/get_top_contents_list:
    post:
      tags:
        - TikHub - Tiktok
      summary: Get top contents list
      description: Get top contents list
      operationId: post_tikhub_tiktok_ads_get_top_contents_list
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/Body_get_top_contents_list_api_v1_tiktok_ads_get_top_contents_list_post
        required: true
      responses:
        '200':
          description: >-
            Successful response. Response structure varies; refer to the actual
            API response.
components:
  schemas:
    Body_get_top_contents_list_api_v1_tiktok_ads_get_top_contents_list_post:
      properties:
        period_end_timestamp:
          type: integer
          title: Period End Timestamp
          description: >-
            The caller must generate this 10-digit Unix timestamp in seconds
            from the target ranking date, for example 1785024000; do not pass 0
            because it returns an empty result
          example: 1785024000
        period_dimension:
          type: integer
          title: Period Dimension
          description: 'Period dimension: 1/3/5'
          default: 3
          example: 1
        country_code:
          type: string
          title: Country Code
          description: Country/region code
          default: US
        content_label_ids:
          type: string
          title: Content Label Ids
          description: Content label IDs, comma separated
          default: ''
        order_by_metric:
          type: integer
          title: Order By Metric
          description: >-
            Order by metric: 1=Views, 2=Engagement rate, 3=6-second completion
            rate
          default: 1
          example: 1
        organic_only:
          type: boolean
          title: Organic Only
          description: Organic content only
          default: false
        page:
          type: integer
          title: Page
          description: Page number
          default: 1
        limit:
          type: integer
          title: Limit
          description: Items per page, max 100
          default: 20
        cookie:
          type: string
          title: Cookie
          description: Custom Cookie string (optional)
      type: object
      required:
        - period_end_timestamp
      title: Body_get_top_contents_list_api_v1_tiktok_ads_get_top_contents_list_post
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: AIsa API key. Get yours at https://aisa.one

````