PGY content square leaderboards

PGY content square leaderboards

POST https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_content_square

PGY content square leaderboards

cURL

curl --request POST \
  --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_content_square \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "biz_type": 1,
  "page_num": 1,
  "page_size": 34,
  "search_word": "Face Mask",
  "order_by": "premium_imp_num",
  "date_range": 7,
  "sub_biz_type": 3,
  "category": "Content category: Beauty",
  "industry": "Parenting & Baby",
  "note_type": 2,
  "content_type": 1,
  "theme": "Unboxing",
  "author_type": 1,
  "placement": 1,
  "marketing_target": 3,
  "price": {
    "range": {
      "min": 4999999,
      "max": 4999999
    }
  },
  "fans": {
    "min": 4999999,
    "max": 4999999
  }
}
'

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

curl -X POST "https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_content_square" \
  -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

biz_type · enum<integer> · required

Leaderboard: 1=Xiaohongshu Popular, 2=Product Seeding, 3=E-commerce Promotion, 4=Dandelion Collaboration, 5=Lead Collection, 6=E-commerce Hot, 7=Direct Seeding, 8=App Promotion

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

Example:

1

page_num · integer · default: 1

Page; each board has only 100 items

Required range: 1 <= x <= 100

Example:

1

page_size · integer · default: 34

Page size, 1-34 (web fixed at 34)

Required range: 1 <= x <= 34

Example:

34

search_word · string · default: ""

Keyword; leave empty to view the full chart; supports comma-separated batch search

Maximum string length: 100

Example:

"Face Mask"

order_by · string · default: ""

Sort field, empty=board default

Maximum string length: 64

Example:

"premium_imp_num"

date_range · enum<integer> · default: 7

Date window in days

Available options: 3, 7, 14, 30

Example:

7

sub_biz_type · enum<integer> | null

Board 8 only: 1=app download, 2=mini-program promotion, 3=app re-engagement (default)

Available options: 1, 2, 3

Example:

3

category · string | null

Category (board 1 only), format: "level1#level2", e.g. "Content Category#Beauty"

Maximum string length: 64

Example:

"Content category: Beauty"

industry · string | null

Industry name (boards 2/3/4/5/6/7/8); valid values differ per board

Maximum string length: 64

Example:

"Parenting & Baby"

note_type · enum<integer> | null

Content type: 1=Image+text, 2=Video

Available options: 1, 2

Example:

2

content_type · enum<integer> | null

Content source: 1=Blogger partnership, 2=Celebrity partnership, 3=Employee, 5=Buyer, 6=Professional account, 11=Director, -1=User

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

Example:

1

theme · string | null

Theme name (boards 2/4/5/7/8)

Maximum string length: 64

Example:

"Unboxing"

author_type · enum<integer> | null

Board 4 only: 1=Dandelion creator, 2=celebrity

Available options: 1, 2

Example:

1

placement · enum<integer> | null

Traffic placement (boards 2/3/5/7/8): 1=Discover feed, 2=Search, 3=In-video traffic

Available options: 1, 2, 3

Example:

1

marketing_target · enum<integer> | null

Board 3 only: 3=product promotion, 8=live stream promotion

Available options: 3, 8

Example:

3

price · PriceFilter · object | null

Creator price (board 4 only)

Show child attributes

fans · RangeFilter · object | null

Creator follower count range (board 4 only)

Show child attributes

Response

200

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