xiaohongshu get_live_blogger_list

curl --request POST \
  --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_live_blogger_list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "buyer": {
    "group_tag": [
      "<string>"
    ],
    "persona_tag": [
      "<string>"
    ]
  },
  "category": {
    "first": [
      "<string>"
    ],
    "second": [
      "<string>"
    ]
  },
  "ecom": {
    "atv": {
      "max": 500000000000,
      "min": 500000000000
    },
    "avg_gmv": {
      "max": 500000000000,
      "min": 500000000000
    },
    "brand_avg_gmv": {
      "max": 500000000000,
      "min": 500000000000
    }
  },
  "fans": {
    "consumption": [],
    "count": {
      "max": 500000000000,
      "min": 500000000000
    }
  },
  "flags": {
    "actively_seeking": true,
    "contact_visible": true,
    "cooperated_before": true,
    "daily_buyer": true,
    "follower": true,
    "following": true,
    "high_reply_rate": true,
    "is_star": true,
    "live_potential_high": true
  },
  "live": {
    "avg_viewer": {
      "max": 500000000000,
      "min": 500000000000
    },
    "has_plan": true,
    "max_online": {
      "max": 500000000000,
      "min": 500000000000
    },
    "plan_days": [
      "<string>"
    ]
  },
  "nick_name": "Li",
  "page_num": 1,
  "page_size": 20,
  "seed": 0
}
'

import requests

url = "https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_live_blogger_list"

payload = {
    "buyer": {
        "group_tag": ["<string>"],
        "persona_tag": ["<string>"]
    },
    "category": {
        "first": ["<string>"],
        "second": ["<string>"]
    },
    "ecom": {
        "atv": {
            "max": 500000000000,
            "min": 500000000000
        },
        "avg_gmv": {
            "max": 500000000000,
            "min": 500000000000
        },
        "brand_avg_gmv": {
            "max": 500000000000,
            "min": 500000000000
        }
    },
    "fans": {
        "consumption": [],
        "count": {
            "max": 500000000000,
            "min": 500000000000
        }
    },
    "flags": {
        "actively_seeking": True,
        "contact_visible": True,
        "cooperated_before": True,
        "daily_buyer": True,
        "follower": True,
        "following": True,
        "high_reply_rate": True,
        "is_star": True,
        "live_potential_high": True
    },
    "live": {
        "avg_viewer": {
            "max": 500000000000,
            "min": 500000000000
        },
        "has_plan": True,
        "max_online": {
            "max": 500000000000,
            "min": 500000000000
        },
        "plan_days": ["<string>"]
    },
    "nick_name": "Li",
    "page_num": 1,
    "page_size": 20,
    "seed": 0
}
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({
    buyer: {group_tag: ['<string>'], persona_tag: ['<string>']},
    category: {first: ['<string>'], second: ['<string>']},
    ecom: {
      atv: {max: 500000000000, min: 500000000000},
      avg_gmv: {max: 500000000000, min: 500000000000},
      brand_avg_gmv: {max: 500000000000, min: 500000000000}
    },
    fans: {consumption: [], count: {max: 500000000000, min: 500000000000}},
    flags: {
      actively_seeking: true,
      contact_visible: true,
      cooperated_before: true,
      daily_buyer: true,
      follower: true,
      following: true,
      high_reply_rate: true,
      is_star: true,
      live_potential_high: true
    },
    live: {
      avg_viewer: {max: 500000000000, min: 500000000000},
      has_plan: true,
      max_online: {max: 500000000000, min: 500000000000},
      plan_days: ['<string>']
    },
    nick_name: 'Li',
    page_num: 1,
    page_size: 20,
    seed: 0
  })
};

