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

注意事项

• 使用限制
  • 个性化推荐接口耗时正常情况不超过1s，为容忍网络抖动或突发流量，超时时间建议设置为3s。
  • 尽量不要预加载，否则会造成内容浪费，影响推荐效果。如果您为了提升客户端体验流畅度进行了预加载，建议您将内容放到首页进行展现，可以更好的保障推荐效果。
  • 同一个用户需要对应唯一的用户标识，也就是在调用wap注册接口时，该用户的Uuid需要保持不变。否则将会被火山引擎侧推荐系统识别为新用户，进而影响推荐效果。涉及更改用户标识，请提前与火山引擎侧沟通，以免造成指标骤降。

请求说明

• 请求方式：GET/POST(Content-Type: application/x-www-form-urlencoded)
• 请求地址：https://mercury.volcengineapi.com/?Action=ContentStreamV2&Version=2021-01-01
• 请求头：ServiceName:content

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

请求示例

GET /?Action=ContentStreamV2&Version=2021-01-01&ApiVersion=4&Partner=demo_default_content&AccessToken=AT6zTZuXzffKpQamer***v8mp94LR2ARdNJBp2BT86GrLpa3brqLmscGCUipuJNh2piKTT12&Timestamp=1701426600&Category=demo_default_content_feed_1_1&Os=NtjujpKNq&ClientVersion=1.0.1 HTTP/1.1
Host: https://mercury.volcengineapi.com/?Action=ContentStreamV2&Version=2021-01-01
X-Date: 20240521T093019Z
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240521/cn-north-1/content/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20240521173035136141087197E3196B",
    "Action": "ContentStreamV2",
    "Version": "2021-01-01",
    "Service": "content",
    "Region": "cn-north-1"
  },
  "Result": [
    {
      "GroupId": "7304704552752808499",
      "Title": "标题",
      "ArticleUrl": "https://open.toutiao.com/a7304704552752808499/?a_t=AT6zTZuXzffKpQamerBxxx8mp94LR2ARdNJBp2BT86GrLpa3brqLmscGCUipuJNh2piKTT12&biz_log=BEdLU3JjyWmswjVzaF8hvsxLgnjbEP6zLUsiJHfs6w5z6Wk6ir6UZxxxN2wV9jhZwh9Qu7dWyP2UDG7JhkwBKoMRgPcHwKEhcUe6NHvktJMbjf52v7V9jPg1x6uwW55zLNbARdKGZNMDkKVkKFq9MjD8WbJZLh4KD7Px74WTCMVag8&category=xxx_default_content_feed_2_1&device_brand=&dt=&form_scen=FROM_CONTENT&group_id=7304704552752808499&item_id=7304704552752808499&label=xxx_default_content_feed_1_59&req_id=20240521xxx349B9F94600BD12654C6EB4&utm_campaign=open&utm_medium=webview&utm_source=xxx_default_content",
      "ArticleType": "短视频",
      "PublishTime": 1700759062,
      "Abstract": "-",
      "ShareUrl": "https://open.toutiao.com/a7304704552752808499/?a_t=AT6zTZuXzffKpQamerBKVv8mxxxLR2ARdNJBp2BT86GrLpa3brqLmscGCUipuJNh2piKTT12&biz_log=BEdLU3JjyWmswjVzaF8hvsxLgnjbEP6zLUsiJHfs6w5z6Wk6ir6UZDeSN2wV9jhZwh9Qu7dWyP2UDG7JhkwBKoMRgPcHwKEhcUe6NHvktJMbjf52v7V9jPg1x6uwW55zLNbARdKGZNMDkKVkKFq9MjD8WbJZLh4KD7Px74WTCMVag8&category=xxx_default_content_feed_2_1&device_brand=&dt=&form_scen=FROM_CONTENT&group_id=7304704552752808499&label=share&req_id=20240xxx162349B9F94600BD12654C6EB4&utm_campaign=open&utm_medium=webview&utm_source=xxx_default_content",
      "ShareCount": 10000,
      "HasVideo": true,
      "VideoWatchCount": 2000,
      "ArticleReadCount": 500,
      "DiggCount": 10000,
      "CommentCount": 500,
      "CommentUrl": "https://open.toutiao.com/a7304704552752808499/comment/?a_t=AT6zTZuXzffKpQamerBKVxxxp94LR2ARdNJBp2BT86GrLpa3brqLmscGCUipuJNh2piKTT12&biz_log=BEdLU3JjyWmswjVzaF8hvsxLgnjbEP6zLUsiJHfs6w5z6Wk6ir6UZDeSN2wV9jhZwh9Qu7dWyP2UDG7JhkwBKoMRgPcHwKEhcUe6NHvktJMbjf52v7V9jPg1x6uwW55zLNbARdKGZNMDkKVkKFq9MjD8WbJZLh4KD7Px74WTCMVag8&category=xxx_default_content_feed_2_1&device_brand=&dt=&form_scen=FROM_CONTENT&group_id=7304704552752808499&label=xxx_default_content_feed_1_59&req_id=20240521162349B9xxx600BD12654C6EB4&utm_source=xxx_default_content",
      "IsStick": true,
      "CoverMode": 1,
      "CoverImages": [
        {
          "Url": "https://p6-open-sign.byteimg.com/tos-cn-i-pk90l89vgd/1c6a1776374c4486a46a5a5cbb145ffa~tplv-tt-cut:3216:1810.jpeg?scene=content&x-expires=1747815830&x-signature=ElLytAjeIfSe2O2WkFMqOBY2VUw%3D",
          "Width": 3216,
          "Height": 1810
        }
      ],
      "FilterWords": [
        {
          "Id": "-",
          "Name": "-"
        }
      ],
      "UserInfo": {
        "AvatarUrl": "-",
        "Description": "-",
        "HomePage": "-",
        "Name": "-",
        "Follow": true,
        "FollowerCount": 0,
        "UserId": "-",
        "UserVerified": true,
        "VerifiedContent": "-"
      },
      "ArticleClassification": [
        [
          "科学科技",
          "科技",
          "互联网"
        ],
        [
          "科学科技",
          "科学"
        ]
      ],
      "VideoDetail": {
        "VideoDuration": 2230.115,
        "VideoList": [
          {
            "Definition": "360p",
            "Height": 360,
            "Width": 640,
            "Url": "http://mercury.snssdk.com/video/url/?param=ZvBxCXQxxxA6yK2je&partner=xxx_default_content&version=2&trans_vdata_to_content=1"
          }
        ]
      },
      "ProductUnion": [
        {
          "ProductId": "product1",
          "UnionReason": "-",
          "ProductExtra": "-",
          "ProductType": "general"
        }
      ],
      "ContentImageList": [
        {
          "Url": "https://p6-open-sign.byteimg.com/tos-cn-i-pk90l89vgd/1c6a1776374c4486a46a5a5cbb145ffa~tplv-tt-cut:3216:1810.jpeg?scene=content&x-expires=1747815830&x-signature=ElLytAjeIfSe2O2WkFMqOBY2VUw%3D",
          "Width": 3216,
          "Height": 1810
        }
      ]
    }
  ]
}

错误码

您可访问公共错误码，获取更多错误码信息。

示例效果

图文	视频