相关推荐--内容定制-火山引擎

文档中心

导航

请求结构	说明
请求域名	stream-api.feedcoopapi.com
请求地址	/data/stream/related/v3/
请求协议	HTTP/HTTPS
请求方式	GET/POST
参数类型	application/x-www-form-urlencoded

实现方案	优点	缺点	整体建议
Native	1.相关推荐列表页UI自定义能力更强； 2. 能够上报的信息更全	1. 开发成本相比h5高一些	建议
h5	1. 开发成本低一些	1.UI样式不支持自定义； 2. 上报的场景不全，比如home返回等，影响推荐效果 3.影响详情页停留时长统计，进而影响数据分析	不建议

请求参数

参数	描述	类型	是否必填	说明
group_id	内容id	long	是	获取此内容的相关推荐内容
count	返回内容条数	long	否	用于指定返回的相关推荐内容条数，最多支持20条。注意由于算法后置过滤等逻辑，会存在返回条数不足的情况。
dt	设备型号	String	否	如iphone5s、Galaxy。建议上传，主要用于推荐分析，提升推荐效果
device_brand	设备厂商	String	否	如Apple、Samsung。建议上传，主要用于推荐分析，提升推荐效果
os	操作系统	String	是	如 Android、IOS。主要用于推荐分析，提升推荐效果。注意：IOS系统如果没有正确传入此参数，返回的封面图可能为webp格式，导致图片解析失败。
os_version	操作系统版本	String	否	如4.0.4。建议上传，主要用于推荐分析，提升推荐效果。火山引擎侧内容详情页会根据此参数进行适配。
client_version	应用的版本号	String	是	比如1.0.1。主要用于数据排查，提升业务指标

响应参数

参数	描述	类型	说明
ret	响应结果	long	参见“错误码”说明
msg	本次请求是否成功	String	success：成功
req_id	本次请求标识	String	火山引擎侧使用该字段进行具体问题追踪和排查
data	内容数据	List	默认随机返回6-15条内容数据

请求示例

GET /data/stream/related/v3/?access_token=xxx&timestamp=1695624033&signature=xxx&nonce=123&partner=xxx&group_id=7266333499760902711&count=4&os=iOS&client_version=1.0.0 HTTP/1.1
Host: stream-api.feedcoopapi.com

响应示例

{
    "has_more": false,
    "ret": 0,
    "msg": "success",
    "req_id": "202309251509035E5445C47EC5BA0739D6",
    "data": [
        {
            "abstract": "",
            "article_type": "短视频",
            "article_url": "https://open.toutiao.com/a7132634247608828457/?...",
            "comment_count": 46,
            "comment_url": "https://open.toutiao.com/a7132634247608828457/comment/?...",
            "cover_images": [
                {
                    "url": "https://p9-open-sign.onewsimg.com/tos-cn-i-0004/757be58c15b749f8b85a495d7fadf297~tplv-tt-cut:1920:1080.jpeg?scene=related&x-expires=1758697744&x-signature=vQjASVhcnF0jY8XJx%2FKdv%2BKEznc%3D",
                    "height": 1080,
                    "width": 1920
                }
            ],
            "cover_mode": 1,
            "digg_count": 395,
            "group_id": "7132634247608828457",
            "has_video": true,
            "publish_time": 1660695822,
            "share_count": 194,
            "share_url": "https://open.toutiao.com/a7132634247608828457/?...",
            "title": "xxx",
            "user_info": {
                "avatar_url": "https://p3-open-sign.onewsimg.com/user-avatar/6e8eedbae9e344ddc3d412afb7c892a5~tplv-obj.jpeg?scene=core&x-expires=1758697690&x-signature=HbgIhglqicbZsIJ0zNSPe3qs8N0%3D",
                "description": "大家记得关注小慢哦",
                "follow": false,
                "follower_count": 1539046,
                "home_page": "https://open.toutiao.com/u6253057920/?...",
                "name": "xxx",
                "user_id": 6253057920,
                "user_verified": true,
                "verified_content": "优质美食领域创作者"
            },
            "video_watch_count": 23550,
            "video_detail": {
                "video_duration": 522.26,
                "video_list": [
                    {
                        "url": "http://open.toutiao.com/video/url/v1/?...",
                        "height": 360,
                        "width": 640,
                        "definition": "360p"
                    }
                ]
            }
        }
    ]
}