fetch('https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_live_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_live_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([
    'buyer' => [
        'group_tag' => [
                '<string>'
        ],
        'persona_tag' => [
                '<string>'
        ]
    ],
    'category' => [
        'first' => [
                '<string>'
        ],
        'second' => [
                '<string>'
        ]
    ],
    'ecom' => [
        'atv' => [
                'max' => 500000000000,
                'min' => 500000000000
        ],
        'avg_gmv' => [
                'max' => 500000000000,
                'min' => 500000000000
        ],
        'brand_avg_gmv' => [
                'max' => 500000000000,
                'min' => 500000000000
        ]
    ],
    'fans' => [
        'consumption' => [
                
        ],
        'count' => [
                'max' => 500000000000,
                'min' => 500000000000
        ]
    ],
    'flags' => [
        'actively_seeking' => true,
        'contact_visible' => true,
        'cooperated_before' => true,
        'daily_buyer' => true,
        'follower' => true,
        'following' => true,
        'high_reply_rate' => true,
        'is_star' => true,
        'live_potential_high' => true
    ],
    'live' => [
        'avg_viewer' => [
                'max' => 500000000000,
                'min' => 500000000000
        ],
        'has_plan' => true,
        'max_online' => [
                'max' => 500000000000,
                'min' => 500000000000
        ],
        'plan_days' => [
                '<string>'
        ]
    ],
    'nick_name' => 'Li',
    'page_num' => 1,
    'page_size' => 20,
    'seed' => 0
  ]),
  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_live_blogger_list"

	payload := strings.NewReader("{\n  \"buyer\": {\n    \"group_tag\": [\n      \"<string>\"\n    ],\n    \"persona_tag\": [\n      \"<string>\"\n    ]\n  },\n  \"category\": {\n    \"first\": [\n      \"<string>\"\n    ],\n    \"second\": [\n      \"<string>\"\n    ]\n  },\n  \"ecom\": {\n    \"atv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"avg_gmv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"brand_avg_gmv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    }\n  },\n  \"fans\": {\n    \"consumption\": [],\n    \"count\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    }\n  },\n  \"flags\": {\n    \"actively_seeking\": true,\n    \"contact_visible\": true,\n    \"cooperated_before\": true,\n    \"daily_buyer\": true,\n    \"follower\": true,\n    \"following\": true,\n    \"high_reply_rate\": true,\n    \"is_star\": true,\n    \"live_potential_high\": true\n  },\n  \"live\": {\n    \"avg_viewer\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"has_plan\": true,\n    \"max_online\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"plan_days\": [\n      \"<string>\"\n    ]\n  },\n  \"nick_name\": \"Li\",\n  \"page_num\": 1,\n  \"page_size\": 20,\n  \"seed\": 0\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_live_blogger_list")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"buyer\": {\n    \"group_tag\": [\n      \"<string>\"\n    ],\n    \"persona_tag\": [\n      \"<string>\"\n    ]\n  },\n  \"category\": {\n    \"first\": [\n      \"<string>\"\n    ],\n    \"second\": [\n      \"<string>\"\n    ]\n  },\n  \"ecom\": {\n    \"atv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"avg_gmv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"brand_avg_gmv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    }\n  },\n  \"fans\": {\n    \"consumption\": [],\n    \"count\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    }\n  },\n  \"flags\": {\n    \"actively_seeking\": true,\n    \"contact_visible\": true,\n    \"cooperated_before\": true,\n    \"daily_buyer\": true,\n    \"follower\": true,\n    \"following\": true,\n    \"high_reply_rate\": true,\n    \"is_star\": true,\n    \"live_potential_high\": true\n  },\n  \"live\": {\n    \"avg_viewer\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"has_plan\": true,\n    \"max_online\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"plan_days\": [\n      \"<string>\"\n    ]\n  },\n  \"nick_name\": \"Li\",\n  \"page_num\": 1,\n  \"page_size\": 20,\n  \"seed\": 0\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_live_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  \"buyer\": {\n    \"group_tag\": [\n      \"<string>\"\n    ],\n    \"persona_tag\": [\n      \"<string>\"\n    ]\n  },\n  \"category\": {\n    \"first\": [\n      \"<string>\"\n    ],\n    \"second\": [\n      \"<string>\"\n    ]\n  },\n  \"ecom\": {\n    \"atv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"avg_gmv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"brand_avg_gmv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    }\n  },\n  \"fans\": {\n    \"consumption\": [],\n    \"count\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    }\n  },\n  \"flags\": {\n    \"actively_seeking\": true,\n    \"contact_visible\": true,\n    \"cooperated_before\": true,\n    \"daily_buyer\": true,\n    \"follower\": true,\n    \"following\": true,\n    \"high_reply_rate\": true,\n    \"is_star\": true,\n    \"live_potential_high\": true\n  },\n  \"live\": {\n    \"avg_viewer\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"has_plan\": true,\n    \"max_online\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"plan_days\": [\n      \"<string>\"\n    ]\n  },\n  \"nick_name\": \"Li\",\n  \"page_num\": 1,\n  \"page_size\": 20,\n  \"seed\": 0\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"
}

