> ## 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 promotable item list (with like & comment counts)

> Get promotable item list (with like & comment counts)

Get promotable item list (with like & comment counts)

**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_promotable_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/douplus/fetch_promotable_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/douplus/fetch_promotable_item_list:
    post:
      tags:
        - TikHub - Douyin
      summary: Get promotable item list (with like & comment counts)
      description: Get promotable item list (with like & comment counts)
      operationId: post_tikhub_douyin_douplus_fetch_promotable_item_list
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PromotableItemListRequest'
            example:
              sec_uid: >-
                MS4wLjABAAAA9fe7vGjwyiaOjL6REhX8rvmSb32VzA_XsKca9F3_YSHRXlEqgT2cpX54WGbtgnsA
              count: 30
              target_id: 31
        required: true
      responses:
        '200':
          description: >-
            Successful response. Response structure varies; refer to the actual
            API response.
components:
  schemas:
    PromotableItemListRequest:
      properties:
        sec_uid:
          type: string
          title: Sec Uid
          description: Delivery account sec_uid
          example: >-
            MS4wLjABAAAA9fe7vGjwyiaOjL6REhX8rvmSb32VzA_XsKca9F3_YSHRXlEqgT2cpX54WGbtgnsA
        count:
          title: Count
          description: Number of items
          default: 30
          example: 30
          nullable: true
          type: integer
        target_id:
          title: Target Id
          description: >-
            Promotion target ID (the goal card on the DOU+ page). 31=Likes &
            Comments, 32=Followers, 33=Profile visits, 37=Video views, 40=Live
            room popularity, 45=Comment link clicks, 63=Shown to followers,
            78=High-quality engagement. Only filters promotable items by goal;
            keep 31 for a plain video list
          default: 31
          example: 31
          nullable: true
          type: integer
        aim_ids:
          title: Aim Ids
          description: >-
            Optional advanced param: optimization objective code(s), comma
            separated; leave empty (auto-matched by target_id), usually no need
            to set
          nullable: true
          type: string
      type: object
      required:
        - sec_uid
      title: PromotableItemListRequest
      description: Promotable Item List Request Model
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: AIsa API key. Get yours at https://aisa.one

````