Skip to main content
POST
PGY content square leaderboards
PGY content square leaderboards Pricing — base $0.029 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
biz_type
enum<integer>
required

榜单 1=小红书热门 2=产品种草 3=电商推广 4=蒲公英合作 5=客资收集 6=电商热门 7=种草直达 8=应用推广/Leaderboard

Available options:
1,
2,
3,
4,
5,
6,
7,
8
Example:

1

page_num
integer
default:1

页码;每个榜固定只有 100 条/Page; each board has only 100 items

Required range: 1 <= x <= 100
Example:

1

page_size
integer
default:34

每页数量,1-34(网页固定 34)/Page size, 1-34

Required range: 1 <= x <= 34
Example:

34

search_word
string
default:""

关键词,留空=看整榜;支持英文逗号分隔批量搜/Keyword, comma-separated for batch

Maximum string length: 100
Example:

"面膜"

order_by
string
default:""

排序字段,留空=用该榜默认排序/Sort field, empty=board default

Maximum string length: 64
Example:

"premium_imp_num"

date_range
enum<integer>
default:7

统计窗口:近 3/7/14/30 日/Date window in days

Available options:
3,
7,
14,
30
Example:

7

sub_biz_type
enum<integer> | null

【仅榜 8】1=应用下载 2=小程序推广 3=应用唤起(默认)/Board 8 only

Available options:
1,
2,
3
Example:

3

category
string | null

【仅榜 1】类目,格式「一级#二级」,如 "内容类目#美妆"/Board 1 only

Maximum string length: 64
Example:

"内容类目#美妆"

industry
string | null

【榜 2/3/4/5/6/7/8】所属行业名,取值集因榜而异/Industry, values differ per board

Maximum string length: 64
Example:

"母婴"

note_type
enum<integer> | null

内容类型 1=图文 2=视频/Content type

Available options:
1,
2
Example:

2

content_type
enum<integer> | null

内容来源 1=博主合作 2=明星合作 3=员工 5=买手 6=专业号 11=主理人 -1=用户/Content source

Available options:
1,
2,
3,
5,
6,
11,
-1
Example:

1

theme
string | null

【榜 2/4/5/7/8】题材名/Theme

Maximum string length: 64
Example:

"开箱"

author_type
enum<integer> | null

【仅榜 4】1=蒲公英博主 2=明星/Board 4 only

Available options:
1,
2
Example:

1

placement
enum<integer> | null

【榜 2/3/5/7/8】流量场域 1=发现 2=搜索 3=视频内流/Traffic placement

Available options:
1,
2,
3
Example:

1

marketing_target
enum<integer> | null

【仅榜 3】3=商品推广 8=直播推广/Board 3 only

Available options:
3,
8
Example:

3

price
PriceFilter · object | null

【仅榜 4】创作者报价/Creator price, board 4 only

fans
RangeFilter · object | null

【仅榜 4】创作者粉丝量区间/Creator fans range, board 4 only

Response

200

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