POST

https://api.aisa.one

apis

tikhub

xiaohongshu

pgy

get_live_blogger_list

xiaohongshu get_live_blogger_list

curl --request POST \
  --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_live_blogger_list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "buyer": {
    "group_tag": [
      "<string>"
    ],
    "persona_tag": [
      "<string>"
    ]
  },
  "category": {
    "first": [
      "<string>"
    ],
    "second": [
      "<string>"
    ]
  },
  "ecom": {
    "atv": {
      "max": 500000000000,
      "min": 500000000000
    },
    "avg_gmv": {
      "max": 500000000000,
      "min": 500000000000
    },
    "brand_avg_gmv": {
      "max": 500000000000,
      "min": 500000000000
    }
  },
  "fans": {
    "consumption": [],
    "count": {
      "max": 500000000000,
      "min": 500000000000
    }
  },
  "flags": {
    "actively_seeking": true,
    "contact_visible": true,
    "cooperated_before": true,
    "daily_buyer": true,
    "follower": true,
    "following": true,
    "high_reply_rate": true,
    "is_star": true,
    "live_potential_high": true
  },
  "live": {
    "avg_viewer": {
      "max": 500000000000,
      "min": 500000000000
    },
    "has_plan": true,
    "max_online": {
      "max": 500000000000,
      "min": 500000000000
    },
    "plan_days": [
      "<string>"
    ]
  },
  "nick_name": "Li",
  "page_num": 1,
  "page_size": 20,
  "seed": 0
}
'

import requests

url = "https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_live_blogger_list"

payload = {
    "buyer": {
        "group_tag": ["<string>"],
        "persona_tag": ["<string>"]
    },
    "category": {
        "first": ["<string>"],
        "second": ["<string>"]
    },
    "ecom": {
        "atv": {
            "max": 500000000000,
            "min": 500000000000
        },
        "avg_gmv": {
            "max": 500000000000,
            "min": 500000000000
        },
        "brand_avg_gmv": {
            "max": 500000000000,
            "min": 500000000000
        }
    },
    "fans": {
        "consumption": [],
        "count": {
            "max": 500000000000,
            "min": 500000000000
        }
    },
    "flags": {
        "actively_seeking": True,
        "contact_visible": True,
        "cooperated_before": True,
        "daily_buyer": True,
        "follower": True,
        "following": True,
        "high_reply_rate": True,
        "is_star": True,
        "live_potential_high": True
    },
    "live": {
        "avg_viewer": {
            "max": 500000000000,
            "min": 500000000000
        },
        "has_plan": True,
        "max_online": {
            "max": 500000000000,
            "min": 500000000000
        },
        "plan_days": ["<string>"]
    },
    "nick_name": "Li",
    "page_num": 1,
    "page_size": 20,
    "seed": 0
}
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({
    buyer: {group_tag: ['<string>'], persona_tag: ['<string>']},
    category: {first: ['<string>'], second: ['<string>']},
    ecom: {
      atv: {max: 500000000000, min: 500000000000},
      avg_gmv: {max: 500000000000, min: 500000000000},
      brand_avg_gmv: {max: 500000000000, min: 500000000000}
    },
    fans: {consumption: [], count: {max: 500000000000, min: 500000000000}},
    flags: {
      actively_seeking: true,
      contact_visible: true,
      cooperated_before: true,
      daily_buyer: true,
      follower: true,
      following: true,
      high_reply_rate: true,
      is_star: true,
      live_potential_high: true
    },
    live: {
      avg_viewer: {max: 500000000000, min: 500000000000},
      has_plan: true,
      max_online: {max: 500000000000, min: 500000000000},
      plan_days: ['<string>']
    },
    nick_name: 'Li',
    page_num: 1,
    page_size: 20,
    seed: 0
  })
};

