Skip to main content
POST
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.
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
period_end_timestamp
integer
required

调用方需根据目标榜单日期自行生成结束时间戳(10位 Unix 秒级),例如 1785024000;请勿传 0,否则会返回空结果/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
integer
default:3

榜单周期:1/3/5 /Period dimension

Examples:

1

3

5

country_code
string
default:US

国家/地区代码/Country code

content_label_ids
string
default:""

内容分类ID,多个用逗号分隔,空为全部/Content label IDs, comma separated

order_by_metric
integer
default:1

排序指标:1 播放量 2 互动率 3 6秒完播率/Order by metric

Examples:

1

2

3

organic_only
boolean
default:false

是否仅看自然流量内容/Organic content only

page
integer
default:1

页码/Page number

limit
integer
default:20

每页数量,最大100/Items per page, max 100

自定义Cookie字符串(可选)/Custom Cookie string (optional)

Response

200

Successful response. 以实际调用为准 / Response structure varies; refer to the actual API response.