View raw JSON
{
"type": "object",
"required": [],
"properties": {
"body": {
"type": "object",
"title": "LiveBloggerReq",
"properties": {
"ecom": {
"anyOf": [
{
"type": "object",
"title": "EcomFilter",
"properties": {
"atv": {
"anyOf": [
{
"type": "object",
"title": "RangeFilter",
"properties": {
"max": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Max",
"description": "Maximum value (inclusive); omit for no upper limit"
},
"min": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Min",
"description": "Minimum value (inclusive)"
}
},
"description": "Numeric range corresponding to tier or custom input on the web filter. Both bounds are optional; provide at least one.",
"x-readme-ref-name": "crawlers__xiaohongshu__pgy__pgy_live_filters__RangeFilter",
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Average transaction value (CNY). Matched by tier (0–100 / 100–200 / 200–500 …); any tier overlapping your range will be included."
},
"avg_gmv": {
"anyOf": [
{
"type": "object",
"title": "RangeFilter",
"properties": {
"max": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Max",
"description": "Maximum value (inclusive); omit for no upper limit"
},
"min": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Min",
"description": "Minimum value (inclusive)"
}
},
"description": "Numeric range corresponding to tier or custom input on the web filter. Both bounds are optional; provide at least one.",
"x-readme-ref-name": "crawlers__xiaohongshu__pgy__pgy_live_filters__RangeFilter",
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Average GMV per session (CNY)"
},
"brand_avg_gmv": {
"anyOf": [
{
"type": "object",
"title": "RangeFilter",
"properties": {
"max": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Max",
"description": "Maximum value (inclusive); omit for no upper limit"
},
"min": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Min",
"description": "Minimum value (inclusive)"
}
},
"description": "Numeric range corresponding to tier or custom input on the web filter. Both bounds are optional; provide at least one.",
"x-readme-ref-name": "crawlers__xiaohongshu__pgy__pgy_live_filters__RangeFilter",
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Average brand collaboration GMV per session (CNY)"
}
},
"description": "E-commerce conversion section from the web interface.",
"x-readme-ref-name": "EcomFilter",
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "E-commerce conversion filters"
},
"fans": {
"anyOf": [
{
"type": "object",
"title": "FansFilter",
"properties": {
"age": {
"anyOf": [
{
"enum": [
0,
1,
2,
3,
4,
5
],
"type": "integer"
},
{
"type": "null"
}
],
"title": "Age",
"description": "Fan age bracket: 0 = any, 1 = under 18, 2 = 18–24, 3 = 25–34, 4 = 35–44, 5 = over 44 (dominant share)"
},
"count": {
"anyOf": [
{
"type": "object",
"title": "RangeFilter",
"properties": {
"max": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Max",
"description": "Maximum value (inclusive); omit for no upper limit"
},
"min": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Min",
"description": "Minimum value (inclusive)"
}
},
"description": "Numeric range corresponding to tier or custom input on the web filter. Both bounds are optional; provide at least one.",
"x-readme-ref-name": "crawlers__xiaohongshu__pgy__pgy_live_filters__RangeFilter",
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Follower count"
},
"gender": {
"anyOf": [
{
"enum": [
0,
1,
2
],
"type": "integer"
},
{
"type": "null"
}
],
"title": "Gender",
"description": "Fan gender: 0 = any, 1 = predominantly male, 2 = predominantly female"
},
"consumption": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"high",
"middle",
"low"
],
"type": "string"
},
"maxItems": 3
},
{
"type": "null"
}
],
"title": "Consumption",
"description": "Fan spending level: high / middle / low"
}
},
"description": "Fan purchasing power: follower count, age, gender, and spending level.",
"x-readme-ref-name": "FansFilter",
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Fan purchasing power filters"
},
"live": {
"anyOf": [
{
"type": "object",
"title": "LiveFilter",
"properties": {
"has_plan": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Has Plan",
"description": "Has a scheduled live stream plan"
},
"plan_days": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{8}$"
},
"maxItems": 60
},
{
"type": "null"
}
],
"title": "Plan Days",
"description": "Planned live stream dates in YYYYMMDD format; used with has_plan, leave empty for all dates"
},
"avg_viewer": {
"anyOf": [
{
"type": "object",
"title": "RangeFilter",
"properties": {
"max": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Max",
"description": "Maximum value (inclusive); omit for no upper limit"
},
"min": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Min",
"description": "Minimum value (inclusive)"
}
},
"description": "Numeric range corresponding to tier or custom input on the web filter. Both bounds are optional; provide at least one.",
"x-readme-ref-name": "crawlers__xiaohongshu__pgy__pgy_live_filters__RangeFilter",
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Average viewers per session"
},
"max_online": {
"anyOf": [
{
"type": "object",
"title": "RangeFilter",
"properties": {
"max": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Max",
"description": "Maximum value (inclusive); omit for no upper limit"
},
"min": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000000,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Min",
"description": "Minimum value (inclusive)"
}
},
"description": "Numeric range corresponding to tier or custom input on the web filter. Both bounds are optional; provide at least one.",
"x-readme-ref-name": "crawlers__xiaohongshu__pgy__pgy_live_filters__RangeFilter",
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Peak concurrent viewers"
}
},
"description": "Live streaming commitment and performance section from the web interface.",
"x-readme-ref-name": "crawlers__xiaohongshu__pgy__pgy_live_filters__LiveFilter",
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Live streaming activity and performance filters"
},
"seed": {
"type": "integer",
"title": "Seed",
"default": 0,
"minimum": 0,
"examples": [
0
],
"description": "Paging seed; pass 0 for the first page, then echo back the seed from the previous response"
},
"buyer": {
"anyOf": [
{
"type": "object",
"title": "BuyerFilter",
"properties": {
"group_tag": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"maxLength": 64
},
"maxItems": 30
},
{
"type": "null"
}
],
"title": "Group Tag",
"description": "Buyer group tag (e.g., Elegant Minimalist). Values correspond to leaf options under fashion style, body type, beauty & skincare, or sports & hobbies on the page dropdown."
},
"persona_tag": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"maxLength": 64
},
"maxItems": 30
},
{
"type": "null"
}
],
"title": "Persona Tag",
"description": "Content persona tag (e.g., Model). Values correspond to leaf options under occupation, family role, background, format, lifestyle, skin type, skincare, or body type on the page dropdown."
}
},
"description": "Buyer group and content persona section from the web interface.",
"x-readme-ref-name": "BuyerFilter",
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Buyer group and content persona filters"
},
"flags": {
"anyOf": [
{
"type": "object",
"title": "FlagFilter",
"properties": {
"is_star": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Star",
"description": "Celebrity"
},
"follower": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Follower",
"description": "They follow you"
},
"following": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Following",
"description": "You follow them"
},
"daily_buyer": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Daily Buyer",
"description": "Daily live-stream buyer"
},
"contact_visible": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Contact Visible",
"description": "Contact information visible"
},
"high_reply_rate": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "High Reply Rate",
"description": "High invitation reply rate"
},
"actively_seeking": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Actively Seeking",
"description": "Actively seeking collaborations"
},
"cooperated_before": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Cooperated Before",
"description": "Has completed sponsored collaborations before"
},
"live_potential_high": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Live Potential High",
"description": "High live-streaming potential"
}
},
"description": "Platform recommended / featured blogger section (all are checkbox options).",
"x-readme-ref-name": "crawlers__xiaohongshu__pgy__pgy_live_filters__FlagFilter",
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Platform recommendation flags"
},
"category": {
"anyOf": [
{
"type": "object",
"title": "CategoryFilter",
"properties": {
"first": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"maxLength": 64
},
"maxItems": 30
},
{
"type": "null"
}
],
"title": "First",
"description": "Primary collaboration category (e.g., Women's Fashion). Values match the category dropdown on the Pugongying live blogger page; specifying only the primary level is sufficient."
},
"second": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"maxLength": 64
},
"maxItems": 200
},
{
"type": "null"
}
],
"title": "Second",
"description": "Secondary collaboration category (e.g., Dresses). Optional; filtering by primary category alone is also effective."
}
},
"description": "Collaboration category section (primary + secondary; secondary must match the primary).",
"x-readme-ref-name": "CategoryFilter",
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Collaboration category filters"
},
"page_num": {
"type": "integer",
"title": "Page Num",
"default": 1,
"maximum": 250,
"minimum": 1,
"examples": [
1
],
"description": "Page number, 1–250 (upstream exposes only the first 5,000 results)"
},
"nick_name": {
"type": "string",
"title": "Nick Name",
"default": "",
"examples": [
"李"
],
"maxLength": 50,
"description": "Search by blogger nickname"
},
"page_size": {
"type": "integer",
"title": "Page Size",
"default": 20,
"maximum": 20,
"minimum": 1,
"examples": [
20
],
"description": "Results per page, 1–20 (web interface uses a fixed 20)"
}
},
"x-readme-ref-name": "LiveBloggerReq",
"additionalProperties": false
},
"queryParams": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"additionalProperties": false
}
