Fetch item list

Fetch item list

POST https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_list

Fetch item list

cURL

curl --request POST \
  --url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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
}
'

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.

Response structure is not yet fully documented — refer to the actual API response.

Example

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

Authorizations

Authorization · string · header · required

AIsa API key. Get yours at https://aisa.one

Body

application/json

Item list request parameters

cookie · string · required

User Cookie

Example:

"Your_Cookie_Here"

start_time · integer · required

Start timestamp (milliseconds)

Example:

1758988800000

end_time · integer · required

End time timestamp (milliseconds)

Example:

1760198399000

count · integer · default: 10

Count per page (max 100)

Example:

10

order_by · integer · default: 1

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)

Example:

1

fields · string · default: metrics,review,visibility

Fields to return

Example:

"metrics,review,visibility"

need_cooperation · boolean · default: true

Need cooperation info

Example:

true

need_long_article · boolean · default: true

Include long articles

Example:

true

cursor · integer | null

Pagination cursor (optional)

Response

200

Successful response. Response structure varies; refer to the actual API response.