You need to enable JavaScript to run this app.
导航
内容定制
  • 文档首页
    • /
  • 内容定制

相关推荐

最近更新时间：2023.09.25 16:53:59

首次发布时间：2021.04.09 18:31:35

我的收藏

火山引擎提供的H5详情页默认自带了相关推荐，当您需要实现Native的相关推荐时，可以通过此接口获取相关推荐数据，并自主实现UI。

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

说明

建议以Native方式实现相关推荐，对比详情页自带的H5相关推荐，UI自定义能力更强，数据上报更准确，更有助于推荐。

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

请求参数

参数描述类型是否必填说明
group_id内容idlong是获取此内容的相关推荐内容

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"
                    }
                ]
            }
        }
    ]
}