获取个性化内容

客户侧调用该接口获取个性化推荐的内容，目前支持的内容体裁有图文、横版短视频、竖版小视频。
每次请求，火山引擎侧默认返回的内容条数在6-15条不等，内容信息包括内容标题、封面图，作者名称、阅读数、播放量、发布时间、点赞数、分享数等，客户侧可使用这些数据，自定义实现UI效果。

请求方式

请求方法

GET/POST(Content-Type: application/x-www-form-urlencoded)

请求url

https://mercury.volcengineapi.com/?Action=ContentStreamV2&Version=2021-01-01

请求header

ServiceName:content

请求参数

响应参数

除了“公共参数”外，Result结构

请求示例

public static void main(String[] args) {
        //初始化一个service
        StreamService streamService = StreamServiceImpl.getInstance();

        //设置ak，sk 此为请求的凭证
        streamService.setAccessKey("ak");
        streamService.setSecretKey("sk");

        //初始化一个request
        GetListRequest req = new GetListRequest();
        req.setTimestamp(LocalDateTime.now().toEpochSecond(ZoneOffset.of("+8")));
        req.setAccessToken("accessToken");
        req.setCategory("category");
        req.setPartner("partner");
        req.setOs("ios");
        req.setClientVersion("3.1.1");
        try {
            GetListResponseV2 response = streamService.getListV2(req);
            System.out.println(JSON.toJSONString(response));
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

响应示例

{
    "ResponseMetadata": {
        "RequestId": "20231115205304BC70AF85A8C20B1B4FCD",
        "Action": "ContentStreamV2",
        "Version": "2021-01-01",
        "Service": "content",
        "Region": "cn-beijing",
        "Error": {
            "CodeN": 0,
            "Code": "",
            "Message": ""
        }
    },
    "Result": [
        {
            "Abstract": "",
            "ArticleType": "短视频",
            "ArticleUrl": "https://open.toutiao.com/a7297943953491132963/?***",
            "CommentUrl": "https://open.toutiao.com/a7297943953491132963/comment/?***",
            "CoverImages": [
                {
                    "Url": "https://p9-open-sign.byteimg.com/***",
                    "Height": 540,
                    "Width": 960
                }
            ],
            "CoverMode": 1,
            "DiggCount": 1,
            "GroupId": "7297943953491132963",
            "HasVideo": true,
            "PublishTime": 1699184988,
            "ShareUrl": "https://open.toutiao.com/a7297943953491132963/?***",
            "Title": "#不止好酒更有健康  #陕西吃啥更攒劲  #中国劲酒 羊肉配劲酒",
            "UserInfo": {
                "AvatarUrl": "https://p3-open-sign.onewsimg.com/user-avatar/***",
                "Description": "情感生活能量\n唱响优质生活，感谢平台，欢迎大家关注",
                "Follow": false,
                "FollowerCount": 100215,
                "HomePage": "https://open.toutiao.com/u941622862552752/?***",
                "Name": "***",
                "UserId": 941622862552752,
                "UserVerified": false,
                "VerifiedContent": ""
            },
            "VideoWatchCount": 381,
            "VideoDetail": {
                "VideoDuration": 40.17,
                "VideoList": [
                    {
                        "Url": "http://partner.365yg.com/video/url/?***",
                        "Height": 720,
                        "Width": 1280,
                        "Definition": "720p"
                    }
                ]
            },
            "IsStick": false,
            "FilterWords": [
                {
                    "Id": "8:0",
                    "Name": "看过了"
                },
               ...
            ],
            "DataSource": "stream3"
        }
    ]
}

示例效果图

图文	视频

本地频道-城市列表

当请求“本地”频道时，需要同时传入City，目前支持的城市如下