搜索-创意视频

通过视频编号、关键词或其他筛选条件获取 创意视频结果集合及排序序列

接口地址(URI):/api/videos/search/creative

HTTP请求方式:GET

请求参数:
请求值字段 必选 类型 说明
id false string 视频编号,只传id时,keyword可为空.
keyword true string 关键词搜索。支持多关键词搜索,多关键词用空格分隔
sort false string 排序,best 最佳;time最新
gender 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.老年
license_type false string 授权类型。参数值:rf ,rr RF:非特定使用范围 RR:限定用途类
options false string 根据原视频类型进行筛选:0-360p;1-sd; 2-1080p; 3-4k; 5-720p; 6-6k; 8-8k。多个之间用半角逗号分隔。eg:2,3,6,8
color_type false integer 根据视频的色彩类别进行筛选:1=黑白2=彩色
shot_speed false string 根据视频的播放速度进行筛选: 多个值用逗号分隔。eg:1,2 0=实时1=延时2=慢镜 4=航拍 5=360 6=微观 7=水下 8=特效
shooting_age false integer 根据视频的拍摄年代进行筛选:1=当代影片;2=档案影片
special_shot_type false string 视频方向:1-横视频,2-竖视频
fps_type false string 帧速:多个值用逗号隔开.eg:1,2 1=23.98 2=24 3=25 4=29.97 5=30 6=50 7=59.94 8=60
duration false string 时长(时分秒) 支持区间查询和单个查询 区间查询用半角逗号分割. eg: 1,10 (查询等于1~10秒的视频) 单个查询直接写. eg: 12 (查询等于12秒的视频)
compose_type false string 构图类型: 1特写 2中景 3广角 多个值用逗号隔开 .eg:1,2
angle_type false string 视角:多个值用逗号隔开 .eg:1,2 1固定机位 2滑轨镜头 3航拍视角 4高视角 5低视角 6侧面像 7第一人称 8注视镜头
page false integer 第几页,仅支持输入数字. 默认值 1
nums false integer 每页返回数量 最小值 10. 最大值 100. 默认值 100
返回参数:
返回字段 说明
res_id 视频编号
title 视频标题
options 原视频分辨率. 0-360p;1-sd; 2-1080p; 3-4k; 5-720p; 6-6k; 8-8k
license_type 授权类型。返回值:RF ,RR RF:非特定使用范围 RR:限定用途类
clip_length 视频时长,单位秒
preview_video_https 预览视频地址(https)
small_jpg_https 视频封面图片地址(https)
small_frame_jpg_https 视频预览图片地址(https)。 多张预览图片以“,”分隔
total_count 返回结果总数
total_page 返回结果总页数
per_page 每页结果总数
cur_page 当前页码
请求参数示例example value:
Curl: curl -X GET --header 'Accept: application/json' --header 'api-key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' --header 'authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' 'https://api.fotomore.com/api/videos/search/creative?keyword=test&page=1&nums=10'
Request URL:
https://api.fotomore.com/api/videos/search/creative?keyword=test&page=1&nums=10
返回数据示例example value:

{
    "status_code": 1,
    "message": "ok",
    "data": {
        "list": [
            {
                "res_id": "VCG42N1166800751",
                "title": "试管中的血液样本",
                "options": 3,
                "license_type": "RF",
                "clip_length": "00:00:10",
                "preview_video_https": "https://video-static-api.fotomore.com/videos/mts_videos/preview/temp/VCG42N1166800751.mp4?uid=484&timestamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d",
                "small_jpg_https": "https://video-static-api.fotomore.com/videos/snapshot/VCG42N1166800751_1.jpg?uid=484&timestamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d",
                "small_frame_jpg_https": "https://video-static-api.fotomore.com/videos/snapshot/VCG42N1166800751_1.jpg?uid=484&timestamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d,https://video-static-api.fotomore.com/videos/snapshot/VCG42N1166800751_2.jpg?uid=484&timestamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d,https://video-static-api.fotomore.com/videos/snapshot/VCG42N1166800751_3.jpg?uid=484&timestamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d,https://video-static-api.fotomore.com/videos/snapshot/VCG42N1166800751_4.jpg?uid=484&timestamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d,https://video-static-api.fotomore.com/videos/snapshot/VCG42N1166800751_5.jpg?uid=484&timestamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d"
            },
            {
                ......
            },
            {
                "res_id": "VCG42N1074276628",
                "title": "邮票测试,阿尔法哑光",
                "options": 2,
                "license_type": "RF",
                "clip_length": "00:00:12",
                "preview_video_https": "https://video-static-api.fotomore.com/videos/mts_videos/preview/temp/VCG42N1074276628.mp4?uid=484&timestamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d",
                "small_jpg_https": "https://video-static-api.fotomore.com/videos/snapshot/VCG42N1074276628_1.jpg?uid=484&timestamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d",
                "small_frame_jpg_https": "https://video-static-api.fotomore.com/videos/snapshot/VCG42N1074276628_1.jpg?uid=484&timestamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d,https://video-static-api.fotomore.com/videos/snapshot/VCG42N1074276628_2.jpg?uid=484&timestamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d,https://video-static-api.fotomore.com/videos/snapshot/VCG42N1074276628_3.jpg?uid=484&timestamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d,https://video-static-api.fotomore.com/videos/snapshot/VCG42N1074276628_4.jpg?uid=484&timestamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d,https://video-static-api.fotomore.com/videos/snapshot/VCG42N1074276628_5.jpg?uid=484&timestamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d"
            }
        ],
        "total_count": 89910,
        "total_page": 8991,
        "per_page": 10,
        "cur_page": 1
    }
}