fetch('https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_live_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_live_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([
    'buyer' => [
        'group_tag' => [
                '<string>'
        ],
        'persona_tag' => [
                '<string>'
        ]
    ],
    'category' => [
        'first' => [
                '<string>'
        ],
        'second' => [
                '<string>'
        ]
    ],
    'ecom' => [
        'atv' => [
                'max' => 500000000000,
                'min' => 500000000000
        ],
        'avg_gmv' => [
                'max' => 500000000000,
                'min' => 500000000000
        ],
        'brand_avg_gmv' => [
                'max' => 500000000000,
                'min' => 500000000000
        ]
    ],
    'fans' => [
        'consumption' => [
                
        ],
        'count' => [
                'max' => 500000000000,
                'min' => 500000000000
        ]
    ],
    'flags' => [
        'actively_seeking' => true,
        'contact_visible' => true,
        'cooperated_before' => true,
        'daily_buyer' => true,
        'follower' => true,
        'following' => true,
        'high_reply_rate' => true,
        'is_star' => true,
        'live_potential_high' => true
    ],
    'live' => [
        'avg_viewer' => [
                'max' => 500000000000,
                'min' => 500000000000
        ],
        'has_plan' => true,
        'max_online' => [
                'max' => 500000000000,
                'min' => 500000000000
        ],
        'plan_days' => [
                '<string>'
        ]
    ],
    'nick_name' => 'Li',
    'page_num' => 1,
    'page_size' => 20,
    'seed' => 0
  ]),
  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_live_blogger_list"

	payload := strings.NewReader("{\n  \"buyer\": {\n    \"group_tag\": [\n      \"<string>\"\n    ],\n    \"persona_tag\": [\n      \"<string>\"\n    ]\n  },\n  \"category\": {\n    \"first\": [\n      \"<string>\"\n    ],\n    \"second\": [\n      \"<string>\"\n    ]\n  },\n  \"ecom\": {\n    \"atv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"avg_gmv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"brand_avg_gmv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    }\n  },\n  \"fans\": {\n    \"consumption\": [],\n    \"count\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    }\n  },\n  \"flags\": {\n    \"actively_seeking\": true,\n    \"contact_visible\": true,\n    \"cooperated_before\": true,\n    \"daily_buyer\": true,\n    \"follower\": true,\n    \"following\": true,\n    \"high_reply_rate\": true,\n    \"is_star\": true,\n    \"live_potential_high\": true\n  },\n  \"live\": {\n    \"avg_viewer\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"has_plan\": true,\n    \"max_online\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"plan_days\": [\n      \"<string>\"\n    ]\n  },\n  \"nick_name\": \"Li\",\n  \"page_num\": 1,\n  \"page_size\": 20,\n  \"seed\": 0\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_live_blogger_list")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"buyer\": {\n    \"group_tag\": [\n      \"<string>\"\n    ],\n    \"persona_tag\": [\n      \"<string>\"\n    ]\n  },\n  \"category\": {\n    \"first\": [\n      \"<string>\"\n    ],\n    \"second\": [\n      \"<string>\"\n    ]\n  },\n  \"ecom\": {\n    \"atv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"avg_gmv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"brand_avg_gmv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    }\n  },\n  \"fans\": {\n    \"consumption\": [],\n    \"count\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    }\n  },\n  \"flags\": {\n    \"actively_seeking\": true,\n    \"contact_visible\": true,\n    \"cooperated_before\": true,\n    \"daily_buyer\": true,\n    \"follower\": true,\n    \"following\": true,\n    \"high_reply_rate\": true,\n    \"is_star\": true,\n    \"live_potential_high\": true\n  },\n  \"live\": {\n    \"avg_viewer\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"has_plan\": true,\n    \"max_online\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"plan_days\": [\n      \"<string>\"\n    ]\n  },\n  \"nick_name\": \"Li\",\n  \"page_num\": 1,\n  \"page_size\": 20,\n  \"seed\": 0\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_live_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  \"buyer\": {\n    \"group_tag\": [\n      \"<string>\"\n    ],\n    \"persona_tag\": [\n      \"<string>\"\n    ]\n  },\n  \"category\": {\n    \"first\": [\n      \"<string>\"\n    ],\n    \"second\": [\n      \"<string>\"\n    ]\n  },\n  \"ecom\": {\n    \"atv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"avg_gmv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"brand_avg_gmv\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    }\n  },\n  \"fans\": {\n    \"consumption\": [],\n    \"count\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    }\n  },\n  \"flags\": {\n    \"actively_seeking\": true,\n    \"contact_visible\": true,\n    \"cooperated_before\": true,\n    \"daily_buyer\": true,\n    \"follower\": true,\n    \"following\": true,\n    \"high_reply_rate\": true,\n    \"is_star\": true,\n    \"live_potential_high\": true\n  },\n  \"live\": {\n    \"avg_viewer\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"has_plan\": true,\n    \"max_online\": {\n      \"max\": 500000000000,\n      \"min\": 500000000000\n    },\n    \"plan_days\": [\n      \"<string>\"\n    ]\n  },\n  \"nick_name\": \"Li\",\n  \"page_num\": 1,\n  \"page_size\": 20,\n  \"seed\": 0\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"
}

