Skip to main content
POST
Fetch item analysis item performance
Fetch item analysis item performance Pricing — billed per successful call; the 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

Authorizations

Authorization
string
header
required

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

Body

application/json

Item analysis item performance request parameters

User's Douyin Creator Platform Cookie (required, transmitted in request body)

Example:

"Your_Cookie_Here"

start_date
string
required

Start date (format YYYYMMDD)

Example:

"20250713"

end_date
string
required

End date (format YYYYMMDD)

Example:

"20251011"

primary_verticals
string[]
required

Primary verticals list (obtained from the involved_vertical endpoint)

Usage: Vertical tag list (required, obtained from fetch_item_analysis_involved_vertical)

API references: fetch_item_analysis_involved_vertical = POST /tikhub/douyin/creator_v2/fetch_item_analysis_involved_vertical (operationId: post_tikhub_douyin_creator_v2_fetch_item_analysis_involved_vertical).

Example:
genres
integer[]

Genres list: 1=video under 1 min, 2=1-3 min video, 3=3-5 min video, 4=video over 5 min, 5=image+text, 8=long-form article

Usage: Genre type list (optional, defaults to all genres)

  • 1: Videos under 1 minute
  • 2: 1-3 minute videos
  • 3: 3-5 minute videos
  • 4: Videos over 5 minutes
  • 5: Photo posts
  • 8: Long photo posts
Example:
metric_type
integer
default:1

Metric type: 1=Views, 2=Likes, 3=Comments, 4=Shares

Example:

1

Response

200 - application/json

Successful response. The outer object follows ResponseModel; the endpoint-specific payload is in data.

Return Data Description

  • Contains performance data for selected metrics across different genres and verticals
  • Trend analysis and comparison data
  • Helps understand content performance across various dimensions
code
integer
default:200

HTTP status code

request_id
string | null

Unique request identifier

message
string
default:Request successful. This request will incur a charge.

Response message (EN-US)

message_zh
string
default:请求成功,本次请求将被计费。

Response message (ZH-CN)

support
string
default:Discord: https://discord.gg/aMEAS8Xsvz

Support message

time
string

The time the response was generated

time_stamp
integer

The timestamp the response was generated

time_zone
string
default:America/Los_Angeles

The timezone of the response time

docs
string | null

Link to the API Swagger documentation for this endpoint

cache_message
string | null
default:This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.

Cache message (EN-US)

cache_message_zh
string | null
default:本次响应已缓存,可通过下方 URL 直接查看,有效期 24 小时,访问缓存链接无额外费用。缓存仅用于请求溯源,不影响接口数据的时效性,也不会再次通过接口返回。

Cache message (ZH-CN)

cache_url
string | null

The URL to access the cached result

router
string
default:""

The endpoint that generated this response

params
any
default:{}

The parameters used in the request

data
any | null

Endpoint-specific response payload. The official shared model does not declare a fixed type or field set. Use the operation's documented return fields or response example; an operation-specific schema, when present, describes the documented fields. Undocumented fields must be read from the actual response rather than assumed.