# 按标签查找视频

### 接口URL

```
http://api.polyv.net/v2/video/{userid}/search
```

### 接口说明

```
按视频标签查找视频列表
```

### 支持格式

```
XML/JSON
```

### 请求方式

```
POST,GET
```

### 请求数限制

```
TRUE
```

### 请求参数

| 参数名        | 必选    | 类型及范围  | 说明                                                                                   |
| ---------- | ----- | ------ | ------------------------------------------------------------------------------------ |
| userid     | true  | string | POLYV用户ID，<http://api.polyv.net/v2/video/{userid}/search> 中的{userid}需要替换为POLYV用户ID的值 |
| format     | false | string | 默认返回json格式，如果format=xml返回xml格式                                                       |
| jsonp      | false | string | 例如，正常情况{error:0,data:””}，加 jsonp=a后返回a({error:0,data:””})                            |
| numPerPage | false | int    | 页数                                                                                   |
| pageNum    | false | int    | 页码                                                                                   |
| ptime      | true  | string | 当前时间的毫秒级时间戳（13位），3分钟内有效                                                              |
| tag        | false | string | 视频标签                                                                                 |
| sign       | true  | string | 签名，为40位大写的SHA1值                                                                      |

#### PHP示例代码

```php
<?php
$userid="9f1e0689e1";//必选
$format="";
$jsonp="";
$numPerPage=100;
$pageNum=1;
$ptime=time()*1000;//必选
$tag="刘诗昆";
$secretkey="AkDipaULWw";
$post_data = array (
    "format" => $format,
    "jsonp" => $jsonp,
    "numPerPage" => $numPerPage,
    "pageNum" => $pageNum,
    "ptime" => $ptime,
    "tag" => $tag
);
$str="";
foreach ($post_data as $key => $value){
    if (!empty($value)) {
        $str.=$key."=".$value."&";
    }else{
        unset($post_data[$key]); 
    }
}
$str=substr($str, 0,strlen($str)-1);
$str.=$secretkey;
// echo $str;
// die();
$hash=strtoupper(sha1($str));
$post_data["sign"] = $hash;
// var_dump($post_data);
// exit();
$url="http://api.polyv.net/v2/video/{$userid}/search";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
$output = curl_exec($ch);
curl_close($ch);
print_r($output);
?>
```

### 返回结果

```xml
<xml>
	<code>200</code>
	<status>success</status>
	<message>success</message>
	<data>
		<tag>刘诗昆,110435</tag>
		<mp4>http://mpv.videocc.net/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_1.mp4</mp4>
		<title>刘诗昆钢琴教程4</title>
		<df>1</df>
		<times>68</times>
		<vid>9f1e0689e1a156fc6b373eab9195b0c6_9</vid>
		<mp4_1>http://mpv.videocc.net/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_1.mp4</mp4_1>
		<cataid>1470122811372</cataid>
		<swf_link>http://player.polyv.net/videos/9f1e0689e1a156fc6b373eab9195b0c6_9.swf</swf_link>
		<status>60</status>
		<seed>0</seed>
		<playerwidth>600</playerwidth>
		<duration>00:35:52</duration>
		<first_image>http://img.videocc.net/uimage/9/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_5.jpg</first_image>
		<original_definition>384x294</original_definition>
		<context></context>
		<playerheight>458</playerheight>
		<ptime>2016-04-28 12:11:10</ptime>
		<source_filesize>65153042</source_filesize>
		<filesize>69789952</filesize>
		<md5checksum>b6dc8cd9ac9f189e5e2efeba8fd62d9b</md5checksum>
		<hls>http://hls.videocc.net/9f1e0689e1/9/9f1e0689e1a156fc6b373eab9195b0c6_1.m3u8</hls>
	</data>
</xml>
```

### JSON示例

```json
{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": [
    {
      "tag": "刘诗昆,110435",
      "mp4": "http://mpv.videocc.net/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_1.mp4",
      "title": "刘诗昆钢琴教程4",
      "df": 1,
      "times": "68",
      "vid": "9f1e0689e1a156fc6b373eab9195b0c6_9",
      "mp4_1": "http://mpv.videocc.net/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_1.mp4",
      "cataid": "1470122811372",
      "swf_link": "http://player.polyv.net/videos/9f1e0689e1a156fc6b373eab9195b0c6_9.swf",
      "status": "60",
      "seed": 0,
      "playerwidth": "600",
      "duration": "00:35:52",
      "first_image": "http://img.videocc.net/uimage/9/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_5.jpg",
      "original_definition": "384x294",
      "context": "",
      "playerheight": "458",
      "ptime": "2016-04-28 12:11:10",
      "source_filesize": 65153042,
      "filesize": [
        69789952
      ],
      "md5checksum": "b6dc8cd9ac9f189e5e2efeba8fd62d9b",
      "hls": [
        "http://hls.videocc.net/9f1e0689e1/9/9f1e0689e1a156fc6b373eab9195b0c6_1.m3u8"
      ]
    }
  ]
}
```

### 字段说明

| 字段                   | 说明                       |
| -------------------- | ------------------------ |
| code                 | 返回码                      |
| status               | 返回状态                     |
| message              | 返回信息                     |
| total                | 总数                       |
| tag                  | 标签                       |
| mp4                  | mp4格式视频地址                |
| title                | 标题                       |
| df                   | 视频码率数                    |
| times                | 播放次数                     |
| vid                  | 视频id                     |
| mp4\_1               | 流畅码率mp4格式视频地址            |
| cataid               | 分类id， 如1为根目录             |
| swf\_link            | 返回flash链接                |
| status               | 视频状态                     |
| seed                 | 加密视频为1，非加密为0             |
| playerwidth          | 视频宽度                     |
| duration             | 时长                       |
| first\_image         | 视频首图                     |
| original\_definition | 最佳分辨率                    |
| context              | 视频描述                     |
| playerheight         | 视频高度                     |
| ptime                | 视频上传日期                   |
| source\_filesize     | 源文件大小                    |
| filesize             | 编码后各个清晰度视频的文件大小，类型为array |
| md5checksum          | md5校验码                   |
| hls                  | m3u8地址                   |

### sign的生成规则

format=参数\&jsonp=参数\&numPerPage=参数\&pageNum=参数\&ptime=参数\&tag=参数secureKey经过SHA-1加密再经过大写化 (注意：参数为空时，则在生成sign的时候不需要添加此字段。例如如果这里没有t，则不需要拼接\&t=参数)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://polyv.gitbook.io/document/docs/unclassified/2017/e1a316d3456f67a137968b2d9230ba07.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.