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=否
请求参数示例example value:
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
返回数据示例example value:
{
"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 当前页码
留下您的信息,我们的API技术团队会与您联系