当前浏览的是 v7 预览版文档(v7 尚未正式发布,API 可能随版本调整)。本页是 v7 新增内容,去 v6 正式版文档首页
@ikenxuan/amagi

直播广场

取直播广场推荐列表,参数均可选。

GET
/api/xiaohongshu/fetch_live_square

Authorization

bearerAuth
AuthorizationBearer <token>

仅在 startServer 传了 token 时生效

In: header

Query Parameters

source?integer

来源标识,默认 13

Range-9007199254740991 <= value <= 9007199254740991
category?string

分类,默认 0(全部)

pre_source?string

前置来源,真机首屏为空

size?integer

每页数量,默认 27

Range1 <= value <= 100
extra_info?|

附加信息;HTTP query 可传 JSON 字符串,默认 {"image_formats":["jpg","webp","avif"]}

cursor_score?string

分页游标分数,翻页时才带

Response Body

application/json

application/json

curl -X GET "https://example.com/api/xiaohongshu/fetch_live_square"
{  "success": true,  "data": {    "code": 0,    "data": {      "feeds": [        {          "cursor_score": "string",          "live": {            "room_extra_info": "string",            "score": 0,            "t_live_host_info": {              "avatar": "string",              "nickname": "string",              "user_id": "string"            },            "t_room_info": {              "content_type": 0,              "cover": "string",              "cover_info": {                "cover_image": "string",                "video_play_mode": 0              },              "display_count": 0,              "hot_value": 0,              "link": "string",              "member_count": 0,              "name": "string",              "room_id": "string",              "room_id_str": "string",              "uv": 0,              "xsec_token": "string"            },            "track_id": "string"          },          "model_type": "string",          "recommend": {            "desc": "string",            "icon": "string",            "live_card_extra_info": "string",            "live_rec_content_tag": "string",            "live_rec_content_text": "string",            "track_id": "string",            "type": "string"          },          "type": "string"        }      ]    },    "msg": "string",    "success": true  },  "error": {    "kind": "validation",    "code": "string",    "message": "string",    "retryable": true,    "platform": {      "code": "string",      "message": "string"    },    "http": {      "status": 0,      "statusText": "string"    },    "issues": [      {        "path": "string",        "message": "string",        "received": null      }    ]  },  "message": "string",  "meta": {    "requestId": "string",    "clientId": "string",    "platform": "douyin",    "endpoint": "string",    "durationMs": 0,    "attempts": 0,    "trace": [      {        "url": "string",        "method": "string",        "status": 0,        "durationMs": 0,        "reason": "initial",        "retryOf": "string"      }    ]  },  "requestPath": "/api/bilibili/fetch_one_video?bvid=BV1xx"}