PGY live blogger square Pricing — billed per successful call; the 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_live_blogger_list" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'  # see request schema below

Request contract

Method and path: POST /apis/v1/tikhub/xiaohongshu/pgy/get_live_blogger_list
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_live_blogger_list
Runtime facts: 85ae03121f63417c9ff9d57a0fd59fdc6386fd71e2dc732a002843e6d8979d87

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "post_tikhub_xiaohongshu_pgy_get_live_blogger_list",
  "method": "POST",
  "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_live_blogger_list",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "additionalProperties": false,
          "properties": {
            "buyer": {
              "anyOf": [
                {
                  "allOf": [
                    {
                      "additionalProperties": false,
                      "description": "Web page \"Top Buyer Squad\" + \"Content Persona\" section.",
                      "properties": {
                        "group_tag": {
                          "description": "Buyer group tag, e.g. Elegant Minimalist (leaf tags under style groups: Fashion Style / Body Type / Beauty & Skincare / Sports Enthusiast). Refer to the \"Buyer Group\" dropdown on the page for valid values.",
                          "items": {
                            "maxLength": 64,
                            "type": "string"
                          },
                          "maxItems": 30,
                          "title": "Group Tag",
                          "type": [
                            "array",
                            "null"
                          ]
                        },
                        "persona_tag": {
                          "description": "Content persona tags, e.g. Model (leaf nodes from groups: Professional Identity / Family Role / Distinctive Background / Style / Lifestyle / Skin Type / Skincare / Body Type). Refer to the \"Content Persona\" dropdown on the page.",
                          "items": {
                            "maxLength": 64,
                            "type": "string"
                          },
                          "maxItems": 30,
                          "title": "Persona Tag",
                          "type": [
                            "array",
                            "null"
                          ]
                        }
                      },
                      "title": "BuyerFilter",
                      "type": "object"
                    }
                  ],
                  "description": "Buyer group & persona filters"
                },
                {
                  "enum": [
                    null
                  ],
                  "type": [
                    "string",
                    "null"
                  ]
                }
              ],
              "description": "Buyer group & persona filters"
            },
            "category": {
              "anyOf": [
                {
                  "allOf": [
                    {
                      "additionalProperties": false,
                      "description": "Web page \"Cooperation Category\" section (primary + secondary; secondary must match the selected primary).",
                      "properties": {
                        "first": {
                          "description": "Primary cooperation category, e.g. Women's Apparel / Women's Premium. Refer to the \"Cooperation Category\" on the Pugongying \"Live Blogger Plaza\" page. Passing only the primary level is sufficient.",
                          "items": {
                            "maxLength": 64,
                            "type": "string"
                          },
                          "maxItems": 30,
                          "title": "First",
                          "type": [
                            "array",
                            "null"
                          ]
                        },
                        "second": {
                          "description": "Secondary cooperation category, e.g. Dress. May be left empty; filtering by primary level alone is also effective.",
                          "items": {
                            "maxLength": 64,
                            "type": "string"
                          },
                          "maxItems": 200,
                          "title": "Second",
                          "type": [
                            "array",
                            "null"
                          ]
                        }
                      },
                      "title": "CategoryFilter",
                      "type": "object"
                    }
                  ],
                  "description": "Cooperation category filters"
                },
                {
                  "enum": [
                    null
                  ],
                  "type": [
                    "string",
                    "null"
                  ]
                }
              ],
              "description": "Cooperation category filters"
            },
            "ecom": {
              "anyOf": [
                {
                  "allOf": [
                    {
                      "additionalProperties": false,
                      "description": "Web page \"E-commerce Conversion Power\" section.",
                      "properties": {
                        "atv": {
                          "anyOf": [
                            {
                              "allOf": [
                                {
                                  "additionalProperties": false,
                                  "description": "Numeric range corresponding to the web filter tier or custom input box. Either bound may be omitted; at least one must be provided.",
                                  "properties": {
                                    "max": {
                                      "description": "Maximum value (inclusive); omit for no upper limit",
                                      "maximum": 1000000000000.0,
                                      "minimum": 0.0,
                                      "title": "Max",
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    },
                                    "min": {
                                      "description": "Minimum value (inclusive)",
                                      "maximum": 1000000000000.0,
                                      "minimum": 0.0,
                                      "title": "Min",
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    }
                                  },
                                  "title": "RangeFilter",
                                  "type": "object"
                                }
                              ],
                              "description": "Average order value (CNY). Matched by tier (0-100 / 100-200 / 200-500 ...). Any tier overlapping with the specified range will be included — e.g. passing 100-300 will also return buyers in the 200-500 tier."
                            },
                            {
                              "enum": [
                                null
                              ],
                              "type": [
                                "string",
                                "null"
                              ]
                            }
                          ],
                          "description": "Average order value (CNY). Matched by tier (0-100 / 100-200 / 200-500 ...). Any tier overlapping with the specified range will be included — e.g. passing 100-300 will also return buyers in the 200-500 tier."
                        },
                        "avg_gmv": {
                          "anyOf": [
                            {
                              "allOf": [
                                {
                                  "additionalProperties": false,
                                  "description": "Numeric range corresponding to the web filter tier or custom input box. Either bound may be omitted; at least one must be provided.",
                                  "properties": {
                                    "max": {
                                      "description": "Maximum value (inclusive); omit for no upper limit",
                                      "maximum": 1000000000000.0,
                                      "minimum": 0.0,
                                      "title": "Max",
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    },
                                    "min": {
                                      "description": "Minimum value (inclusive)",
                                      "maximum": 1000000000000.0,
                                      "minimum": 0.0,
                                      "title": "Min",
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    }
                                  },
                                  "title": "RangeFilter",
                                  "type": "object"
                                }
                              ],
                              "description": "Average sales per session (CNY)"
                            },
                            {
                              "enum": [
                                null
                              ],
                              "type": [
                                "string",
                                "null"
                              ]
                            }
                          ],
                          "description": "Average sales per session (CNY)"
                        },
                        "brand_avg_gmv": {
                          "anyOf": [
                            {
                              "allOf": [
                                {
                                  "additionalProperties": false,
                                  "description": "Numeric range corresponding to the web filter tier or custom input box. Either bound may be omitted; at least one must be provided.",
                                  "properties": {
                                    "max": {
                                      "description": "Maximum value (inclusive); omit for no upper limit",
                                      "maximum": 1000000000000.0,
                                      "minimum": 0.0,
                                      "title": "Max",
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    },
                                    "min": {
                                      "description": "Minimum value (inclusive)",
                                      "maximum": 1000000000000.0,
                                      "minimum": 0.0,
                                      "title": "Min",
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    }
                                  },
                                  "title": "RangeFilter",
                                  "type": "object"
                                }
                              ],
                              "description": "Average sales per session for partnered brands (CNY)"
                            },
                            {
                              "enum": [
                                null
                              ],
                              "type": [
                                "string",
                                "null"
                              ]
                            }
                          ],
                          "description": "Average sales per session for partnered brands (CNY)"
                        }
                      },
                      "title": "EcomFilter",
                      "type": "object"
                    }
                  ],
                  "description": "E-commerce conversion filters"
                },
                {
                  "enum": [
                    null
                  ],
                  "type": [
                    "string",
                    "null"
                  ]
                }
              ],
              "description": "E-commerce conversion filters"
            },
            "fans": {
              "anyOf": [
                {
                  "allOf": [
                    {
                      "additionalProperties": false,
                      "description": "Audience purchasing power: follower count, age, gender, spending power.",
                      "properties": {
                        "age": {
                          "description": "Audience age (dominant group): 0=No limit, 1=Under 18, 2=18-24, 3=25-34, 4=35-44, 5=Over 44",
                          "enum": [
                            0,
                            1,
                            2,
                            3,
                            4,
                            5,
                            null
                          ],
                          "title": "Age",
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "consumption": {
                          "description": "Audience purchasing power: high / middle / low",
                          "items": {
                            "enum": [
                              "high",
                              "middle",
                              "low"
                            ],
                            "type": "string"
                          },
                          "maxItems": 3,
                          "title": "Consumption",
                          "type": [
                            "array",
                            "null"
                          ]
                        },
                        "count": {
                          "anyOf": [
                            {
                              "allOf": [
                                {
                                  "additionalProperties": false,
                                  "description": "Numeric range corresponding to the web filter tier or custom input box. Either bound may be omitted; at least one must be provided.",
                                  "properties": {
                                    "max": {
                                      "description": "Maximum value (inclusive); omit for no upper limit",
                                      "maximum": 1000000000000.0,
                                      "minimum": 0.0,
                                      "title": "Max",
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    },
                                    "min": {
                                      "description": "Minimum value (inclusive)",
                                      "maximum": 1000000000000.0,
                                      "minimum": 0.0,
                                      "title": "Min",
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    }
                                  },
                                  "title": "RangeFilter",
                                  "type": "object"
                                }
                              ],
                              "description": "Follower count"
                            },
                            {
                              "enum": [
                                null
                              ],
                              "type": [
                                "string",
                                "null"
                              ]
                            }
                          ],
                          "description": "Follower count"
                        },
                        "gender": {
                          "description": "Audience gender: 0=No limit, 1=Predominantly male, 2=Predominantly female",
                          "enum": [
                            0,
                            1,
                            2,
                            null
                          ],
                          "title": "Gender",
                          "type": [
                            "integer",
                            "null"
                          ]
                        }
                      },
                      "title": "FansFilter",
                      "type": "object"
                    }
                  ],
                  "description": "Fans purchasing power filters"
                },
                {
                  "enum": [
                    null
                  ],
                  "type": [
                    "string",
                    "null"
                  ]
                }
              ],
              "description": "Fans purchasing power filters"
            },
            "flags": {
              "anyOf": [
                {
                  "allOf": [
                    {
                      "additionalProperties": false,
                      "description": "Web page \"Platform Recommendations -> Featured Bloggers\" section (all checkboxes).",
                      "properties": {
                        "actively_seeking": {
                          "description": "Actively seeking collaborations",
                          "title": "Actively Seeking",
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "contact_visible": {
                          "description": "Contact information viewable",
                          "title": "Contact Visible",
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "cooperated_before": {
                          "description": "Has worked on commercial orders",
                          "title": "Cooperated Before",
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "daily_buyer": {
                          "description": "Daily live-stream buyer",
                          "title": "Daily Buyer",
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "follower": {
                          "description": "They follow you",
                          "title": "Follower",
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "following": {
                          "description": "You follow them",
                          "title": "Following",
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "high_reply_rate": {
                          "description": "High invitation response rate",
                          "title": "High Reply Rate",
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "is_star": {
                          "description": "Celebrity",
                          "title": "Is Star",
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "live_potential_high": {
                          "description": "High live streaming potential",
                          "title": "Live Potential High",
                          "type": [
                            "boolean",
                            "null"
                          ]
                        }
                      },
                      "title": "FlagFilter",
                      "type": "object"
                    }
                  ],
                  "description": "Platform recommendation flags"
                },
                {
                  "enum": [
                    null
                  ],
                  "type": [
                    "string",
                    "null"
                  ]
                }
              ],
              "description": "Platform recommendation flags"
            },
            "live": {
              "anyOf": [
                {
                  "allOf": [
                    {
                      "additionalProperties": false,
                      "description": "Web page \"Live Stream Engagement\" + \"Live Stream Performance\" section.",
                      "properties": {
                        "avg_viewer": {
                          "anyOf": [
                            {
                              "allOf": [
                                {
                                  "additionalProperties": false,
                                  "description": "Numeric range corresponding to the web filter tier or custom input box. Either bound may be omitted; at least one must be provided.",
                                  "properties": {
                                    "max": {
                                      "description": "Maximum value (inclusive); omit for no upper limit",
                                      "maximum": 1000000000000.0,
                                      "minimum": 0.0,
                                      "title": "Max",
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    },
                                    "min": {
                                      "description": "Minimum value (inclusive)",
                                      "maximum": 1000000000000.0,
                                      "minimum": 0.0,
                                      "title": "Min",
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    }
                                  },
                                  "title": "RangeFilter",
                                  "type": "object"
                                }
                              ],
                              "description": "Average viewers per session"
                            },
                            {
                              "enum": [
                                null
                              ],
                              "type": [
                                "string",
                                "null"
                              ]
                            }
                          ],
                          "description": "Average viewers per session"
                        },
                        "has_plan": {
                          "description": "Has live-stream plan",
                          "title": "Has Plan",
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "max_online": {
                          "anyOf": [
                            {
                              "allOf": [
                                {
                                  "additionalProperties": false,
                                  "description": "Numeric range corresponding to the web filter tier or custom input box. Either bound may be omitted; at least one must be provided.",
                                  "properties": {
                                    "max": {
                                      "description": "Maximum value (inclusive); omit for no upper limit",
                                      "maximum": 1000000000000.0,
                                      "minimum": 0.0,
                                      "title": "Max",
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    },
                                    "min": {
                                      "description": "Minimum value (inclusive)",
                                      "maximum": 1000000000000.0,
                                      "minimum": 0.0,
                                      "title": "Min",
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    }
                                  },
                                  "title": "RangeFilter",
                                  "type": "object"
                                }
                              ],
                              "description": "Peak concurrent viewers"
                            },
                            {
                              "enum": [
                                null
                              ],
                              "type": [
                                "string",
                                "null"
                              ]
                            }
                          ],
                          "description": "Peak concurrent viewers"
                        },
                        "plan_days": {
                          "description": "Planned live stream date in YYYYMMDD; used with has_plan; leave empty for all dates",
                          "items": {
                            "pattern": "^\\d{8}$",
                            "type": "string"
                          },
                          "maxItems": 60,
                          "title": "Plan Days",
                          "type": [
                            "array",
                            "null"
                          ]
                        }
                      },
                      "title": "LiveFilter",
                      "type": "object"
                    }
                  ],
                  "description": "Live activity & performance filters"
                },
                {
                  "enum": [
                    null
                  ],
                  "type": [
                    "string",
                    "null"
                  ]
                }
              ],
              "description": "Live activity & performance filters"
            },
            "nick_name": {
              "default": "",
              "description": "Search by nickname",
              "example": "Li",
              "maxLength": 50,
              "title": "Nick Name",
              "type": "string"
            },
            "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)",
              "example": 20,
              "maximum": 20.0,
              "minimum": 1.0,
              "title": "Page Size",
              "type": "integer"
            },
            "seed": {
              "default": 0,
              "description": "Paging seed, echo back from previous page",
              "example": 0,
              "minimum": 0.0,
              "title": "Seed",
              "type": "integer"
            }
          },
          "title": "LiveBloggerReq",
          "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"
      }
    }
  }
}

Cost and request rules

Published reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Default request reference estimate (USD): 0.02
Cost contract: fixed_success
Published reference multiplier: 1.0
Settlement evidence source: request_snapshot

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

buyer

Buyer group & persona filters

Show child attributes

Response

Successful response. The outer object follows ResponseModel; the endpoint-specific payload is in data.

6. Return

distributor_info_list[] — matched live sellers, each with two objects:

distributor_data_info: distributor_id (= blogger userId) / red_id / distributor_name / fans_num / atv (ATV tier) / avg_sale_amount (avg GMV) / avg_live_viewer_num / max_online_people_num / distribution_live_num (sessions) / content_categorys / city
distributor_extra_info: intended categories, commission, contact, level

Plus total (match count) / page_total (paging cap) / seed (echo back when paging) / req_id.

Response shape (two layers)

resp["data"] is PGY's raw envelope (with code/msg/success); the payload is one level deeper
Correct access: data = resp["data"]["data"] — every field listed under "Return" lives here

cache_message

string | null

default: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

default:本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。

Cache message (ZH-CN)

cache_url

string | null

The URL to access the cached result

code

integer

default:200

HTTP status code

data

any

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.

docs

string | null

Link to the API Swagger documentation for this endpoint

message

string

default:Request successful. This request will incur a charge.

Response message (EN-US)

message_zh

string

default:请求成功，本次请求将被计费。

Response message (ZH-CN)

params

any

default:{}

The parameters used in the request

request_id

string | null

Unique request identifier

router

string

default:""

The endpoint that generated this response

support

string

default:Discord: https://discord.gg/aMEAS8Xsvz

Support message

time

string

The time the response was generated

time_stamp

integer

The timestamp the response was generated

time_zone

string

default:America/Los_Angeles

The timezone of the response time

Overview

Models

Search & Research

Finance & Crypto

Social & Media

SEO & Web Intel

Sales & Email

Travel & Other

Media Generation

xiaohongshu get_live_blogger_list

Example

Request contract

Cost and request rules

Authorizations

Body

Response

6. Return

Response shape (two layers)

​Example

​Request contract

​Cost and request rules

Authorizations

Body

Response

6. Return

Response shape (two layers)

Example

Request contract

Cost and request rules