搜索-资讯视频

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

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

HTTP请求方式:GET

请求参数:
请求值字段 必选 类型 说明
id false string 视频编号,只传id时,keyword可为空.
keyword true string 关键词搜索。支持多关键词搜索,多关键词用空格分隔
sort_by false string 排序方式:正序、倒序,输入:asc/desc
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 string 根据视频的色彩类别进行筛选:1=黑白2=彩色
shooting_age false integer 根据视频的拍摄年代进行筛选:1=当代影片;2=档案影片
special_shot_type false string 视频方向:1-横视频,2-竖视频
channel_id false string 根据分类id进行筛选,最多输入20个channel_id,多个channel_id之间用,分隔
page false integer 第几页,仅支持输入数字. 默认值 1
nums false integer 每页返回数量 最小值1. 最大值100. 默认值100.
返回参数:
返回字段 说明
res_id 视频编号
caption 视频说明
group_title 视频所在组标题
width 原视频尺寸:宽
height 原视频尺寸:高
asset_format 原视频文件的素材格式, 如mp4、mov、flv等
upload_time 上传时间
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 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' 'https://api.fotomore.com/api/videos/search/editorial?keyword=test&page=1&nums=10'
Request URL:
https://api.fotomore.com/api/videos/search/editorial?keyword=test&page=1&nums=10
返回数据示例example value:

{
    "status_code": 1,
    "message": "ok",
    "data": {
        "list": [
            {
                "res_id": "VCG1227040255",
                "caption": "2024年1月28日报道,周六,在中国北部内蒙古自治区锡林浩特市举行的那达慕冬季集市上,各种雪地赛马活动吸引了当地人和游客。Snowfield horse racing highlights winter Naadam in China’s Inner Mongolia\n\nA variety of snowfield horse racing events took place on Saturday during the winter Naadam fair in Xilinhot City, north China's Inner Mongolia Autonomous Region, attracting both locals and visitors.\n\nNaadam fair, meaning \"entertainment\" or \"recreation\" in Mongolian, is a mass traditional Mongolian festival mainly filled with sports events.\n\nAs the most anticipated sport at the fair, the 6,000-meter group relay horse racing event, held at Maodeng Ranch, attracted 104 teams from 13 counties of the region's Xilingol League to compete for top positions.\n\nIn winter, horses tire more easily, especially when running on thick snow-covered land. Competing riders not only need to fulfill specific tasks during the competition but also participate in long-distance endurance horse races, putting their strategy and skill to the test.\n\nAdditionally, some children aged seven to twelve were also competing alongside adults in the horse racing events. They showcased sophisticated horsemanship skills despite their small stature and captured the attention of spectators.\n\nAside from enjoying thrilling snowfield horse racing, visitors engaged in various winter Naadam activities firsthand like snow tug-of-war, snow archery, and other traditional Mongolian games.\n\n\nPublished : 2024-01-28",
                "group_title": "内蒙古冬季那达慕 各种雪上赛马活动吸引眼球",
                "width": 1920,
                "height": 1080,
                "asset_format": "mp4",
                "upload_time": "2024-02-01 11:05:02",
                "clip_length": "00:01:09",
                "preview_video_https": "https://video-static-api.fotomore.com/videos/mts_videos/preview/VCG1227040255.mp4?uid=484&timestamp=1708582889&sign=82c23cc7271a05686d3045b30fbab346",
                "small_jpg_https": "https://video-static-api.fotomore.com/videos/snapshot/229bc2b9222b4fd8bab1fec914b3a2f0.jpg?uid=484&timestamp=1708582889&sign=82c23cc7271a05686d3045b30fbab346",
                "small_frame_jpg_https": "https://video-static-api.fotomore.com/videos/snapshot/VCG1227040255_00001.jpg?uid=484&timestamp=1708582889&sign=82c23cc7271a05686d3045b30fbab346,https://video-static-api.fotomore.com/videos/snapshot/VCG1227040255_00002.jpg?uid=484&timestamp=1708582889&sign=82c23cc7271a05686d3045b30fbab346,https://video-static-api.fotomore.com/videos/snapshot/VCG1227040255_00003.jpg?uid=484&timestamp=1708582889&sign=82c23cc7271a05686d3045b30fbab346,https://video-static-api.fotomore.com/videos/snapshot/VCG1227040255_00004.jpg?uid=484&timestamp=1708582889&sign=82c23cc7271a05686d3045b30fbab346,https://video-static-api.fotomore.com/videos/snapshot/VCG1227040255_00005.jpg?uid=484&timestamp=1708582889&sign=82c23cc7271a05686d3045b30fbab346"
            },
            {
                ......
            },
            {
                "res_id": "VCG1226952986",
                "caption": "2024年1月20日,重庆,云阳县的实验室内,研究人员在工作。",
                "group_title": "重庆:世界首例克隆西藏濒危牛诞生",
                "width": 1920,
                "height": 1080,
                "asset_format": "mp4",
                "upload_time": "2024-01-29 14:24:10",
                "clip_length": "00:00:13",
                "preview_video_https": "https://video-static-api.fotomore.com/videos/mts_videos/preview/VCG1226952986.mp4?uid=484&timestamp=1708582889&sign=82c23cc7271a05686d3045b30fbab346",
                "small_jpg_https": "https://video-static-api.fotomore.com/videos/snapshot/VCG1226952986_00003.jpg?uid=484&timestamp=1708582889&sign=82c23cc7271a05686d3045b30fbab346",
                "small_frame_jpg_https": "https://video-static-api.fotomore.com/videos/snapshot/VCG1226952986_00001.jpg?uid=484&timestamp=1708582889&sign=82c23cc7271a05686d3045b30fbab346,https://video-static-api.fotomore.com/videos/snapshot/VCG1226952986_00002.jpg?uid=484&timestamp=1708582889&sign=82c23cc7271a05686d3045b30fbab346,https://video-static-api.fotomore.com/videos/snapshot/VCG1226952986_00003.jpg?uid=484&timestamp=1708582889&sign=82c23cc7271a05686d3045b30fbab346,https://video-static-api.fotomore.com/videos/snapshot/VCG1226952986_00004.jpg?uid=484&timestamp=1708582889&sign=82c23cc7271a05686d3045b30fbab346,https://video-static-api.fotomore.com/videos/snapshot/VCG1226952986_00005.jpg?uid=484&timestamp=1708582889&sign=82c23cc7271a05686d3045b30fbab346"
            }
        ],
        "total_count": 334,
        "total_page": 34,
        "per_page": 10,
        "cur_page": 1
    }
}