返回提交历史
Modified
docs/user/space.md
+63
-65
XFEstudio/bilibili-API-collect
update【查询用户投稿】APIDoc
09c167a
代码差异
1 个文件
+63
-65
@@ -2624,38 +2624,37 @@ curl -L -X GET 'https://api.bilibili.com/x/space/like/video?vmid=15858903'
2624
2624
2625
2625
> https://api.bilibili.com/x/space/wbi/arc/search
2626
2626
2627
> https://api.bilibili.com/x/space/arc/search （旧）
2628
2629
PS：旧 api 存在一些不同，比如某些情况下，例如 mid=2 时如果没有设置 Cookie 则出现非法访问（-401），但新 api 不会。
2627
> ~~https://api.bilibili.com/x/space/arc/search （旧 API，现已不可用）~~
2630
2628
2629
PS：旧 API 现已不可使用，活返回`code=-799`
2631
2630
2632
2631
*请求方式：GET*
2633
2632
2634
2633
**header字段：**
2635
2634
2636
必须要有 `user-agent`，且不能为 `空字符串`，以及含有 `python`、`node`、`curl` 等的字符串。
2635
必须要有 `user-agent`，且不能为 `空字符串`，以及含有 `python`、`node`、`curl` 等的字符串
2637
2636
2638
2637
**url参数：**
2639
2638
2640
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
2641
|---------|-----|---------|-----|-------------------------------------------------------------|
2642
| mid | num | 目标用户mid | 必要 | |
2643
| order | str | 排序方式 | 非必要 | 默认为pubdate<br />最新发布：pubdate<br />最多播放：click<br />最多收藏：stow |
2644
| tid | num | 筛选目标分区 | 非必要 | 默认为0<br />0：不进行分区筛选<br />分区tid为所筛选的分区 |
2645
| keyword | str | 关键词筛选 | 非必要 | 用于使用关键词搜索该UP主视频稿件 |
2646
| pn | num | 页码 | 非必要 | |
2647
| ps | num | 每页项数 | 非必要 | 最小1，最大50，默认30 |
2639
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
2640
| ------- | ---- | ------------ | ------ | ------------------------------------------------------------ |
2641
| mid | num | 目标用户mid | 必要 | |
2642
| order | str | 排序方式 | 非必要 | 默认为pubdate<br />最新发布：pubdate<br />最多播放：click<br />最多收藏：stow |
2643
| tid | num | 筛选目标分区 | 非必要 | 默认为0<br />0：不进行分区筛选<br />分区tid为所筛选的分区 |
2644
| keyword | str | 关键词筛选 | 非必要 | 用于使用关键词搜索该UP主视频稿件 |
2645
| pn | num | 页码 | 非必要 | |
2646
| ps | num | 每页项数 | 非必要 | 最小 1，最大 50，默认 30 |
2648
2647
2649
2648
**json回复：**
2650
2649
2651
2650
根对象：
2652
2651
2653
| 字段 | 类型 | 内容 | 备注 |
2654
|---------|-----|------|----------------------------------------------------------------------|
2655
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-412：请求被拦截<br />-1200：被降级过滤的请求(一种意义不明的偶发状况) |
2656
| message | str | 错误信息 | 默认为0 |
2657
| ttl | num | 1 | |
2658
| data | obj | 信息本体 | |
2652
| 字段 | 类型 | 内容 | 备注 |
2653
| ------- | ---- | -------- | ------------------------------------------------------------ |
2654
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-412：请求被拦截<br />-1200：被降级过滤的请求(一种意义不明的偶发状况) |
2655
| message | str | 错误信息 | 默认为 0 |
2656
| ttl | num | 1 | |
2657
| data | obj | 信息本体 | |
2659
2658
2660
2659
`data`对象：
2661
2660
@@ -2677,55 +2676,55 @@ PS：旧 api 存在一些不同，比如某些情况下，例如 mid=2 时如果
2677
2676
2678
2677
`list`中的`tlist`对象：
2679
2678
2680
| 字段 | 类型 | 内容 | 备注 |
2681
|-------|-----|--------|--------------|
2682
| {tid} | obj | 该分区的详情 | 字段名为存在的分区tid |
2683
| …… | obj | …… | 向下扩展 |
2679
| 字段 | 类型 | 内容 | 备注 |
2680
| ----- | ---- | ------------ | ---------------------- |
2681
| {tid} | obj | 该分区的详情 | 字段名为存在的分区 tid |
2682
| …… | obj | …… | 向下扩展 |
2684
2683
2685
2684
`tlist`中的`{tid}`对象：
2686
2685
2687
| 字段 | 类型 | 内容 | 备注 |
2688
|-------|-----|------------|-----|
2689
| count | num | 投稿至该分区的视频数 | |
2690
| name | str | 该分区名称 | |
2691
| tid | num | 该分区tid | |
2686
| 字段 | 类型 | 内容 | 备注 |
2687
| ----- | ---- | -------------------- | ---- |
2688
| count | num | 投稿至该分区的视频数 | |
2689
| name | str | 该分区名称 | |
2690
| tid | num | 该分区 tid | |
2692
2691
2693
2692
`list`中的`vlist`数组：
2694
2693
2695
| 项 | 类型 | 内容 | 备注 |
2696
|-----|-----|-----------|-----|
2697
| 0 | obj | 投稿视频1 | |
2698
| n | obj | 投稿视频（n+1） | |
2699
| …… | obj | …… | …… |
2694
| 项 | 类型 | 内容 | 备注 |
2695
| ---- | ---- | --------------- | ---- |
2696
| 0 | obj | 投稿视频 1 | |
2697
| n | obj | 投稿视频（n+1） | |
2698
| …… | obj | …… | …… |
2700
2699
2701
2700
`list`中的`vlist`数组中的对象：
2702
2701
2703
| 字段 | 类型 | 内容 | 备注 |
2704
|------------------|------|----------|--------------------------------------------------------------------------------|
2705
| aid | num | 稿件avid | |
2706
| author | str | 视频UP主 | 不一定为目标用户（合作视频） |
2707
| bvid | str | 稿件bvid | |
2708
| comment | num | 视频评论数 | |
2709
| copyright | str | 空 | 作用尚不明确 |
2710
| created | num | 投稿时间 | 时间戳 |
2711
| description | str | 视频简介 | |
2712
| hide_click | bool | false | 作用尚不明确 |
2713
| is_pay | num | 0 | 作用尚不明确 |
2714
| is_union_video | num | 是否为合作视频 | 0：否<br />1：是 |
2715
| length | str | 视频长度 | MM:SS |
2716
| mid | num | 视频UP主mid | 不一定为目标用户（合作视频） |
2717
| pic | str | 视频封面 | |
2702
| 字段 | 类型 | 内容 | 备注 |
2703
| ---------------- | ---- | -------------- | ------------------------------------------------------------ |
2704
| aid | num | 稿件 avid | |
2705
| author | str | 视频 UP 主 | 不一定为目标用户（合作视频） |
2706
| bvid | str | 稿件 bvid | |
2707
| comment | num | 视频评论数 | |
2708
| copyright | str | 稿件类型 | 1：原创<br />2：转载 |
2709
| created | num | 投稿时间 | 时间戳 |
2710
| description | str | 视频简介 | |
2711
| hide_click | bool | false | 作用尚不明确 |
2712
| is_pay | num | 0 | 作用尚不明确 |
2713
| is_union_video | num | 是否为合作视频 | 0：否<br />1：是 |
2714
| length | str | 视频长度 | MM:SS |
2715
| mid | num | 视频 UP 主 mid | 不一定为目标用户（合作视频） |
2716
| pic | str | 视频封面 | |
2718
2717
| play | num | 视频播放次数 | 如果视频基本信息API对应的状态为-403视频访问权限不足，数据类型将变为str，如（"play": "--",），于mid79发表的av5132474可见 |
2719
| review | num | 0 | 作用尚不明确 |
2720
| subtitle | str | 空 | 作用尚不明确 |
2721
| title | str | 视频标题 | |
2722
| typeid | num | 视频分区tid | |
2723
| video_review | num | 视频弹幕数 | |
2724
| is_steins_gate | num | 0 | |
2725
| is_live_playback | num | 0 | |
2726
| meta | | | |
2727
| is_avoided | num | 0 | |
2728
| attribute | num | 0 | |
2718
| review | num | 0 | 作用尚不明确 |
2719
| subtitle | str | 空 | 作用尚不明确 |
2720
| title | str | 视频标题 | |
2721
| typeid | num | 视频分区 tid | |
2722
| video_review | num | 视频弹幕数 | |
2723
| is_steins_gate | num | 0 | |
2724
| is_live_playback | num | 0 | |
2725
| meta | | | |
2726
| is_avoided | num | 0 | |
2727
| attribute | num | 0 | |
2729
2728
2730
2729
`data`中的`page`对象：
2731
2730
@@ -2737,10 +2736,10 @@ PS：旧 api 存在一些不同，比如某些情况下，例如 mid=2 时如果
2737
2736
2738
2737
`data`中的`episodic_button`对象：
2739
2738
2740
| 字段 | 类型 | 内容 | 备注 |
2741
|------|-----|----------|-----|
2742
| text | str | 按钮文字 | |
2743
| uri | str | 全部播放页url | |
2739
| 字段 | 类型 | 内容 | 备注 |
2740
| ---- | ---- | -------------- | ---- |
2741
| text | str | 按钮文字 | |
2742
| uri | str | 全部播放页 url | |
2744
2743
2745
2744
**示例：**
2746
2745
@@ -2750,10 +2749,9 @@ PS：旧 api 存在一些不同，比如某些情况下，例如 mid=2 时如果
2750
2749
2751
2750
```shell
2752
2751
curl -G 'https://api.bilibili.com/x/space/wbi/arc/search' \
2752
--data-urlencode 'mid=53456' \
2753
--data-urlencode 'ps=2' \
2754
--data-urlencode 'pn=1'
2753
2755
```
2754
2756
2755
2757
<details>