> ## 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 item list

> Fetch item list

Fetch item 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/douyin/creator_v2/fetch_item_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/douyin/creator_v2/fetch_item_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/creator_v2/fetch_item_list:
    post:
      tags:
        - TikHub - Douyin
      summary: Fetch item list
      description: Fetch item list
      operationId: post_tikhub_douyin_creator_v2_fetch_item_list
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ItemListRequest'
              description: Item list request parameters
            example:
              cookie: Your_Cookie_Here
              start_time: 1758988800000
              end_time: 1760198399000
              count: 10
              order_by: 1
              fields: metrics,review,visibility
              need_cooperation: true
              need_long_article: true
        required: true
      responses:
        '200':
          description: >-
            Successful response. Response structure varies; refer to the actual
            API response.
components:
  schemas:
    ItemListRequest:
      properties:
        cookie:
          type: string
          title: Cookie
          description: User Cookie
          example: Your_Cookie_Here
        count:
          type: integer
          title: Count
          description: Count per page (max 100)
          default: 10
          example: 10
        order_by:
          type: integer
          title: Order By
          description: >-
            Order by (1-26): 1=Publish time (newest first), 2=Publish time
            (oldest first), 3=Views (desc), 4=Views (asc), 5=Likes (desc),
            6=Likes (asc), 7=Comments (desc), 8=Comments (asc), 9=Shares (desc),
            10=Shares (asc), 11=Favorites (desc), 12=Favorites (asc), 13=2s
            bounce rate (desc), 14=2s bounce rate (asc), 15=5s completion rate
            (desc), 16=5s completion rate (asc), 17=Completion rate (desc),
            18=Completion rate (asc), 19=Cover CTR (desc), 20=Cover CTR (asc),
            21=Avg watch duration (desc), 22=Avg watch duration (asc),
            23=Profile visits (desc), 24=Profile visits (asc), 25=Follower
            growth (desc), 26=Follower growth (asc)
          default: 1
          example: 1
        fields:
          type: string
          title: Fields
          description: Fields to return
          default: metrics,review,visibility
          example: metrics,review,visibility
        need_cooperation:
          type: boolean
          title: Need Cooperation
          description: Need cooperation info
          default: true
          example: true
        start_time:
          type: integer
          title: Start Time
          description: Start timestamp (milliseconds)
          example: 1758988800000
        end_time:
          type: integer
          title: End Time
          description: End time timestamp (milliseconds)
          example: 1760198399000
        need_long_article:
          type: boolean
          title: Need Long Article
          description: Include long articles
          default: true
          example: true
        cursor:
          title: Cursor
          description: Pagination cursor (optional)
          nullable: true
          type: integer
      type: object
      required:
        - cookie
        - start_time
        - end_time
      title: ItemListRequest
      description: Item List Request Model
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: AIsa API key. Get yours at https://aisa.one

````