PGY note blogger square

PGY note blogger square

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

PGY note blogger square

cURL

curl --request POST \
  --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "page_num": 1,
  "page_size": 20,
  "keyword": "Coffee",
  "search_type": 1,
  "column": "comprehensiverank",
  "sort": "desc",
  "brand_user_id": "5dcfa5370000000001006030",
  "similar_user_id": "5c668b3e0000000012021605",
  "similar_word": "<string>",
  "goal": {
    "market_target": "mAccumImpNum"
  },
  "blogger": {
    "content_tag": [
      "Beauty",
      "Facial Care",
      "Facial Cleanser"
    ],
    "personal_tags": [
      "Mother"
    ],
    "feature_tags": [
      "vlog"
    ],
    "content_theme": [
      "Automotive Features"
    ],
    "audience20": [
      "Free Travel",
      "Outdoor Freedom - Extreme Challengers"
    ],
    "industry_crowd": [
      "15795914"
    ],
    "consumer_behavior": [
      "Content behavior estimate: Automotive"
    ],
    "note_scene": [
      "Automotive: Rational Decision-Making, Car Selection Guide, Policy"
    ],
    "gender": "Female",
    "location": [
      "Shanghai"
    ],
    "signed": 0
  },
  "fans": {
    "count": {
      "min": 10000,
      "max": 50000
    },
    "age": 3,
    "gender": 2,
    "child_age": [],
    "device_price": [
      "3000-3999"
    ],
    "device_brand": [
      "Apple"
    ],
    "location": [
      "Shanghai"
    ]
  },
  "note": {
    "imp_median": {
      "min": 10000,
      "max": 50000
    },
    "read_median": {
      "min": 10000,
      "max": 50000
    },
    "inter_median": {
      "min": 10000,
      "max": 50000
    },
    "thousand_like_percent": {
      "min": 20,
      "max": 80
    },
    "note_type": 2
  },
  "coop": {
    "pic_price": {
      "min": 10000,
      "max": 50000
    },
    "video_price": {
      "min": 10000,
      "max": 50000
    },
    "order_count": {
      "min": 10000,
      "max": 50000
    },
    "reply_48h_ratio": {
      "min": 20,
      "max": 80
    },
    "industry": "Beauty & Personal Care",
    "brand_ids": [
      "<string>"
    ],
    "exclude_brands": true,
    "imp_median": {
      "min": 10000,
      "max": 50000
    },
    "read_median": {
      "min": 10000,
      "max": 50000
    },
    "inter_median": {
      "min": 10000,
      "max": 50000
    },
    "cpuv": {
      "min": 10000,
      "max": 50000
    },
    "pic_cpm": {
      "min": 10000,
      "max": 50000
    },
    "video_cpm": {
      "min": 10000,
      "max": 50000
    },
    "pic_read_price": {
      "min": 10000,
      "max": 50000
    },
    "video_read_price": {
      "min": 10000,
      "max": 50000
    },
    "pic_engage_cost": {
      "min": 10000,
      "max": 50000
    },
    "video_engage_cost": {
      "min": 10000,
      "max": 50000
    },
    "estimate_cpuv": {
      "min": 10000,
      "max": 50000
    }
  },
  "live": {
    "live_count": {
      "min": 10000,
      "max": 50000
    },
    "avg_viewer": {
      "min": 10000,
      "max": 50000
    },
    "avg_gmv": {
      "min": 10000,
      "max": 50000
    }
  },
  "flags": {
    "is_star": true,
    "new_high_quality": true,
    "high_quality": true,
    "note_and_live": true,
    "filter_intention": true,
    "activity_codes": [
      "<string>"
    ],
    "exclude_low_active": true,
    "exclude_fans_down": true,
    "exclude_cooperated": true,
    "exclude_invited": true,
    "industry_first": "Beauty & Personal Care",
    "industry_second": "<string>"
  }
}
'

PGY note blogger square

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_blogger_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

page_num · integer · default: 1

Page, 1-250

Required range: 1 <= x <= 250

Example:

1

page_size · integer · default: 20

Page size, 1-20 (web fixed at 20; recommended: keep at 20)

Required range: 1 <= x <= 20

Example:

20

keyword · string · default: ""

Keyword; empty=filter only, no search

Maximum string length: 50

Example:

"Coffee"

search_type · enum<integer> · default: 1

1=search bloggers by note keyword (default), 0=search by nickname

Available options: 0, 1

Example:

1

column · enum<string> · default: comprehensiverank

Sort column, 34 options, see endpoint docs

Available options: comprehensiverank, fansCount, price, clickNum, mEngagementNum, accumCommonImpMedinNum30d, accumPicCommonImpMedinNum30d, accumVideoCommonImpMedinNum30d, pictureClickMidNum, videoClickMidNum, pictureInterMidNum, videoInterMidNum, thousandLikePercent30, pictureThousandLikePercent30, videoThousandLikePercent30, hundredLikePercent30, pictureHundredLikePercent30, videoHundredLikePercent30, videoFinishRate, accumCoopImpMedinNum30d, readMidCoop30, interMidCoop30, mCpuvNum30d, picturePrice, videoPrice, pictureReadCost, videoReadCost, inviteReply48hNumRatio, fans30GrowthRate, fansActiveIn28dLv, fansEngageNum30dLv, kliveCnt30d, avgLiveViewerNum, avgAgmv90d

Example:

"comprehensiverank"

sort · enum<string> · default: desc

Sort direction: desc/asc

Available options: desc, asc

Example:

"desc"

brand_user_id · string | null

Brand/advertiser user ID, optional

Example:

"5dcfa5370000000001006030"

similar_user_id · string | null

Find similar bloggers; unlike /get_blogger_similar it can be combined with all filters below

Example:

"5c668b3e0000000012021605"

similar_word · string | null

Nickname echo for similar_user_id; does not affect results

Maximum string length: 64

goal · GoalFilter · object | null

Cooperation goal filters

Show child attributes

blogger · BloggerAttrFilter · object | null

Blogger attribute filters

Show child attributes

fans · FansFilter · object | null

Fans profile filters

Show child attributes

note · NoteFilter · object | null

Organic note metric filters

Show child attributes

coop · CoopFilter · object | null

Sponsored note metric filters

Show child attributes

live · LiveFilter · object | null

Live metric filters

Show child attributes

flags · FlagFilter · object | null

Boolean flag filters

Show child attributes

Response

200

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