xiaohongshu get_blogger_list
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 '
{
"blogger": {
"audience20": [
"自由畅行",
"自在户外 自在户外-挑战极限者"
],
"consumer_behavior": [
"内容行为预估 汽车"
],
"content_tag": [
"美妆",
"面部保养",
"面部清洁"
],
"content_theme": [
"汽车特色"
],
"feature_tags": [
"vlog"
],
"gender": "女",
"industry_crowd": [
"15795914"
],
"location": [
"上海"
],
"note_scene": [
"汽车 理性决策 选车攻略 政策"
],
"personal_tags": [
"妈妈"
],
"signed": 0
},
"brand_user_id": "5dcfa5370000000001006030",
"column": "comprehensiverank",
"coop": {
"brand_ids": [
"<string>"
],
"cpuv": {
"max": 50000,
"min": 10000
},
"estimate_cpuv": {
"max": 50000,
"min": 10000
},
"exclude_brands": true,
"imp_median": {
"max": 50000,
"min": 10000
},
"industry": "美妆个护",
"inter_median": {
"max": 50000,
"min": 10000
},
"order_count": {
"max": 50000,
"min": 10000
},
"pic_cpm": {
"max": 50000,
"min": 10000
},
"pic_engage_cost": {
"max": 50000,
"min": 10000
},
"pic_price": {
"max": 50000,
"min": 10000
},
"pic_read_price": {
"max": 50000,
"min": 10000
},
"read_median": {
"max": 50000,
"min": 10000
},
"reply_48h_ratio": {
"max": 80,
"min": 20
},
"video_cpm": {
"max": 50000,
"min": 10000
},
"video_engage_cost": {
"max": 50000,
"min": 10000
},
"video_price": {
"max": 50000,
"min": 10000
},
"video_read_price": {
"max": 50000,
"min": 10000
}
},
"fans": {
"age": 3,
"child_age": [],
"count": {
"max": 50000,
"min": 10000
},
"device_brand": [
"苹果"
],
"device_price": [
"3000-3999"
],
"gender": 2,
"location": [
"上海"
]
},
"flags": {
"activity_codes": [
"<string>"
],
"exclude_cooperated": true,
"exclude_fans_down": true,
"exclude_invited": true,
"exclude_low_active": true,
"filter_intention": true,
"high_quality": true,
"industry_first": "美妆个护",
"industry_second": "<string>",
"is_star": true,
"new_high_quality": true,
"note_and_live": true
},
"goal": {
"market_target": "mAccumImpNum"
},
"keyword": "Coffee",
"live": {
"avg_gmv": {
"max": 50000,
"min": 10000
},
"avg_viewer": {
"max": 50000,
"min": 10000
},
"live_count": {
"max": 50000,
"min": 10000
}
},
"note": {
"imp_median": {
"max": 50000,
"min": 10000
},
"inter_median": {
"max": 50000,
"min": 10000
},
"note_type": 2,
"read_median": {
"max": 50000,
"min": 10000
},
"thousand_like_percent": {
"max": 80,
"min": 20
}
},
"page_num": 1,
"page_size": 20,
"search_type": 1,
"similar_user_id": "5c668b3e0000000012021605",
"similar_word": "<string>",
"sort": "desc"
}
'import requests
url = "https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list"
payload = {
"blogger": {
"audience20": ["自由畅行", "自在户外 自在户外-挑战极限者"],
"consumer_behavior": ["内容行为预估 汽车"],
"content_tag": ["美妆", "面部保养", "面部清洁"],
"content_theme": ["汽车特色"],
"feature_tags": ["vlog"],
"gender": "女",
"industry_crowd": ["15795914"],
"location": ["上海"],
"note_scene": ["汽车 理性决策 选车攻略 政策"],
"personal_tags": ["妈妈"],
"signed": 0
},
"brand_user_id": "5dcfa5370000000001006030",
"column": "comprehensiverank",
"coop": {
"brand_ids": ["<string>"],
"cpuv": {
"max": 50000,
"min": 10000
},
"estimate_cpuv": {
"max": 50000,
"min": 10000
},
"exclude_brands": True,
"imp_median": {
"max": 50000,
"min": 10000
},
"industry": "美妆个护",
"inter_median": {
"max": 50000,
"min": 10000
},
"order_count": {
"max": 50000,
"min": 10000
},
"pic_cpm": {
"max": 50000,
"min": 10000
},
"pic_engage_cost": {
"max": 50000,
"min": 10000
},
"pic_price": {
"max": 50000,
"min": 10000
},
"pic_read_price": {
"max": 50000,
"min": 10000
},
"read_median": {
"max": 50000,
"min": 10000
},
"reply_48h_ratio": {
"max": 80,
"min": 20
},
"video_cpm": {
"max": 50000,
"min": 10000
},
"video_engage_cost": {
"max": 50000,
"min": 10000
},
"video_price": {
"max": 50000,
"min": 10000
},
"video_read_price": {
"max": 50000,
"min": 10000
}
},
"fans": {
"age": 3,
"child_age": [],
"count": {
"max": 50000,
"min": 10000
},
"device_brand": ["苹果"],
"device_price": ["3000-3999"],
"gender": 2,
"location": ["上海"]
},
"flags": {
"activity_codes": ["<string>"],
"exclude_cooperated": True,
"exclude_fans_down": True,
"exclude_invited": True,
"exclude_low_active": True,
"filter_intention": True,
"high_quality": True,
"industry_first": "美妆个护",
"industry_second": "<string>",
"is_star": True,
"new_high_quality": True,
"note_and_live": True
},
"goal": { "market_target": "mAccumImpNum" },
"keyword": "Coffee",
"live": {
"avg_gmv": {
"max": 50000,
"min": 10000
},
"avg_viewer": {
"max": 50000,
"min": 10000
},
"live_count": {
"max": 50000,
"min": 10000
}
},
"note": {
"imp_median": {
"max": 50000,
"min": 10000
},
"inter_median": {
"max": 50000,
"min": 10000
},
"note_type": 2,
"read_median": {
"max": 50000,
"min": 10000
},
"thousand_like_percent": {
"max": 80,
"min": 20
}
},
"page_num": 1,
"page_size": 20,
"search_type": 1,
"similar_user_id": "5c668b3e0000000012021605",
"similar_word": "<string>",
"sort": "desc"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
blogger: {
audience20: ['自由畅行', '自在户外 自在户外-挑战极限者'],
consumer_behavior: ['内容行为预估 汽车'],
content_tag: ['美妆', '面部保养', '面部清洁'],
content_theme: ['汽车特色'],
feature_tags: ['vlog'],
gender: '女',
industry_crowd: ['15795914'],
location: ['上海'],
note_scene: ['汽车 理性决策 选车攻略 政策'],
personal_tags: ['妈妈'],
signed: 0
},
brand_user_id: '5dcfa5370000000001006030',
column: 'comprehensiverank',
coop: {
brand_ids: ['<string>'],
cpuv: {max: 50000, min: 10000},
estimate_cpuv: {max: 50000, min: 10000},
exclude_brands: true,
imp_median: {max: 50000, min: 10000},
industry: '美妆个护',
inter_median: {max: 50000, min: 10000},
order_count: {max: 50000, min: 10000},
pic_cpm: {max: 50000, min: 10000},
pic_engage_cost: {max: 50000, min: 10000},
pic_price: {max: 50000, min: 10000},
pic_read_price: {max: 50000, min: 10000},
read_median: {max: 50000, min: 10000},
reply_48h_ratio: {max: 80, min: 20},
video_cpm: {max: 50000, min: 10000},
video_engage_cost: {max: 50000, min: 10000},
video_price: {max: 50000, min: 10000},
video_read_price: {max: 50000, min: 10000}
},
fans: {
age: 3,
child_age: [],
count: {max: 50000, min: 10000},
device_brand: ['苹果'],
device_price: ['3000-3999'],
gender: 2,
location: ['上海']
},
flags: {
activity_codes: ['<string>'],
exclude_cooperated: true,
exclude_fans_down: true,
exclude_invited: true,
exclude_low_active: true,
filter_intention: true,
high_quality: true,
industry_first: '美妆个护',
industry_second: '<string>',
is_star: true,
new_high_quality: true,
note_and_live: true
},
goal: {market_target: 'mAccumImpNum'},
keyword: 'Coffee',
live: {
avg_gmv: {max: 50000, min: 10000},
avg_viewer: {max: 50000, min: 10000},
live_count: {max: 50000, min: 10000}
},
note: {
imp_median: {max: 50000, min: 10000},
inter_median: {max: 50000, min: 10000},
note_type: 2,
read_median: {max: 50000, min: 10000},
thousand_like_percent: {max: 80, min: 20}
},
page_num: 1,
page_size: 20,
search_type: 1,
similar_user_id: '5c668b3e0000000012021605',
similar_word: '<string>',
sort: 'desc'
})
};
fetch('https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'blogger' => [
'audience20' => [
'自由畅行',
'自在户外 自在户外-挑战极限者'
],
'consumer_behavior' => [
'内容行为预估 汽车'
],
'content_tag' => [
'美妆',
'面部保养',
'面部清洁'
],
'content_theme' => [
'汽车特色'
],
'feature_tags' => [
'vlog'
],
'gender' => '女',
'industry_crowd' => [
'15795914'
],
'location' => [
'上海'
],
'note_scene' => [
'汽车 理性决策 选车攻略 政策'
],
'personal_tags' => [
'妈妈'
],
'signed' => 0
],
'brand_user_id' => '5dcfa5370000000001006030',
'column' => 'comprehensiverank',
'coop' => [
'brand_ids' => [
'<string>'
],
'cpuv' => [
'max' => 50000,
'min' => 10000
],
'estimate_cpuv' => [
'max' => 50000,
'min' => 10000
],
'exclude_brands' => true,
'imp_median' => [
'max' => 50000,
'min' => 10000
],
'industry' => '美妆个护',
'inter_median' => [
'max' => 50000,
'min' => 10000
],
'order_count' => [
'max' => 50000,
'min' => 10000
],
'pic_cpm' => [
'max' => 50000,
'min' => 10000
],
'pic_engage_cost' => [
'max' => 50000,
'min' => 10000
],
'pic_price' => [
'max' => 50000,
'min' => 10000
],
'pic_read_price' => [
'max' => 50000,
'min' => 10000
],
'read_median' => [
'max' => 50000,
'min' => 10000
],
'reply_48h_ratio' => [
'max' => 80,
'min' => 20
],
'video_cpm' => [
'max' => 50000,
'min' => 10000
],
'video_engage_cost' => [
'max' => 50000,
'min' => 10000
],
'video_price' => [
'max' => 50000,
'min' => 10000
],
'video_read_price' => [
'max' => 50000,
'min' => 10000
]
],
'fans' => [
'age' => 3,
'child_age' => [
],
'count' => [
'max' => 50000,
'min' => 10000
],
'device_brand' => [
'苹果'
],
'device_price' => [
'3000-3999'
],
'gender' => 2,
'location' => [
'上海'
]
],
'flags' => [
'activity_codes' => [
'<string>'
],
'exclude_cooperated' => true,
'exclude_fans_down' => true,
'exclude_invited' => true,
'exclude_low_active' => true,
'filter_intention' => true,
'high_quality' => true,
'industry_first' => '美妆个护',
'industry_second' => '<string>',
'is_star' => true,
'new_high_quality' => true,
'note_and_live' => true
],
'goal' => [
'market_target' => 'mAccumImpNum'
],
'keyword' => 'Coffee',
'live' => [
'avg_gmv' => [
'max' => 50000,
'min' => 10000
],
'avg_viewer' => [
'max' => 50000,
'min' => 10000
],
'live_count' => [
'max' => 50000,
'min' => 10000
]
],
'note' => [
'imp_median' => [
'max' => 50000,
'min' => 10000
],
'inter_median' => [
'max' => 50000,
'min' => 10000
],
'note_type' => 2,
'read_median' => [
'max' => 50000,
'min' => 10000
],
'thousand_like_percent' => [
'max' => 80,
'min' => 20
]
],
'page_num' => 1,
'page_size' => 20,
'search_type' => 1,
'similar_user_id' => '5c668b3e0000000012021605',
'similar_word' => '<string>',
'sort' => 'desc'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list"
payload := strings.NewReader("{\n \"blogger\": {\n \"audience20\": [\n \"自由畅行\",\n \"自在户外 自在户外-挑战极限者\"\n ],\n \"consumer_behavior\": [\n \"内容行为预估 汽车\"\n ],\n \"content_tag\": [\n \"美妆\",\n \"面部保养\",\n \"面部清洁\"\n ],\n \"content_theme\": [\n \"汽车特色\"\n ],\n \"feature_tags\": [\n \"vlog\"\n ],\n \"gender\": \"女\",\n \"industry_crowd\": [\n \"15795914\"\n ],\n \"location\": [\n \"上海\"\n ],\n \"note_scene\": [\n \"汽车 理性决策 选车攻略 政策\"\n ],\n \"personal_tags\": [\n \"妈妈\"\n ],\n \"signed\": 0\n },\n \"brand_user_id\": \"5dcfa5370000000001006030\",\n \"column\": \"comprehensiverank\",\n \"coop\": {\n \"brand_ids\": [\n \"<string>\"\n ],\n \"cpuv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"estimate_cpuv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"exclude_brands\": true,\n \"imp_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"industry\": \"美妆个护\",\n \"inter_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"order_count\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_cpm\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_engage_cost\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_read_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"read_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"reply_48h_ratio\": {\n \"max\": 80,\n \"min\": 20\n },\n \"video_cpm\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_engage_cost\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_read_price\": {\n \"max\": 50000,\n \"min\": 10000\n }\n },\n \"fans\": {\n \"age\": 3,\n \"child_age\": [],\n \"count\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"device_brand\": [\n \"苹果\"\n ],\n \"device_price\": [\n \"3000-3999\"\n ],\n \"gender\": 2,\n \"location\": [\n \"上海\"\n ]\n },\n \"flags\": {\n \"activity_codes\": [\n \"<string>\"\n ],\n \"exclude_cooperated\": true,\n \"exclude_fans_down\": true,\n \"exclude_invited\": true,\n \"exclude_low_active\": true,\n \"filter_intention\": true,\n \"high_quality\": true,\n \"industry_first\": \"美妆个护\",\n \"industry_second\": \"<string>\",\n \"is_star\": true,\n \"new_high_quality\": true,\n \"note_and_live\": true\n },\n \"goal\": {\n \"market_target\": \"mAccumImpNum\"\n },\n \"keyword\": \"Coffee\",\n \"live\": {\n \"avg_gmv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"avg_viewer\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"live_count\": {\n \"max\": 50000,\n \"min\": 10000\n }\n },\n \"note\": {\n \"imp_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"inter_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"note_type\": 2,\n \"read_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"thousand_like_percent\": {\n \"max\": 80,\n \"min\": 20\n }\n },\n \"page_num\": 1,\n \"page_size\": 20,\n \"search_type\": 1,\n \"similar_user_id\": \"5c668b3e0000000012021605\",\n \"similar_word\": \"<string>\",\n \"sort\": \"desc\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"blogger\": {\n \"audience20\": [\n \"自由畅行\",\n \"自在户外 自在户外-挑战极限者\"\n ],\n \"consumer_behavior\": [\n \"内容行为预估 汽车\"\n ],\n \"content_tag\": [\n \"美妆\",\n \"面部保养\",\n \"面部清洁\"\n ],\n \"content_theme\": [\n \"汽车特色\"\n ],\n \"feature_tags\": [\n \"vlog\"\n ],\n \"gender\": \"女\",\n \"industry_crowd\": [\n \"15795914\"\n ],\n \"location\": [\n \"上海\"\n ],\n \"note_scene\": [\n \"汽车 理性决策 选车攻略 政策\"\n ],\n \"personal_tags\": [\n \"妈妈\"\n ],\n \"signed\": 0\n },\n \"brand_user_id\": \"5dcfa5370000000001006030\",\n \"column\": \"comprehensiverank\",\n \"coop\": {\n \"brand_ids\": [\n \"<string>\"\n ],\n \"cpuv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"estimate_cpuv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"exclude_brands\": true,\n \"imp_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"industry\": \"美妆个护\",\n \"inter_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"order_count\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_cpm\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_engage_cost\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_read_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"read_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"reply_48h_ratio\": {\n \"max\": 80,\n \"min\": 20\n },\n \"video_cpm\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_engage_cost\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_read_price\": {\n \"max\": 50000,\n \"min\": 10000\n }\n },\n \"fans\": {\n \"age\": 3,\n \"child_age\": [],\n \"count\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"device_brand\": [\n \"苹果\"\n ],\n \"device_price\": [\n \"3000-3999\"\n ],\n \"gender\": 2,\n \"location\": [\n \"上海\"\n ]\n },\n \"flags\": {\n \"activity_codes\": [\n \"<string>\"\n ],\n \"exclude_cooperated\": true,\n \"exclude_fans_down\": true,\n \"exclude_invited\": true,\n \"exclude_low_active\": true,\n \"filter_intention\": true,\n \"high_quality\": true,\n \"industry_first\": \"美妆个护\",\n \"industry_second\": \"<string>\",\n \"is_star\": true,\n \"new_high_quality\": true,\n \"note_and_live\": true\n },\n \"goal\": {\n \"market_target\": \"mAccumImpNum\"\n },\n \"keyword\": \"Coffee\",\n \"live\": {\n \"avg_gmv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"avg_viewer\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"live_count\": {\n \"max\": 50000,\n \"min\": 10000\n }\n },\n \"note\": {\n \"imp_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"inter_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"note_type\": 2,\n \"read_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"thousand_like_percent\": {\n \"max\": 80,\n \"min\": 20\n }\n },\n \"page_num\": 1,\n \"page_size\": 20,\n \"search_type\": 1,\n \"similar_user_id\": \"5c668b3e0000000012021605\",\n \"similar_word\": \"<string>\",\n \"sort\": \"desc\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"blogger\": {\n \"audience20\": [\n \"自由畅行\",\n \"自在户外 自在户外-挑战极限者\"\n ],\n \"consumer_behavior\": [\n \"内容行为预估 汽车\"\n ],\n \"content_tag\": [\n \"美妆\",\n \"面部保养\",\n \"面部清洁\"\n ],\n \"content_theme\": [\n \"汽车特色\"\n ],\n \"feature_tags\": [\n \"vlog\"\n ],\n \"gender\": \"女\",\n \"industry_crowd\": [\n \"15795914\"\n ],\n \"location\": [\n \"上海\"\n ],\n \"note_scene\": [\n \"汽车 理性决策 选车攻略 政策\"\n ],\n \"personal_tags\": [\n \"妈妈\"\n ],\n \"signed\": 0\n },\n \"brand_user_id\": \"5dcfa5370000000001006030\",\n \"column\": \"comprehensiverank\",\n \"coop\": {\n \"brand_ids\": [\n \"<string>\"\n ],\n \"cpuv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"estimate_cpuv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"exclude_brands\": true,\n \"imp_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"industry\": \"美妆个护\",\n \"inter_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"order_count\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_cpm\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_engage_cost\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_read_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"read_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"reply_48h_ratio\": {\n \"max\": 80,\n \"min\": 20\n },\n \"video_cpm\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_engage_cost\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_read_price\": {\n \"max\": 50000,\n \"min\": 10000\n }\n },\n \"fans\": {\n \"age\": 3,\n \"child_age\": [],\n \"count\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"device_brand\": [\n \"苹果\"\n ],\n \"device_price\": [\n \"3000-3999\"\n ],\n \"gender\": 2,\n \"location\": [\n \"上海\"\n ]\n },\n \"flags\": {\n \"activity_codes\": [\n \"<string>\"\n ],\n \"exclude_cooperated\": true,\n \"exclude_fans_down\": true,\n \"exclude_invited\": true,\n \"exclude_low_active\": true,\n \"filter_intention\": true,\n \"high_quality\": true,\n \"industry_first\": \"美妆个护\",\n \"industry_second\": \"<string>\",\n \"is_star\": true,\n \"new_high_quality\": true,\n \"note_and_live\": true\n },\n \"goal\": {\n \"market_target\": \"mAccumImpNum\"\n },\n \"keyword\": \"Coffee\",\n \"live\": {\n \"avg_gmv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"avg_viewer\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"live_count\": {\n \"max\": 50000,\n \"min\": 10000\n }\n },\n \"note\": {\n \"imp_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"inter_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"note_type\": 2,\n \"read_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"thousand_like_percent\": {\n \"max\": 80,\n \"min\": 20\n }\n },\n \"page_num\": 1,\n \"page_size\": 20,\n \"search_type\": 1,\n \"similar_user_id\": \"5c668b3e0000000012021605\",\n \"similar_word\": \"<string>\",\n \"sort\": \"desc\"\n}"
response = http.request(request)
puts response.read_body{
"cache_message": "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_zh": "本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。",
"cache_url": "<string>",
"code": 200,
"data": "<unknown>",
"docs": "<string>",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功，本次请求将被计费。",
"params": {},
"request_id": "<string>",
"router": "",
"support": "Discord: https://discord.gg/aMEAS8Xsvz",
"time": "<string>",
"time_stamp": 123,
"time_zone": "America/Los_Angeles"
}商业
xiaohongshu get_blogger_list
蒲公英笔记博主广场（找博主
POST
https://api.aisa.one
/
apis
/
v1
/
tikhub
/
xiaohongshu
/
pgy
/
get_blogger_list
xiaohongshu get_blogger_list
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 '
{
"blogger": {
"audience20": [
"自由畅行",
"自在户外 自在户外-挑战极限者"
],
"consumer_behavior": [
"内容行为预估 汽车"
],
"content_tag": [
"美妆",
"面部保养",
"面部清洁"
],
"content_theme": [
"汽车特色"
],
"feature_tags": [
"vlog"
],
"gender": "女",
"industry_crowd": [
"15795914"
],
"location": [
"上海"
],
"note_scene": [
"汽车 理性决策 选车攻略 政策"
],
"personal_tags": [
"妈妈"
],
"signed": 0
},
"brand_user_id": "5dcfa5370000000001006030",
"column": "comprehensiverank",
"coop": {
"brand_ids": [
"<string>"
],
"cpuv": {
"max": 50000,
"min": 10000
},
"estimate_cpuv": {
"max": 50000,
"min": 10000
},
"exclude_brands": true,
"imp_median": {
"max": 50000,
"min": 10000
},
"industry": "美妆个护",
"inter_median": {
"max": 50000,
"min": 10000
},
"order_count": {
"max": 50000,
"min": 10000
},
"pic_cpm": {
"max": 50000,
"min": 10000
},
"pic_engage_cost": {
"max": 50000,
"min": 10000
},
"pic_price": {
"max": 50000,
"min": 10000
},
"pic_read_price": {
"max": 50000,
"min": 10000
},
"read_median": {
"max": 50000,
"min": 10000
},
"reply_48h_ratio": {
"max": 80,
"min": 20
},
"video_cpm": {
"max": 50000,
"min": 10000
},
"video_engage_cost": {
"max": 50000,
"min": 10000
},
"video_price": {
"max": 50000,
"min": 10000
},
"video_read_price": {
"max": 50000,
"min": 10000
}
},
"fans": {
"age": 3,
"child_age": [],
"count": {
"max": 50000,
"min": 10000
},
"device_brand": [
"苹果"
],
"device_price": [
"3000-3999"
],
"gender": 2,
"location": [
"上海"
]
},
"flags": {
"activity_codes": [
"<string>"
],
"exclude_cooperated": true,
"exclude_fans_down": true,
"exclude_invited": true,
"exclude_low_active": true,
"filter_intention": true,
"high_quality": true,
"industry_first": "美妆个护",
"industry_second": "<string>",
"is_star": true,
"new_high_quality": true,
"note_and_live": true
},
"goal": {
"market_target": "mAccumImpNum"
},
"keyword": "Coffee",
"live": {
"avg_gmv": {
"max": 50000,
"min": 10000
},
"avg_viewer": {
"max": 50000,
"min": 10000
},
"live_count": {
"max": 50000,
"min": 10000
}
},
"note": {
"imp_median": {
"max": 50000,
"min": 10000
},
"inter_median": {
"max": 50000,
"min": 10000
},
"note_type": 2,
"read_median": {
"max": 50000,
"min": 10000
},
"thousand_like_percent": {
"max": 80,
"min": 20
}
},
"page_num": 1,
"page_size": 20,
"search_type": 1,
"similar_user_id": "5c668b3e0000000012021605",
"similar_word": "<string>",
"sort": "desc"
}
'import requests
url = "https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list"
payload = {
"blogger": {
"audience20": ["自由畅行", "自在户外 自在户外-挑战极限者"],
"consumer_behavior": ["内容行为预估 汽车"],
"content_tag": ["美妆", "面部保养", "面部清洁"],
"content_theme": ["汽车特色"],
"feature_tags": ["vlog"],
"gender": "女",
"industry_crowd": ["15795914"],
"location": ["上海"],
"note_scene": ["汽车 理性决策 选车攻略 政策"],
"personal_tags": ["妈妈"],
"signed": 0
},
"brand_user_id": "5dcfa5370000000001006030",
"column": "comprehensiverank",
"coop": {
"brand_ids": ["<string>"],
"cpuv": {
"max": 50000,
"min": 10000
},
"estimate_cpuv": {
"max": 50000,
"min": 10000
},
"exclude_brands": True,
"imp_median": {
"max": 50000,
"min": 10000
},
"industry": "美妆个护",
"inter_median": {
"max": 50000,
"min": 10000
},
"order_count": {
"max": 50000,
"min": 10000
},
"pic_cpm": {
"max": 50000,
"min": 10000
},
"pic_engage_cost": {
"max": 50000,
"min": 10000
},
"pic_price": {
"max": 50000,
"min": 10000
},
"pic_read_price": {
"max": 50000,
"min": 10000
},
"read_median": {
"max": 50000,
"min": 10000
},
"reply_48h_ratio": {
"max": 80,
"min": 20
},
"video_cpm": {
"max": 50000,
"min": 10000
},
"video_engage_cost": {
"max": 50000,
"min": 10000
},
"video_price": {
"max": 50000,
"min": 10000
},
"video_read_price": {
"max": 50000,
"min": 10000
}
},
"fans": {
"age": 3,
"child_age": [],
"count": {
"max": 50000,
"min": 10000
},
"device_brand": ["苹果"],
"device_price": ["3000-3999"],
"gender": 2,
"location": ["上海"]
},
"flags": {
"activity_codes": ["<string>"],
"exclude_cooperated": True,
"exclude_fans_down": True,
"exclude_invited": True,
"exclude_low_active": True,
"filter_intention": True,
"high_quality": True,
"industry_first": "美妆个护",
"industry_second": "<string>",
"is_star": True,
"new_high_quality": True,
"note_and_live": True
},
"goal": { "market_target": "mAccumImpNum" },
"keyword": "Coffee",
"live": {
"avg_gmv": {
"max": 50000,
"min": 10000
},
"avg_viewer": {
"max": 50000,
"min": 10000
},
"live_count": {
"max": 50000,
"min": 10000
}
},
"note": {
"imp_median": {
"max": 50000,
"min": 10000
},
"inter_median": {
"max": 50000,
"min": 10000
},
"note_type": 2,
"read_median": {
"max": 50000,
"min": 10000
},
"thousand_like_percent": {
"max": 80,
"min": 20
}
},
"page_num": 1,
"page_size": 20,
"search_type": 1,
"similar_user_id": "5c668b3e0000000012021605",
"similar_word": "<string>",
"sort": "desc"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
blogger: {
audience20: ['自由畅行', '自在户外 自在户外-挑战极限者'],
consumer_behavior: ['内容行为预估 汽车'],
content_tag: ['美妆', '面部保养', '面部清洁'],
content_theme: ['汽车特色'],
feature_tags: ['vlog'],
gender: '女',
industry_crowd: ['15795914'],
location: ['上海'],
note_scene: ['汽车 理性决策 选车攻略 政策'],
personal_tags: ['妈妈'],
signed: 0
},
brand_user_id: '5dcfa5370000000001006030',
column: 'comprehensiverank',
coop: {
brand_ids: ['<string>'],
cpuv: {max: 50000, min: 10000},
estimate_cpuv: {max: 50000, min: 10000},
exclude_brands: true,
imp_median: {max: 50000, min: 10000},
industry: '美妆个护',
inter_median: {max: 50000, min: 10000},
order_count: {max: 50000, min: 10000},
pic_cpm: {max: 50000, min: 10000},
pic_engage_cost: {max: 50000, min: 10000},
pic_price: {max: 50000, min: 10000},
pic_read_price: {max: 50000, min: 10000},
read_median: {max: 50000, min: 10000},
reply_48h_ratio: {max: 80, min: 20},
video_cpm: {max: 50000, min: 10000},
video_engage_cost: {max: 50000, min: 10000},
video_price: {max: 50000, min: 10000},
video_read_price: {max: 50000, min: 10000}
},
fans: {
age: 3,
child_age: [],
count: {max: 50000, min: 10000},
device_brand: ['苹果'],
device_price: ['3000-3999'],
gender: 2,
location: ['上海']
},
flags: {
activity_codes: ['<string>'],
exclude_cooperated: true,
exclude_fans_down: true,
exclude_invited: true,
exclude_low_active: true,
filter_intention: true,
high_quality: true,
industry_first: '美妆个护',
industry_second: '<string>',
is_star: true,
new_high_quality: true,
note_and_live: true
},
goal: {market_target: 'mAccumImpNum'},
keyword: 'Coffee',
live: {
avg_gmv: {max: 50000, min: 10000},
avg_viewer: {max: 50000, min: 10000},
live_count: {max: 50000, min: 10000}
},
note: {
imp_median: {max: 50000, min: 10000},
inter_median: {max: 50000, min: 10000},
note_type: 2,
read_median: {max: 50000, min: 10000},
thousand_like_percent: {max: 80, min: 20}
},
page_num: 1,
page_size: 20,
search_type: 1,
similar_user_id: '5c668b3e0000000012021605',
similar_word: '<string>',
sort: 'desc'
})
};
fetch('https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'blogger' => [
'audience20' => [
'自由畅行',
'自在户外 自在户外-挑战极限者'
],
'consumer_behavior' => [
'内容行为预估 汽车'
],
'content_tag' => [
'美妆',
'面部保养',
'面部清洁'
],
'content_theme' => [
'汽车特色'
],
'feature_tags' => [
'vlog'
],
'gender' => '女',
'industry_crowd' => [
'15795914'
],
'location' => [
'上海'
],
'note_scene' => [
'汽车 理性决策 选车攻略 政策'
],
'personal_tags' => [
'妈妈'
],
'signed' => 0
],
'brand_user_id' => '5dcfa5370000000001006030',
'column' => 'comprehensiverank',
'coop' => [
'brand_ids' => [
'<string>'
],
'cpuv' => [
'max' => 50000,
'min' => 10000
],
'estimate_cpuv' => [
'max' => 50000,
'min' => 10000
],
'exclude_brands' => true,
'imp_median' => [
'max' => 50000,
'min' => 10000
],
'industry' => '美妆个护',
'inter_median' => [
'max' => 50000,
'min' => 10000
],
'order_count' => [
'max' => 50000,
'min' => 10000
],
'pic_cpm' => [
'max' => 50000,
'min' => 10000
],
'pic_engage_cost' => [
'max' => 50000,
'min' => 10000
],
'pic_price' => [
'max' => 50000,
'min' => 10000
],
'pic_read_price' => [
'max' => 50000,
'min' => 10000
],
'read_median' => [
'max' => 50000,
'min' => 10000
],
'reply_48h_ratio' => [
'max' => 80,
'min' => 20
],
'video_cpm' => [
'max' => 50000,
'min' => 10000
],
'video_engage_cost' => [
'max' => 50000,
'min' => 10000
],
'video_price' => [
'max' => 50000,
'min' => 10000
],
'video_read_price' => [
'max' => 50000,
'min' => 10000
]
],
'fans' => [
'age' => 3,
'child_age' => [
],
'count' => [
'max' => 50000,
'min' => 10000
],
'device_brand' => [
'苹果'
],
'device_price' => [
'3000-3999'
],
'gender' => 2,
'location' => [
'上海'
]
],
'flags' => [
'activity_codes' => [
'<string>'
],
'exclude_cooperated' => true,
'exclude_fans_down' => true,
'exclude_invited' => true,
'exclude_low_active' => true,
'filter_intention' => true,
'high_quality' => true,
'industry_first' => '美妆个护',
'industry_second' => '<string>',
'is_star' => true,
'new_high_quality' => true,
'note_and_live' => true
],
'goal' => [
'market_target' => 'mAccumImpNum'
],
'keyword' => 'Coffee',
'live' => [
'avg_gmv' => [
'max' => 50000,
'min' => 10000
],
'avg_viewer' => [
'max' => 50000,
'min' => 10000
],
'live_count' => [
'max' => 50000,
'min' => 10000
]
],
'note' => [
'imp_median' => [
'max' => 50000,
'min' => 10000
],
'inter_median' => [
'max' => 50000,
'min' => 10000
],
'note_type' => 2,
'read_median' => [
'max' => 50000,
'min' => 10000
],
'thousand_like_percent' => [
'max' => 80,
'min' => 20
]
],
'page_num' => 1,
'page_size' => 20,
'search_type' => 1,
'similar_user_id' => '5c668b3e0000000012021605',
'similar_word' => '<string>',
'sort' => 'desc'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list"
payload := strings.NewReader("{\n \"blogger\": {\n \"audience20\": [\n \"自由畅行\",\n \"自在户外 自在户外-挑战极限者\"\n ],\n \"consumer_behavior\": [\n \"内容行为预估 汽车\"\n ],\n \"content_tag\": [\n \"美妆\",\n \"面部保养\",\n \"面部清洁\"\n ],\n \"content_theme\": [\n \"汽车特色\"\n ],\n \"feature_tags\": [\n \"vlog\"\n ],\n \"gender\": \"女\",\n \"industry_crowd\": [\n \"15795914\"\n ],\n \"location\": [\n \"上海\"\n ],\n \"note_scene\": [\n \"汽车 理性决策 选车攻略 政策\"\n ],\n \"personal_tags\": [\n \"妈妈\"\n ],\n \"signed\": 0\n },\n \"brand_user_id\": \"5dcfa5370000000001006030\",\n \"column\": \"comprehensiverank\",\n \"coop\": {\n \"brand_ids\": [\n \"<string>\"\n ],\n \"cpuv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"estimate_cpuv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"exclude_brands\": true,\n \"imp_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"industry\": \"美妆个护\",\n \"inter_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"order_count\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_cpm\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_engage_cost\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_read_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"read_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"reply_48h_ratio\": {\n \"max\": 80,\n \"min\": 20\n },\n \"video_cpm\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_engage_cost\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_read_price\": {\n \"max\": 50000,\n \"min\": 10000\n }\n },\n \"fans\": {\n \"age\": 3,\n \"child_age\": [],\n \"count\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"device_brand\": [\n \"苹果\"\n ],\n \"device_price\": [\n \"3000-3999\"\n ],\n \"gender\": 2,\n \"location\": [\n \"上海\"\n ]\n },\n \"flags\": {\n \"activity_codes\": [\n \"<string>\"\n ],\n \"exclude_cooperated\": true,\n \"exclude_fans_down\": true,\n \"exclude_invited\": true,\n \"exclude_low_active\": true,\n \"filter_intention\": true,\n \"high_quality\": true,\n \"industry_first\": \"美妆个护\",\n \"industry_second\": \"<string>\",\n \"is_star\": true,\n \"new_high_quality\": true,\n \"note_and_live\": true\n },\n \"goal\": {\n \"market_target\": \"mAccumImpNum\"\n },\n \"keyword\": \"Coffee\",\n \"live\": {\n \"avg_gmv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"avg_viewer\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"live_count\": {\n \"max\": 50000,\n \"min\": 10000\n }\n },\n \"note\": {\n \"imp_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"inter_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"note_type\": 2,\n \"read_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"thousand_like_percent\": {\n \"max\": 80,\n \"min\": 20\n }\n },\n \"page_num\": 1,\n \"page_size\": 20,\n \"search_type\": 1,\n \"similar_user_id\": \"5c668b3e0000000012021605\",\n \"similar_word\": \"<string>\",\n \"sort\": \"desc\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"blogger\": {\n \"audience20\": [\n \"自由畅行\",\n \"自在户外 自在户外-挑战极限者\"\n ],\n \"consumer_behavior\": [\n \"内容行为预估 汽车\"\n ],\n \"content_tag\": [\n \"美妆\",\n \"面部保养\",\n \"面部清洁\"\n ],\n \"content_theme\": [\n \"汽车特色\"\n ],\n \"feature_tags\": [\n \"vlog\"\n ],\n \"gender\": \"女\",\n \"industry_crowd\": [\n \"15795914\"\n ],\n \"location\": [\n \"上海\"\n ],\n \"note_scene\": [\n \"汽车 理性决策 选车攻略 政策\"\n ],\n \"personal_tags\": [\n \"妈妈\"\n ],\n \"signed\": 0\n },\n \"brand_user_id\": \"5dcfa5370000000001006030\",\n \"column\": \"comprehensiverank\",\n \"coop\": {\n \"brand_ids\": [\n \"<string>\"\n ],\n \"cpuv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"estimate_cpuv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"exclude_brands\": true,\n \"imp_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"industry\": \"美妆个护\",\n \"inter_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"order_count\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_cpm\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_engage_cost\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_read_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"read_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"reply_48h_ratio\": {\n \"max\": 80,\n \"min\": 20\n },\n \"video_cpm\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_engage_cost\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_read_price\": {\n \"max\": 50000,\n \"min\": 10000\n }\n },\n \"fans\": {\n \"age\": 3,\n \"child_age\": [],\n \"count\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"device_brand\": [\n \"苹果\"\n ],\n \"device_price\": [\n \"3000-3999\"\n ],\n \"gender\": 2,\n \"location\": [\n \"上海\"\n ]\n },\n \"flags\": {\n \"activity_codes\": [\n \"<string>\"\n ],\n \"exclude_cooperated\": true,\n \"exclude_fans_down\": true,\n \"exclude_invited\": true,\n \"exclude_low_active\": true,\n \"filter_intention\": true,\n \"high_quality\": true,\n \"industry_first\": \"美妆个护\",\n \"industry_second\": \"<string>\",\n \"is_star\": true,\n \"new_high_quality\": true,\n \"note_and_live\": true\n },\n \"goal\": {\n \"market_target\": \"mAccumImpNum\"\n },\n \"keyword\": \"Coffee\",\n \"live\": {\n \"avg_gmv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"avg_viewer\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"live_count\": {\n \"max\": 50000,\n \"min\": 10000\n }\n },\n \"note\": {\n \"imp_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"inter_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"note_type\": 2,\n \"read_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"thousand_like_percent\": {\n \"max\": 80,\n \"min\": 20\n }\n },\n \"page_num\": 1,\n \"page_size\": 20,\n \"search_type\": 1,\n \"similar_user_id\": \"5c668b3e0000000012021605\",\n \"similar_word\": \"<string>\",\n \"sort\": \"desc\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"blogger\": {\n \"audience20\": [\n \"自由畅行\",\n \"自在户外 自在户外-挑战极限者\"\n ],\n \"consumer_behavior\": [\n \"内容行为预估 汽车\"\n ],\n \"content_tag\": [\n \"美妆\",\n \"面部保养\",\n \"面部清洁\"\n ],\n \"content_theme\": [\n \"汽车特色\"\n ],\n \"feature_tags\": [\n \"vlog\"\n ],\n \"gender\": \"女\",\n \"industry_crowd\": [\n \"15795914\"\n ],\n \"location\": [\n \"上海\"\n ],\n \"note_scene\": [\n \"汽车 理性决策 选车攻略 政策\"\n ],\n \"personal_tags\": [\n \"妈妈\"\n ],\n \"signed\": 0\n },\n \"brand_user_id\": \"5dcfa5370000000001006030\",\n \"column\": \"comprehensiverank\",\n \"coop\": {\n \"brand_ids\": [\n \"<string>\"\n ],\n \"cpuv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"estimate_cpuv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"exclude_brands\": true,\n \"imp_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"industry\": \"美妆个护\",\n \"inter_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"order_count\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_cpm\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_engage_cost\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"pic_read_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"read_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"reply_48h_ratio\": {\n \"max\": 80,\n \"min\": 20\n },\n \"video_cpm\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_engage_cost\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_price\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"video_read_price\": {\n \"max\": 50000,\n \"min\": 10000\n }\n },\n \"fans\": {\n \"age\": 3,\n \"child_age\": [],\n \"count\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"device_brand\": [\n \"苹果\"\n ],\n \"device_price\": [\n \"3000-3999\"\n ],\n \"gender\": 2,\n \"location\": [\n \"上海\"\n ]\n },\n \"flags\": {\n \"activity_codes\": [\n \"<string>\"\n ],\n \"exclude_cooperated\": true,\n \"exclude_fans_down\": true,\n \"exclude_invited\": true,\n \"exclude_low_active\": true,\n \"filter_intention\": true,\n \"high_quality\": true,\n \"industry_first\": \"美妆个护\",\n \"industry_second\": \"<string>\",\n \"is_star\": true,\n \"new_high_quality\": true,\n \"note_and_live\": true\n },\n \"goal\": {\n \"market_target\": \"mAccumImpNum\"\n },\n \"keyword\": \"Coffee\",\n \"live\": {\n \"avg_gmv\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"avg_viewer\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"live_count\": {\n \"max\": 50000,\n \"min\": 10000\n }\n },\n \"note\": {\n \"imp_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"inter_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"note_type\": 2,\n \"read_median\": {\n \"max\": 50000,\n \"min\": 10000\n },\n \"thousand_like_percent\": {\n \"max\": 80,\n \"min\": 20\n }\n },\n \"page_num\": 1,\n \"page_size\": 20,\n \"search_type\": 1,\n \"similar_user_id\": \"5c668b3e0000000012021605\",\n \"similar_word\": \"<string>\",\n \"sort\": \"desc\"\n}"
response = http.request(request)
puts response.read_body{
"cache_message": "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_zh": "本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。",
"cache_url": "<string>",
"code": 200,
"data": "<unknown>",
"docs": "<string>",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功，本次请求将被计费。",
"params": {},
"request_id": "<string>",
"router": "",
"support": "Discord: https://discord.gg/aMEAS8Xsvz",
"time": "<string>",
"time_stamp": 123,
"time_zone": "America/Los_Angeles"
}蒲公英笔记博主广场（找博主
计费 — 按成功调用计费，最终扣费按你的套餐倍率浮动。仅当上游响应体
code 为 200 时计费。
响应结构尚未完整文档化 —— 以实际调用为准。
示例
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 '{}' # 请求体结构见下方 schema
请求规范
- 方法与路径: POST /apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list
- 可用状态: enabled
- 请求 URL 模板: https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list
- Runtime 事实版本: 85ae03121f63417c9ff9d57a0fd59fdc6386fd71e2dc732a002843e6d8979d87
{
"operationId": "post_tikhub_xiaohongshu_pgy_get_blogger_list",
"method": "POST",
"path": "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [],
"security": [
{
"bearerAuth": []
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"blogger": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Creator attributes: categories, personas, specialty content, audience profiles, gender, location, and contract status. Fetch tree-style values from /tikhub/xiaohongshu/pgy/get_blogger_filter_options and copy their original labels verbatim. Each property explains which level or path format to use.\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).",
"properties": {
"audience20": {
"description": "Audience segments from audience20 (19 level-1 and 121 level-2 entries). Copy a level-1 name verbatim, or format a level-2 value as \"<level1> <level1>-<level2>\" with the parent name repeated. A bare level-2 label silently returns zero results. Mix levels in one array; values are combined with OR.",
"example": [
"自由畅行",
"自在户外 自在户外-挑战极限者"
],
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 30,
"title": "Audience20",
"type": [
"array",
"null"
]
},
"consumer_behavior": {
"description": "Estimated consumer behavior from the five-level consumerBehavior dictionary. Copy the full space-separated path including the root; the path may stop at any depth. A bare leaf can silently disable the filter and return unfiltered results. Compare totals with and without this filter to verify it applied. A null dictionary value means this feature is unavailable to the account.",
"example": [
"内容行为预估 汽车"
],
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 30,
"title": "Consumer Behavior",
"type": [
"array",
"null"
]
},
"content_tag": {
"description": "Creator categories from the contentTags dictionary. Copy the original category names verbatim; level-1 and level-2 names can be mixed and are combined with OR. Use a level-1 name to select the whole category; expanding all its children can miss creators tagged only at the parent level. Omit this field for unrestricted categories. Invalid names silently return zero results. This taxonomy differs from coop.industry.",
"example": [
"美妆",
"面部保养",
"面部清洁"
],
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 30,
"title": "Content Tag",
"type": [
"array",
"null"
]
},
"content_theme": {
"description": "Content theme from contentTheme in /tikhub/xiaohongshu/pgy/get_blogger_filter_options. Copy the original level-1 label verbatim. A sub-item label or numeric ID returns no results.\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).",
"example": [
"汽车特色"
],
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 30,
"title": "Content Theme",
"type": [
"array",
"null"
]
},
"feature_tags": {
"description": "Specialty content from featureTags in /tikhub/xiaohongshu/pgy/get_blogger_filter_options. Copy the original label verbatim; level-1 and level-2 names can be mixed and are combined with OR. A level-1 name selects the whole group.\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).",
"example": [
"vlog"
],
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 30,
"title": "Feature Tags",
"type": [
"array",
"null"
]
},
"gender": {
"description": "Gender. Use the literal enum values: \"男\" means male and \"女\" means female. The Chinese strings are required wire values.",
"enum": [
"男",
"女",
null
],
"example": "女",
"title": "Gender",
"type": [
"string",
"null"
]
},
"industry_crowd": {
"description": "Industry-specific audience profile: use the **deepest leaf value** from automotiveIndustryTag in `/tikhub/xiaohongshu/pgy/get_blogger_filter_options` (numeric string ID, e.g. 15795914; 1,600+ available). Using a label or intermediate-level ID returns no results.\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).",
"example": [
"15795914"
],
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 30,
"title": "Industry Crowd",
"type": [
"array",
"null"
]
},
"location": {
"description": "Creator locations from areas in /tikhub/xiaohongshu/pgy/get_blogger_filter_options. Copy the original place names verbatim, including Chinese labels. Province, city, and district names can be mixed with OR. A full space-separated path is also accepted and normalized automatically.\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).",
"example": [
"上海"
],
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 30,
"title": "Location",
"type": [
"array",
"null"
]
},
"note_scene": {
"description": "Note category from contentScenes. Copy the full space-separated path including the root; a path can stop at any depth. Using only the last segment returns zero results.",
"example": [
"汽车 理性决策 选车攻略 政策"
],
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 30,
"title": "Note Scene",
"type": [
"array",
"null"
]
},
"personal_tags": {
"description": "Creator persona from personalTagsV2 in /tikhub/xiaohongshu/pgy/get_blogger_filter_options. Copy tagName verbatim at any of the three levels (identity, group, leaf). Levels can be mixed and values are combined with OR; select a group by its name without enumerating every leaf.\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).",
"example": [
"妈妈"
],
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 30,
"title": "Personal Tags",
"type": [
"array",
"null"
]
},
"signed": {
"description": "Contract status: -1=no filter, 0=individual creator, 1=agency-signed creator",
"enum": [
-1,
0,
1,
null
],
"example": 0,
"title": "Signed",
"type": [
"integer",
"null"
]
}
},
"title": "BloggerAttrFilter",
"type": "object"
}
],
"description": "Blogger attribute filters"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Blogger attribute filters"
},
"brand_user_id": {
"description": "Optional advertiser ID; enables personalized recommendations and prior-cooperation markers.",
"example": "5dcfa5370000000001006030",
"title": "Brand User Id",
"type": [
"string",
"null"
]
},
"column": {
"default": "comprehensiverank",
"description": "Sort field; use one of the 34 enum keys in this schema. Defaults to comprehensiverank.",
"enum": [
"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",
"title": "Column",
"type": "string"
},
"coop": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Sponsored notes — the \"Sponsored Notes\" section on the web page (cooperation performance + data performance).",
"properties": {
"brand_ids": {
"description": "Recent collaboration brands: list of brand userIds",
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 20,
"title": "Brand Ids",
"type": [
"array",
"null"
]
},
"cpuv": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Reach scale — median store-visit UV count (not cost): median store-visit UV count for cross-domain collaboration notes in the last 30 days. **This is a visit count, not a monetary amount** (web tiers: 500-1000 / 1000-2000 / 2000-5000 / 5000-10000 / 10000+). To filter by cost per store visit, use estimate_cpuv instead."
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Reach scale — median store-visit UV count (not cost): median store-visit UV count for cross-domain collaboration notes in the last 30 days. **This is a visit count, not a monetary amount** (web tiers: 500-1000 / 1000-2000 / 2000-5000 / 5000-10000 / 10000+). To filter by cost per store visit, use estimate_cpuv instead."
},
"estimate_cpuv": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Overflow store-visit cost per visit"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Overflow store-visit cost per visit"
},
"exclude_brands": {
"description": "Used with brand_ids: true=exclude bloggers who have cooperated with these brands",
"title": "Exclude Brands",
"type": [
"boolean",
"null"
]
},
"imp_median": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Reach scale — median impressions (collaboration notes)"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Reach scale — median impressions (collaboration notes)"
},
"industry": {
"description": "Recent collaboration industries. Use one of the literal enum values in this schema, including required Chinese labels.",
"enum": [
"不限",
"美妆个护",
"食品饮料",
"母婴",
"3c及电器",
"日用百货",
"服装配饰",
"互联网",
"生活服务",
"家居建材",
"汽车",
null
],
"example": "美妆个护",
"title": "Industry",
"type": [
"string",
"null"
]
},
"inter_median": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Reach scale — median engagement count (collaboration notes)"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Reach scale — median engagement count (collaboration notes)"
},
"order_count": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Open orders (accepted but not yet completed), NOT lifetime collaboration count. This reflects current in-progress orders; do not use this field to find experienced creators."
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Open orders (accepted but not yet completed), NOT lifetime collaboration count. This reflects current in-progress orders; do not use this field to find experienced creators."
},
"pic_cpm": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Estimated CPM — image+text notes"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Estimated CPM — image+text notes"
},
"pic_engage_cost": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Estimated cost per engagement — image+text notes"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Estimated cost per engagement — image+text notes"
},
"pic_price": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Cooperation quote — fixed price for image+text notes (RMB)"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Cooperation quote — fixed price for image+text notes (RMB)"
},
"pic_read_price": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Estimated cost per read — image+text notes"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Estimated cost per read — image+text notes"
},
"read_median": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Reach scale — median reads (collaboration notes)"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Reach scale — median reads (collaboration notes)"
},
"reply_48h_ratio": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Percentage range: enter a value between 0 and 100 as a percentile, e.g. `40` means 40% (**not 0.4**).\n\nThis convention follows the PGY web interface: the tier for notes-per-thousand-likes is written as `{\"40% and above\": [40, null]}` or `{\"below 10%\": [null, 10]}` — the value sent upstream is simply 40 or 10.\n\n**What is and is not validated — stated clearly to avoid confusion**:\n* Caught: values with the wrong order of magnitude — entering 200 or 9500 (as if using parts-per-ten-thousand or raw counts) will return a 422 error, whereas the generic RangeFilter allows up to 1e12 and previously passed such values through.\n* **Not caught: values that are too small** — entering 0.4 is still valid because 0.4% is a legitimate value; the type system cannot distinguish \"meant 40% but wrote 0.4\" from \"genuinely filtering for 0.4%\". This ambiguity can only be resolved through field documentation.",
"properties": {
"max": {
"description": "Maximum value (inclusive), percentile 0-100",
"example": 80,
"maximum": 100.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive), percentile 0-100",
"example": 20,
"maximum": 100.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "PercentRange",
"type": "object"
}
],
"description": "Cooperation credit — 48h invitation reply rate: fill 0-100 percent points (80 means 80%)"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Cooperation credit — 48h invitation reply rate: fill 0-100 percent points (80 means 80%)"
},
"video_cpm": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Estimated CPM — video notes"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Estimated CPM — video notes"
},
"video_engage_cost": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Estimated cost per engagement — video notes"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Estimated cost per engagement — video notes"
},
"video_price": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Cooperation quote — fixed price for video notes (RMB)"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Cooperation quote — fixed price for video notes (RMB)"
},
"video_read_price": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Estimated cost per read — video notes"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Estimated cost per read — video notes"
}
},
"title": "CoopFilter",
"type": "object"
}
],
"description": "Sponsored note metric filters"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Sponsored note metric filters"
},
"fans": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Audience profile — the \"Audience Profile\" section of the web page (follower count / age / gender / region / relationship status / spending / parenting & baby / mobile device).",
"properties": {
"age": {
"description": "Audience age distribution: 0=no filter, 1=under 18, 2=18-24, 3=25-34, 4=35-44, 5=over 44 (high proportion)",
"enum": [
0,
1,
2,
3,
4,
5,
null
],
"example": 3,
"title": "Age",
"type": [
"integer",
"null"
]
},
"child_age": {
"description": "Parenting stage: 0=trying to conceive, 2=0-6 months, 3=7-12 months, 4=1-3 years, 5=4-6 years, 6=7-12 years, 7=early pregnancy, 8=late pregnancy",
"items": {
"enum": [
0,
2,
3,
4,
5,
6,
7,
8
],
"type": "integer"
},
"maxItems": 30,
"title": "Child Age",
"type": [
"array",
"null"
]
},
"consumption_level": {
"description": "Consumption level: -1=no filter, 0=low, 1=medium, 2=high",
"enum": [
-1,
0,
1,
2,
null
],
"title": "Consumption Level",
"type": [
"integer",
"null"
]
},
"count": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Follower count range"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Follower count range"
},
"device_brand": {
"description": "Audience phone brands. Copy the literal enum values in items.enum, including Chinese brand names; do not translate them.",
"example": [
"苹果"
],
"items": {
"enum": [
"苹果",
"华为",
"OPPO",
"VIVO",
"荣耀",
"小米",
"一加",
"魅族",
"中兴",
"联想"
],
"type": "string"
},
"maxItems": 30,
"title": "Device Brand",
"type": [
"array",
"null"
]
},
"device_price": {
"description": "Phone price tier, e.g. 3000-3999 / 8000+",
"example": [
"3000-3999"
],
"items": {
"enum": [
"0-999",
"1000-1999",
"2000-2999",
"3000-3999",
"4000-4999",
"5000-5999",
"6000-6999",
"7000-7999",
"8000+"
],
"type": "string"
},
"maxItems": 30,
"title": "Device Price",
"type": [
"array",
"null"
]
},
"gender": {
"description": "Audience gender: 0=no filter, 1=predominantly male, 2=predominantly female",
"enum": [
0,
1,
2,
null
],
"example": 2,
"title": "Gender",
"type": [
"integer",
"null"
]
},
"location": {
"description": "Audience locations from fansAreas in /tikhub/xiaohongshu/pgy/get_blogger_filter_options. Copy the original Chinese place names or full space-separated paths verbatim; the tree ends at city level and has no districts. Plain names are normalized into full paths automatically.\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).",
"example": [
"上海"
],
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 30,
"title": "Location",
"type": [
"array",
"null"
]
},
"marital_status": {
"description": "Relationship status: -1=no filter, 0=single/unmarried, 1=married",
"enum": [
-1,
0,
1,
null
],
"title": "Marital Status",
"type": [
"integer",
"null"
]
}
},
"title": "FansFilter",
"type": "object"
}
],
"description": "Fans profile filters"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Fans profile filters"
},
"flags": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Boolean flags — controls the \"Platform Recommendations\" (featured bloggers / trending campaigns) and \"Standard Exclusions\" (one-click exclude) sections on the web page.",
"properties": {
"activity_codes": {
"description": "Trending activity: use the `code` value for each item in the activities list from `/tikhub/xiaohongshu/pgy/get_blogger_filter_options`\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).",
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 30,
"title": "Activity Codes",
"type": [
"array",
"null"
]
},
"exclude_cooperated": {
"description": "Exclude previously collaborated creators",
"title": "Exclude Cooperated",
"type": [
"boolean",
"null"
]
},
"exclude_fans_down": {
"description": "Exclude creators with declining followers",
"title": "Exclude Fans Down",
"type": [
"boolean",
"null"
]
},
"exclude_invited": {
"description": "Exclude already-invited creators",
"title": "Exclude Invited",
"type": [
"boolean",
"null"
]
},
"exclude_low_active": {
"description": "Exclude low-activity creators",
"title": "Exclude Low Active",
"type": [
"boolean",
"null"
]
},
"filter_intention": {
"description": "Intended industry match",
"title": "Filter Intention",
"type": [
"boolean",
"null"
]
},
"high_quality": {
"description": "Quality creator",
"title": "High Quality",
"type": [
"boolean",
"null"
]
},
"industry_first": {
"description": "Industry-recommended creators — level-1 industry name (e.g. Beauty & Personal Care); the platform will recommend creators specializing in that industry",
"example": "美妆个护",
"maxLength": 64,
"title": "Industry First",
"type": [
"string",
"null"
]
},
"industry_second": {
"description": "Industry-recommended creators — level-2 industry name (used together with industry_first; values from taxonomy2Tags in industryTags in `/tikhub/xiaohongshu/pgy/get_blogger_filter_options`)\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).",
"maxLength": 64,
"title": "Industry Second",
"type": [
"string",
"null"
]
},
"is_star": {
"description": "Celebrity",
"title": "Is Star",
"type": [
"boolean",
"null"
]
},
"new_high_quality": {
"description": "Rising creator",
"title": "New High Quality",
"type": [
"boolean",
"null"
]
},
"note_and_live": {
"description": "Both notes and live streams available for collaboration",
"title": "Note And Live",
"type": [
"boolean",
"null"
]
}
},
"title": "FlagFilter",
"type": "object"
}
],
"description": "Boolean flag filters"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Boolean flag filters"
},
"goal": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Cooperation goal: match bloggers by marketing objective (Exposure / Seeding / Conversion).\n\nTo filter bloggers by audience segment, use `BloggerAttrFilter.audience20` (top-20 audiences).",
"properties": {
"market_target": {
"description": "Marketing objective: on the web UI this is a three-level selector (objective -> metric -> measurement method); pass the final leaf code: `estimateAllCpm` Awareness/Impression Performance/Cost, `mAccumImpNum` Awareness/Impression Performance/Scale, `readCost` Awareness/Read Performance/Cost, `mValidRawReadFeedNum` Awareness/Read Performance/Scale, `estimateEngageCost` Consideration/Engagement Performance/Cost, `mEngagementNum90d` Consideration/Engagement Performance/Scale, `estimateCpuv` Conversion/Overflow Store-Visit Performance/Cost, `mCpuvNum` Conversion/Overflow Store-Visit Performance/Scale",
"enum": [
"estimateAllCpm",
"mAccumImpNum",
"readCost",
"mValidRawReadFeedNum",
"estimateEngageCost",
"mEngagementNum90d",
"estimateCpuv",
"mCpuvNum",
null
],
"example": "mAccumImpNum",
"title": "Market Target",
"type": [
"string",
"null"
]
}
},
"title": "GoalFilter",
"type": "object"
}
],
"description": "Cooperation goal filters"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Cooperation goal filters"
},
"keyword": {
"default": "",
"description": "Search keyword; leave empty to filter without a text search.",
"example": "Coffee",
"maxLength": 50,
"title": "Keyword",
"type": "string"
},
"live": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Live data — the \"Live Data\" section of the web page.",
"properties": {
"avg_gmv": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Average GMV per live stream over the last 90 days (live_count uses a 30-day window instead)."
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Average GMV per live stream over the last 90 days (live_count uses a 30-day window instead)."
},
"avg_viewer": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Average viewers per live stream over the last 90 days (live_count uses a 30-day window instead)."
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Average viewers per live stream over the last 90 days (live_count uses a 30-day window instead)."
},
"live_count": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Number of live streams in the last 30 days"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Number of live streams in the last 30 days"
}
},
"title": "LiveFilter",
"type": "object"
}
],
"description": "Live metric filters"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Live metric filters"
},
"note": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Organic note data — the 'Daily Notes' section on the web page (organic traffic performance over the last 30 days).",
"properties": {
"imp_median": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Median impressions"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Median impressions"
},
"inter_median": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Median engagement count"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Median engagement count"
},
"note_type": {
"description": "Note type: 0=no filter, 1=primarily image+text notes, 2=primarily video notes",
"enum": [
0,
1,
2,
null
],
"example": 2,
"title": "Note Type",
"type": [
"integer",
"null"
]
},
"read_median": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422",
"properties": {
"max": {
"description": "Maximum value (inclusive); omit for no upper limit",
"example": 50000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive)",
"example": 10000,
"maximum": 1000000000000.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "RangeFilter",
"type": "object"
}
],
"description": "Median reads"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Median reads"
},
"thousand_like_percent": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": false,
"description": "Percentage range: enter a value between 0 and 100 as a percentile, e.g. `40` means 40% (**not 0.4**).\n\nThis convention follows the PGY web interface: the tier for notes-per-thousand-likes is written as `{\"40% and above\": [40, null]}` or `{\"below 10%\": [null, 10]}` — the value sent upstream is simply 40 or 10.\n\n**What is and is not validated — stated clearly to avoid confusion**:\n* Caught: values with the wrong order of magnitude — entering 200 or 9500 (as if using parts-per-ten-thousand or raw counts) will return a 422 error, whereas the generic RangeFilter allows up to 1e12 and previously passed such values through.\n* **Not caught: values that are too small** — entering 0.4 is still valid because 0.4% is a legitimate value; the type system cannot distinguish \"meant 40% but wrote 0.4\" from \"genuinely filtering for 0.4%\". This ambiguity can only be resolved through field documentation.",
"properties": {
"max": {
"description": "Maximum value (inclusive), percentile 0-100",
"example": 80,
"maximum": 100.0,
"minimum": 0.0,
"title": "Max",
"type": [
"number",
"null"
]
},
"min": {
"description": "Minimum value (inclusive), percentile 0-100",
"example": 20,
"maximum": 100.0,
"minimum": 0.0,
"title": "Min",
"type": [
"number",
"null"
]
}
},
"title": "PercentRange",
"type": "object"
}
],
"description": "1,000-like note ratio: fill 0-100 percent points (20 means 20%, not 0.2)"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "1,000-like note ratio: fill 0-100 percent points (20 means 20%, not 0.2)"
}
},
"title": "NoteFilter",
"type": "object"
}
],
"description": "Organic note metric filters"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Organic note metric filters"
},
"page_num": {
"default": 1,
"description": "Page, 1-250",
"example": 1,
"maximum": 250.0,
"minimum": 1.0,
"title": "Page Num",
"type": "integer"
},
"page_size": {
"default": 20,
"description": "Page size, 1-20 (web fixed at 20; recommended: keep at 20)",
"example": 20,
"maximum": 20.0,
"minimum": 1.0,
"title": "Page Size",
"type": "integer"
},
"search_type": {
"default": 1,
"description": "1=search by note keyword (default); 0=search by creator nickname.",
"enum": [
0,
1
],
"example": 1,
"title": "Search Type",
"type": "integer"
},
"similar_user_id": {
"description": "Creator userId for similar-creator search. Supports all other filters, unlike /tikhub/xiaohongshu/pgy/get_blogger_similar.\n\nAPI references: `get_blogger_similar` = `POST /tikhub/xiaohongshu/pgy/get_blogger_similar` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_similar`).",
"example": "5c668b3e0000000012021605",
"title": "Similar User Id",
"type": [
"string",
"null"
]
},
"similar_word": {
"description": "Nickname echo for similar_user_id; does not affect results",
"maxLength": 64,
"title": "Similar Word",
"type": [
"string",
"null"
]
},
"sort": {
"default": "desc",
"description": "Sort direction: desc (default) or asc.",
"enum": [
"desc",
"asc"
],
"example": "desc",
"title": "Sort",
"type": "string"
}
},
"title": "BloggerListReq",
"type": "object"
}
}
},
"required": true
},
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"cost_contract": "fixed_success",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.02,
"estimate_source": "profile_seed",
"evidence_source": "request_snapshot"
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
费用与请求规则
公开参考价格：每次成功请求 $0.02 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。- 默认请求参考估价（USD）: 0.02
- 计费依据: fixed_success
- 公开参考倍率: 1.0
- 结算证据来源: request_snapshot
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
application/json
Blogger attribute filters
Show child attributes
Show child attributes
Optional advertiser ID; enables personalized recommendations and prior-cooperation markers.
示例:
"5dcfa5370000000001006030"
Sort field; use one of the 34 enum keys in this schema. Defaults to comprehensiverank.
可用选项:
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 示例:
"comprehensiverank"
Sponsored note metric filters
Show child attributes
Show child attributes
Fans profile filters
Show child attributes
Show child attributes
Boolean flag filters
Show child attributes
Show child attributes
Cooperation goal filters
Show child attributes
Show child attributes
Search keyword; leave empty to filter without a text search.
Maximum string length:
50示例:
"Coffee"
Live metric filters
Show child attributes
Show child attributes
Organic note metric filters
Show child attributes
Show child attributes
Page, 1-250
必填范围:
1 <= x <= 250示例:
1
Page size, 1-20 (web fixed at 20; recommended: keep at 20)
必填范围:
1 <= x <= 20示例:
20
1=search by note keyword (default); 0=search by creator nickname.
可用选项:
0, 1 示例:
1
Creator userId for similar-creator search. Supports all other filters, unlike /tikhub/xiaohongshu/pgy/get_blogger_similar.
API references: get_blogger_similar = POST /tikhub/xiaohongshu/pgy/get_blogger_similar (operationId: post_tikhub_xiaohongshu_pgy_get_blogger_similar).
示例:
"5c668b3e0000000012021605"
Nickname echo for similar_user_id; does not affect results
Maximum string length:
64Sort direction: desc (default) or asc.
可用选项:
desc, asc 示例:
"desc"
响应
Successful response. The outer object follows ResponseModel; the endpoint-specific payload is in data.
Return and response access
The raw upstream envelope is in response.data; its payload is one level deeper at response.data.data. The payload contains kols[] (matched creators), total (paging cap, always 5000), trackId, and highlightWords. Each kols item includes identity fields userId, name, redId, headPhoto, location, and gender; tags contentTags, featureTags, personalTags, and tradeType; metrics fansNum, clickMidNum, interMidNum, fans30GrowthRate, and kliveCnt30d; and commercial fields picturePrice, videoPrice, lowerPrice, estimatePictureCpm, and cooperateState. Inspect these fields before making additional detail calls. Misspelled request field names return HTTP 422.
cache_message
string | null
默认值: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
默认值:本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。
Cache message (ZH-CN)
The URL to access the cached result
HTTP 状态码
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.
Link to the API Swagger documentation for this endpoint
Response message (EN-US)
Response message (ZH-CN)
The parameters used in the request
Unique request identifier
The endpoint that generated this response
Support message
The time the response was generated
The timestamp the response was generated
The timezone of the response time