搜索媒资
更新时间：2025-08-22
本接口用于搜索媒资列表，搜索结果返回媒资分页结果，媒资信息仅包含基础信息。
搜索媒资支持多种检索条件，包括：
- 媒资名称
- 媒资类型
- 媒资ID
- 媒资来源
- 媒资创建时间
- 封禁状态
- 媒资分类
- 媒资标签
接口限制：
- marker 和 maxSize 两个参数影响单次分页查询结果数。特别注意：当这2个值都缺省时，本接口最多只返回前10条查询结果。
请求结构
Http
1GET /v2/medias?{请求参数} HTTP/1.1
2connection: keep-alive
3host: vod.bj.baidubce.com
4content-type: application/json
5x-bce-request-id: <bce-request-id>
6x-bce-date: <utc-date-string>
7authorization: <bce-authorization-string> 请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| marker | string | 否 | Query参数 | 本次请求的marker，标记查询的起始位置，是上次marker机制查询返回的nextMarker，首次查询不提供本字段 |
| maxSize | string | 否 | Query参数 | 本次请求返回的媒资列表的最大元素个数，支持范围：[1-1000]，默认值：10 |
| name | string | 否 | Query参数 | 媒资名称，支持模糊匹配 |
| mediaTypes | string[] | 否 | Query参数 | 媒资类型，支持：video、audio、image |
| mediaId | string | 否 | Query参数 | 媒资ID |
| sourceType | string | 否 | Query参数 | 媒资来源，支持：
|
| banStatus | string | 否 | Query参数 | 封禁状态，支持：
|
| categoryIds | string[] | 否 | Query参数 | 媒资分类ID列表 |
| tags | string[] | 否 | Query参数 | 媒资标签列表 |
| beginTime | string | 否 | Query参数 | 媒资创建时间的开始时间，大于等于开始时间，格式参考日期与时间规范 |
| endTime | string | 否 | Query参数 | 媒资创建时间的开始时间，小于等于结束时间，格式参考日期与时间规范 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| isTruncated | boolean | 下一页是否还有数据 |
| marker | string | 当前页查询的marker |
| nextMarker | string | 查询下一页的marker |
| data | MediaBasicInfo[] | 此页数据 |
示例
根据创建时间范围搜索媒资
第一次搜索时不需要指定marker，从起始开始搜索。
请求内容
Http
1GET /v2/medias?maxSize=2&begin=2024-09-11T12:18:30Z&end=2024-09-13T12:18:30Z HTTP/1.1
2host: vod.bj.baidubce.com
3accept: */*
4connection: keep-alive
5content-type: application/json
6x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
7x-bce-date: 2024-03-24T13:08:44Z
8authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2024-03-24T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9返回内容
Http
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
4Cache-Control: no-cache
5Date: Tue, 24 Mar 2024 13:08:44 GMT
6Content-Type: application/json;charset=UTF-8
7
8{
9 "data": [
10 {
11 "mediaId": "mda-fhepatsnpn4rk9zk",
12 "name": "vod1.mp4",
13 "banStatus": "NORMAL",
14 "createTime": "2024-09-11T13:44:41Z",
15 "source": {
16 "sourceType": "UPLOAD",
17 "sourceUrl": "https://bj-bos.baidu-int.com/v1/vod-egyrrahca3f80ev6/mda-fhepatsnpn4rk9zk/_src/mda-ehwth0gvkaj8c53z.mp4?authorization=bce-auth-v1%2F213ee4f72b944fdba2e3326af256b781%2F2024-08-21T12%3A20%3A28Z%2F3600%2F%2Fd575aaebfe4e164b94e3146bc245f594dedccd1b8f467d816cc35039e3f9c980",
18 "coverUrl": "https://bj-bos.baidu-int.com/v1/vod-egyrrahca3f80ev6/mda-fhepatsnpn4rk9zk/ehwty5yu7pn7nxqc7rde/ehwttwiu8p6eyas1e7aj/mda-ehwth0gvkaj8c53z.jpg?authorization=bce-auth-v1%2F213ee4f72b944fdba2e3326af256b781%2F2024-08-21T12%3A20%3A28Z%2F3600%2F%2Fee70350a7d12e56ba9efd9ad9c0ece4009e72aa7b28eeb3595fae433beb09caf"
19 },
20 "categoryId": "system",
21 "sourceMetadata": {
22 "fileSizeInByte": 2443128,
23 "type": "video",
24 "container": "mov,mp4,m4a,3gp,3g2,mj2",
25 "durationInSecond": 4,
26 "durationInMillisecond": 4410,
27 "video": {
28 "codec": "h264",
29 "heightInPixel": 720,
30 "widthInPixel": 1280,
31 "bitRateInBps": 4388595,
32 "frameRate": 24.0,
33 "dar": "16:9"
34 },
35 "audio": {
36 "codec": "aac",
37 "channels": 1,
38 "sampleRateInHz": 44100,
39 "bitRateInBps": 69574
40 },
41 "etag": "ba7247de26535e57f0fff4c2a80fe08e"
42 }
43 },
44 {
45 "mediaId": "mda-ehwkurnbbirnxfrr",
46 "name": "vod2.mp4",
47 "banStatus": "NORMAL",
48 "createTime": "2024-09-13T02:13:11Z",
49 "categoryId": "ek1knxq4san4617d8bux",
50 "source": {
51 "sourceType": "UPLOAD",
52 "sourceUrl": "https://bj-bos.baidu-int.com/v1/vod-egyrrahca3f80ev6/mda-ehwkurnbbirnxfrr/_src/mda-ehwkurnbbirnxfrr.mp4?authorization=bce-auth-v1%2F213ee4f72b944fdba2e3326af256b781%2F2024-08-21T12%3A20%3A28Z%2F3600%2F%2F75d21aee4ff0a92b22fa1da58b5f7721501666e56ac0994c3a138f197d0d0436"
53 },
54 "sourceMetadata": {
55 "fileSizeInByte": 2443128,
56 "type": "video",
57 "container": "mov,mp4,m4a,3gp,3g2,mj2",
58 "durationInSecond": 4,
59 "durationInMillisecond": 4410,
60 "video": {
61 "codec": "h264",
62 "heightInPixel": 720,
63 "widthInPixel": 1280,
64 "bitRateInBps": 4388595,
65 "frameRate": 24.0,
66 "dar": "16:9"
67 },
68 "audio": {
69 "codec": "aac",
70 "channels": 1,
71 "sampleRateInHz": 44100,
72 "bitRateInBps": 69574
73 },
74 "etag": "ba7247de26535e57f0fff4c2a80fe08e"
75 }
76 }
77 ],
78 "marker": "mda-fhepatsnpn4rk9zk",
79 "nextMarker": "mda-ehgr5pdgv6fsedqj",
80 "isTruncated": true
81}返回结果的isTruncated为true，表示还有下一页数据。如果要继续搜索，需要再下一次请求Query指定marker为本次请求返回的nextMarker，即marker=mda-ehgr5pdgv6fsedqj。
根据分类ID搜索媒资
请求内容
Http
1GET /v2/medias?maxSize=2&categoryIds=system,ek1knxq4san4617d8bux HTTP/1.1
2host: vod.bj.baidubce.com
3accept: */*
4connection: keep-alive
5content-type: application/json
6x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
7x-bce-date: 2024-03-24T13:08:44Z
8authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2024-03-24T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9返回内容
Http
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
4Cache-Control: no-cache
5Date: Tue, 24 Mar 2024 13:08:44 GMT
6Content-Type: application/json;charset=UTF-8
7
8{
9 "data": [
10 {
11 "mediaId": "mda-fhepatsnpn4rk9zk",
12 "name": "vod1.mp4",
13 "banStatus": "NORMAL",
14 "createTime": "2024-09-11T13:44:41Z",
15 "categoryId": "system",
16 "source": {
17 "sourceType": "UPLOAD",
18 "sourceUrl": "https://bj-bos.baidu-int.com/v1/vod-egyrrahca3f80ev6/mda-fhepatsnpn4rk9zk/_src/mda-ehwth0gvkaj8c53z.mp4?authorization=bce-auth-v1%2F213ee4f72b944fdba2e3326af256b781%2F2024-08-21T12%3A20%3A28Z%2F3600%2F%2Fd575aaebfe4e164b94e3146bc245f594dedccd1b8f467d816cc35039e3f9c980",
19 "coverUrl": "https://bj-bos.baidu-int.com/v1/vod-egyrrahca3f80ev6/mda-fhepatsnpn4rk9zk/ehwty5yu7pn7nxqc7rde/ehwttwiu8p6eyas1e7aj/mda-ehwth0gvkaj8c53z.jpg?authorization=bce-auth-v1%2F213ee4f72b944fdba2e3326af256b781%2F2024-08-21T12%3A20%3A28Z%2F3600%2F%2Fee70350a7d12e56ba9efd9ad9c0ece4009e72aa7b28eeb3595fae433beb09caf"
20 },
21 "sourceMetadata": {
22 "fileSizeInByte": 2443128,
23 "type": "video",
24 "container": "mov,mp4,m4a,3gp,3g2,mj2",
25 "durationInSecond": 4,
26 "durationInMillisecond": 4410,
27 "video": {
28 "codec": "h264",
29 "heightInPixel": 720,
30 "widthInPixel": 1280,
31 "bitRateInBps": 4388595,
32 "frameRate": 24.0,
33 "dar": "16:9"
34 },
35 "audio": {
36 "codec": "aac",
37 "channels": 1,
38 "sampleRateInHz": 44100,
39 "bitRateInBps": 69574
40 },
41 "etag": "ba7247de26535e57f0fff4c2a80fe08e"
42 }
43 },
44 {
45 "mediaId": "mda-ehwkurnbbirnxfrr",
46 "name": "vod2.mp4",
47 "banStatus": "NORMAL",
48 "createTime": "2024-09-13T02:13:11Z",
49 "categoryId": "ek1knxq4san4617d8bux",
50 "source": {
51 "sourceType": "UPLOAD",
52 "sourceUrl": "https://bj-bos.baidu-int.com/v1/vod-egyrrahca3f80ev6/mda-ehwkurnbbirnxfrr/_src/mda-ehwkurnbbirnxfrr.mp4?authorization=bce-auth-v1%2F213ee4f72b944fdba2e3326af256b781%2F2024-08-21T12%3A20%3A28Z%2F3600%2F%2F75d21aee4ff0a92b22fa1da58b5f7721501666e56ac0994c3a138f197d0d0436"
53 },
54 "sourceMetadata": {
55 "fileSizeInByte": 2443128,
56 "type": "video",
57 "container": "mov,mp4,m4a,3gp,3g2,mj2",
58 "durationInSecond": 4,
59 "durationInMillisecond": 4410,
60 "video": {
61 "codec": "h264",
62 "heightInPixel": 720,
63 "widthInPixel": 1280,
64 "bitRateInBps": 4388595,
65 "frameRate": 24.0,
66 "dar": "16:9"
67 },
68 "audio": {
69 "codec": "aac",
70 "channels": 1,
71 "sampleRateInHz": 44100,
72 "bitRateInBps": 69574
73 },
74 "etag": "ba7247de26535e57f0fff4c2a80fe08e"
75 }
76 }
77 ],
78 "marker": "mda-fhepatsnpn4rk9zk",
79 "nextMarker": "mda-ehgr5pdgv6fsedqj",
80 "isTruncated": true
81}错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 错误信息 | HTTP状态码 | 描述 |
|---|---|---|---|
| MediaCategoryNotFound | category not found: xxx | 404 Not Found | 分类不存在 |