相关推荐

最近更新时间：2023.08.07 11:17:30

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

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

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

说明

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

实现方案	优点	缺点	整体建议
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	参见“错误码”说明
req_id	本次请求标识	String	惟一标识本次请求，火山引擎侧使用该字段进行具体问题追踪和排查
msg	本次请求是否成功	String	success：成功
data	内容列表	List	相关推荐内容列表

请求示例

curl --location --request GET 'https://stream-api.feedcoopapi.com/data/stream/related/v2/?signature=68557e0028c56f5c2f9ea3053781ad9304f69900&timestamp=1656393407&nonce=894038&partner=server_sdk_demo_default_content&access_token=AGDp7e07nCdc4vmzfSVHkmcXYTkSB6rwjDV9Aq1anaPdxLz3UM16Pi8JWJxPh6ejxsoydiP62&group_id=7111713150227251725&count=4'

响应示例

{
    "ret": 0,
    "msg": "success",
    "req_id": "20220628170427010211216154211EB830",
    "data": [{
            "group_id": 7112392482754953758,
            "group_id_str": "7112392482754953758",
            "abstract": "猞猁体型比狼小，...",
            "title": "猞猁真的是狼的天敌吗？为什么能将狼群杀到“断子绝孙”？",
            "url": "https://toutiao.com/group/7112392482754953758/",
            "publish_time": 1655983152,
            "behot_time": 1655983152,
            "source": "半桶",
            "has_video": false,
            "digg_count": 237,
            "comment_count": 3,
            "video_watch_count": 0,
            "image_list": [
                {
                    "height": 196,
                    "mimetype": "jpeg",
                    "uri": "tos-cn-i-qvj2lq49k0/21fab5b6d35b42828ee69c1a7dc91931",
                    "url": "http://p3-open.byteimg.com/tos-cn-i-qvj2lq49k0/21fab5b6d35b42828ee69c1a7dc91931~tplv-tt-cover-cut:300:196.jpeg?from=feed",
                    "width": 300
                },
                {...},
                {...}
            ],
            "middle_image": {
                "height": 196,
                "mimetype": "jpeg",
                "uri": "tos-cn-i-qvj2lq49k0/21fab5b6d35b42828ee69c1a7dc91931",
                "url": "http://p3-open.byteimg.com/tos-cn-i-qvj2lq49k0/21fab5b6d35b42828ee69c1a7dc91931~tplv-tt-cover-cut:300:196.jpeg?from=feed",
                "width": 300
            },
            "large_image_list": [
                {
                    "height": 360,
                    "mimetype": "jpeg",
                    "uri": "tos-cn-i-qvj2lq49k0/21fab5b6d35b42828ee69c1a7dc91931",
                    "url": "http://p3-open.byteimg.com/tos-cn-i-qvj2lq49k0/21fab5b6d35b42828ee69c1a7dc91931~tplv-tt-cover-cut:640:360.jpeg?from=feed",
                    "width": 640
                },
                {...},
                {...}
            ],
            "article_class": "图文",
            "article_url": "...",
            "comment_url": "https://open.toutiao.com/a7112392482754953758/comment/?...",
            "share_url": "https://open.toutiao.com/...",
            "user_info": {
                "avatar_url": "https://p3-open.onewsimg.com/img/...",
                "description": "但为君故",
                "follow": false,
                "followers_count": 63536,
                "home_page": "https://open.toutiao.com/u2480123820639271/?...",
                "name": "半桶",
                "user_id": 2480123820639271,
                ...
            },
            "article_read_count": 8636
        },
        {...},
        {...},
        {...}
    ]
}

请求参数

响应参数

请求示例

响应示例

内容定制

相关推荐

请求参数

响应参数

请求示例

响应示例