搜索VCG创意图片

通过搜索图片id、关键词或查询条件获取图片排序结果。

接口地址(URI):/api/search/creative(创意图片)

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)、近期热门(fresh)
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=彩色
gander false integer 根据人物性别查询:1-男人;2-女人
race false integer 根据人种筛选:1=中国人;2=亚洲人;3=东方人;4=白色种人;5=黑色种人;6=混血儿;7=中东人
people_num false integer 根据图片包含的人数筛选:1=无人;2=一个人;3=两个人;4=三个人;5=很多人
people_age false integer 根据图片包含的人的年龄筛选:1.婴儿,2.儿童,3.少年,4.青年,5.中年,6.老年
asset_format false string 根据图片格式查询:jpg;png;gif;eps;ai;psd(不传则搜全部)
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: e584cc62649ffc9ae10208740dc69b3d' --header 'authorization: Bearer 3c49441c96560fbbecdf68f90c43b8778eb16a6e0df71424c797a9635da594af' 'http://api-v1.vcg.com/api/search/creative?orientation=1&color_type=2'

Request URL:http://api-v1.vcg.com/api/search/creative?orientation=1&color_type=2
返回数据示例example value:
{
"status_code": 1,
"message": "ok",
"data": {
"list": [
{
"id": "VCG41N960976922",
"view_id": 1169575882,
"title": "Panoramic view of mountains against cloudy sky",
"caption": "USA, Alaska, Anchorage",
"width": 12045,
"height": 3000,
"brandid": 12579,
"license_type": "rf",
"asset_format": "jpg",
"graphical_style": 1,
"online_time": "2018-09-29 18:24:32",
"small_url": "http://photo.static.api.vcg.com/creative/vcg/176/new/VCG41N960976922.jpg",
"preview_url": "http://photo.static.api.vcg.com/creative/vcg/400/new/VCG41N960976922.jpg"
},
{
"id": "VCG41N961089256",
"view_id": 1169556354,
"title": "Rear view of young couple standing on field against sky during sunset",
"caption": "USA, Colorado, Golden",
"width": 5281,
"height": 3521,
"brandid": 12579,
"license_type": "rf",
"asset_format": "jpg",
"graphical_style": 1,
"online_time": "2018-09-29 17:30:10",
"small_url": "http://photo.static.api.vcg.com/creative/vcg/176/new/VCG41N961089256.jpg",
"preview_url": "http://photo.static.api.vcg.com/creative/vcg/400/new/VCG41N961089256.jpg"
},
{
"id": "VCG41N960999092",
"view_id": 1169559590,
"title": "Cheerful mother embracing son while boy standing in foreground",
"caption": "Ukraine",
"width": 7360,
"height": 4912,
"brandid": 12579,
"license_type": "rf",
"asset_format": "jpg",
"graphical_style": 1,
"online_time": "2018-09-29 17:43:05",
"small_url": "http://photo.static.api.vcg.com/creative/vcg/176/new/VCG41N960999092.jpg",
"preview_url": "http://photo.static.api.vcg.com/creative/vcg/400/new/VCG41N960999092.jpg"
},
{
"id": "VCG41N958312686",
"view_id": 1169559491,
"title": "Rear view of friends on field against mountains",
"caption": "Russia",
"width": 7360,
"height": 4912,
"brandid": 12579,
"license_type": "rf",
"asset_format": "jpg",
"graphical_style": 1,
"online_time": "2018-09-29 17:42:49",
"small_url": "http://photo.static.api.vcg.com/creative/vcg/176/new/VCG41N958312686.jpg",
"preview_url": "http://photo.static.api.vcg.com/creative/vcg/400/new/VCG41N958312686.jpg"
},
{
"id": "VCG41N958287466",
"view_id": 1169559717,
"title": "Side view of man looking at plant in damaged greenhouse",
"caption": "USA, New York State",
"width": 5616,
"height": 3744,
"brandid": 12579,
"license_type": "rf",
"asset_format": "jpg",
"graphical_style": 1,
"online_time": "2018-09-29 17:43:17",
"small_url":
"http://photo.static.api.vcg.com/creative/vcg/176/new/VCG41N958287466.jpg",
"preview_url": "http://photo.static.api.vcg.com/creative/vcg/400/new/VCG41N958287466.jpg"
},
],
"total_count": 710533,
"total_page": 7106,
"per_page": "100",
"cur_page": "1"
}
}
返回值字段 字段说明
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技术团队会与您联系