PA产品搜索
通过搜索图片id、关键词或查询条件获取PA图片排序结果。搜索出的结果范围不会超出当前账号所授权的PA产品包范围。
接口地址(URI):/api/pa/creative/search
HTTP请求方式:GET
请求值字段 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
api-key | true | string | API用户鉴权 id |
authorization | true | string | Bearer+空格+access token值 |
id | false | string | 图片id |
keyword | false | string | 关键词搜索。支持多关键词搜索,and条件。多关键词用空格分隔 |
Keyword_or | false | string | 关键词搜索。支持多关键词搜索,or条件。多关键词用空格分隔 |
keyword_not | false | string | 键词排除。支持多关键词,not条件。多关键词用空格分隔 |
sort | false | string | 排序方式:最佳匹配(best)、最新(time) |
sort_by | false | string | 排序方式:正序、倒序,输入:asc/desc |
license_type | false | string | 根据图片版权的授权方式筛选,输入:RM/RF |
brand_id | false | string | 根据品牌id进行筛选,最多输入20个brand id |
orientation | false | string | 根据构图方式查询:1横图、2竖图、3方图(仅支持输入数字,为空则搜索全部) |
color_type | false | string | 根据色彩属性查询:1=黑白、2=彩色 |
asset_format | false | string | 根据图片格式查询:jpg、eps(eps是矢量图的一种格式,为空则搜索全部) |
graphical_style | false | string | 图片类型:1-摄影图片 2-插画 3-漫画 4-图表 5-矢量图 6-psd 7-普通全景 8-360全景 9-gif 10-模板(仅支持输入数字,为空则搜索全部) |
page | false | integer | 哪一页,仅支持输入数字(最大1000) |
nums | false | integer | 每页数据的最大条目数,默认为100(字段为空时),仅支持输入数字 |
online_time_start | false | string | 根据“上线时间”筛选(最多支持3天,上线时间的起始日期。(eg:2017-02-02) |
online_time_end | false | string | 根据“上线时间”筛选(最多支持3天),上线时间的结束日期。(eg:2017-02-05) |
main_colors | false | string | 根据图片的色彩值进行筛选,输入7位十六进制编码,如:#FFB6C1 |
is_need_middle | false | boolean | 是否需要返回长边800的预览图地址(有水印)。true=是,false=否 |
Curl -X GET --header 'Accept: text/html' --header 'api-key: cdad7b5c5611aa57a1e84bb1556de88d' --header 'authorization: Bearer efd44de1ed958808173121fa60f02c23a030f8ced7010ee917549b9fca4c9e43' 'http://api-v1.vcg.com/api/pa/creative/search?keyword=%E5%8C%97%E4%BA%AC&page=6&nums=1'
Request URL:http://api-v1.vcg.com/api/pa/creative/search?keyword=%E5%8C%97%E4%BA%AC&page=6&nums=1
Request URL:http://api-v1.vcg.com/api/pa/creative/search?keyword=%E5%8C%97%E4%BA%AC&page=6&nums=1
{
"status_code": 1,
"message": "ok",
"data": {
"list": [
{
"id": "VCG41N627469912",
"view_id": 1031180051,
"title": "Duck Noodles",
"caption": null,
"width": 6000,
"height": 4000,
"brandid": 11913,
"license_type": "rf",
"asset_format": "jpg",
"graphical_style": 1,
"online_time": "2017-08-08 08:53:45",
"small_url": "http://photo.static.api.vcg.com/creative/vcg/veer/176/new/VCG41N627469912.jpg",
"preview_url": "http://photo.static.api.vcg.com/creative/vcg/veer/400/new/VCG41N627469912.jpg"
},
{
"id": "VCG41N627469886",
"view_id": 1031179917,
"title": "Duck Noodles",
"caption": null,
"width": 4000,
"height": 6000,
"brandid": 11913,
"license_type": "rf",
"asset_format": "jpg",
"graphical_style": 1,
"online_time": "2017-08-08 08:53:22",
"small_url": "http://photo.static.api.vcg.com/creative/vcg/veer/176/new/VCG41N627469886.jpg",
"preview_url": "http://photo.static.api.vcg.com/creative/vcg/veer/400/new/VCG41N627469886.jpg"
}
],
"total_count": 31961,
"total_page": 31961,
"per_page": "1",
"cur_page": "2"
}
}
"status_code": 1,
"message": "ok",
"data": {
"list": [
{
"id": "VCG41N627469912",
"view_id": 1031180051,
"title": "Duck Noodles",
"caption": null,
"width": 6000,
"height": 4000,
"brandid": 11913,
"license_type": "rf",
"asset_format": "jpg",
"graphical_style": 1,
"online_time": "2017-08-08 08:53:45",
"small_url": "http://photo.static.api.vcg.com/creative/vcg/veer/176/new/VCG41N627469912.jpg",
"preview_url": "http://photo.static.api.vcg.com/creative/vcg/veer/400/new/VCG41N627469912.jpg"
},
{
"id": "VCG41N627469886",
"view_id": 1031179917,
"title": "Duck Noodles",
"caption": null,
"width": 4000,
"height": 6000,
"brandid": 11913,
"license_type": "rf",
"asset_format": "jpg",
"graphical_style": 1,
"online_time": "2017-08-08 08:53:22",
"small_url": "http://photo.static.api.vcg.com/creative/vcg/veer/176/new/VCG41N627469886.jpg",
"preview_url": "http://photo.static.api.vcg.com/creative/vcg/veer/400/new/VCG41N627469886.jpg"
}
],
"total_count": 31961,
"total_page": 31961,
"per_page": "1",
"cur_page": "2"
}
}
返回值字段 | 字段说明 |
---|---|
id | 图片res id |
view_id | 图片的主键id |
title | 图片的标题 |
caption | 该图片的说明 |
width | 图片的原图宽度 |
height | 图片的原图高度 |
brandid | 图片所属的品牌id |
license_type | 图片的授权类型(RM/RF) |
asset_format | 图片的格式,如:jpg |
graphical_style | 图片类型:1-摄影图片 2-插画 3-漫画 4-图表 5-矢量图 6-psd 7-普通全景 8-360全景 9-gif 10-模板 |
online_time | 图片的上线时间 |
small_url | 图片的缩略图地址(尺寸:长边176) |
preview_url | 图片的预览图地址(尺寸:长边400) |
total_count | 返回结果总数 |
total_page | 返回结果总页数 |
per_page | 每页结果总数 |
cur_page | 当前页码 |