本接口主要用于有搜索场景需求的客户，通过搜索词查询相关内容，目前支持搜索的内容体裁包括图文、横版短视频、竖版小视频。
若不指定返回条数count，则默认每次最多返回10条内容。返回的内容信息包括标题、封面图、发布时间、视频时长、作者名称与头像等，客户侧可使用这些数据，自定义实现搜索页UI。
| 请求结构 | 说明 |
|---|---|
| 请求域名 | stream-api.feedcoopapi.com |
| 请求地址 | /data/stream/search/v4/ |
| 请求协议 | HTTP/HTTPS |
| 请求方式 | GET |
| 参数类型 | application/x-www-form-urlencoded |
| 参数 | 描述 | 类型 | 是否必填 | 说明 |
|---|---|---|---|---|
| keyword | 搜索字符串 | String | 是 | |
| offset | 分页起始 | int | 否 | 默认为0，用于翻页，当has_more为true时，offset=当前偏移量+count |
| count | 每页数量 | int | 否 | 指定返回数据条数，最大不超过20，默认返回10条。 |
| need_group_types | 内容类型 | String | 否 | 用于指定搜索的内容类型，图文：tuwen，横版短视频：xigua_video，竖版小视频：short_video，多选用英文逗号分隔。 |
| search_id | 搜索ID | String | 否 | 客户侧搜索id，代表本次搜索的唯一ID |
参数 | 描述 | 类型 | 说明 |
|---|---|---|---|
ret | 响应结果 | long | 参见“错误码”说明 |
msg | 本次请求是否成功 | String | success：成功 |
req_id | 本次请求标识 | String | 惟一标识本次请求，火山引擎侧使用该字段进行具体问题追踪和排查 |
search_id | 搜索ID | String | 代表本次搜索的唯一ID |
has_more | 是否加载更多 | boolean | true：是，加载更多； false：否，已全部加载完毕，没有更多 |
data | 搜索结果列表 | List | 返回的搜索内容列表 |
GET /data/stream/search/v4/?access_token=xxx×tamp=1695624033&signature=xxx&nonce=123&partner=xxx&keyword=xxx&offset=0&count=10 HTTP/1.1 Host: stream-api.feedcoopapi.com
{ "ret": 0, "msg": "success", "req_id": "202309251442051A590A80E0B16903BFBE", "search_id": "3227dbc4897d403f61469535a71f6642", "has_more": true, "data": [ { "abstract": "", "article_type": "小视频", "article_url": "https://feedcoop.douyin.com/d7248210575673737788/?...", "comment_count": 2, "comment_url": "https://feedcoop.douyin.com/d7248210575673737788/comment/?...", "cover_images": [ { "url": "https://p6-open-sign.onewsimg.com/tos-cn-p-0015/c41944c27a5c4c34aca383a031111944_1687605492~tplv-tt-cut:1080:1920.jpeg?scene=search&x-expires=1758696126&x-signature=uPUk3Uz9q%2B2CVmqrAycKyFD5cOU%3D", "height": 1920, "width": 1080 } ], "cover_mode": 1, "digg_count": 92575, "group_id": "7248210575673737788", "has_video": true, "publish_time": 1687605487, "share_count": 3880, "share_url": "https://feedcoop.douyin.com/d7248210575673737788/?...", "title": "xxx", "user_info": { "avatar_url": "https://p3-open-sign.onewsimg.com/aweme-avatar/tos-cn-avt-0015_0508c47a0e949dc3e5b7886d19b0c8a6~tplv-obj.jpeg?scene=core&x-expires=1758696110&x-signature=eC%2Bvkr9Zi4QW2NHh%2B4aVKplISAo%3D", "description": "会说会笑，浑身带着骄傲🇨🇳\n去发光，而不是被照亮\n我愿先颠沛流离，再遇见温暖的你🤍\n🤝商务🛰️：MQ891088（备注品牌）", "follow": false, "follower_count": 1695633, "home_page": "https://feedcoop.douyin.com/u67187729583/?...", "name": "xxx", "user_id": 67187729583, "user_verified": true, "verified_content": "情感自媒体" }, "video_watch_count": 7279436, "video_detail": { "video_duration": 126.967, "video_list": [ { "url": "http://open.toutiao.com/video/url/v1/?...", "height": 640, "width": 360, "definition": "360p" } ] } },... ] }