专题分发--内容定制-火山引擎

文档中心

导航

专题分发

最近更新时间：2024.05.17 14:08:31首次发布时间：2023.06.29 19:04:59

火山引擎为客户提供专题管理能力，通过控制台支持客户，筛选围绕当下大事件的信息聚合和解读的专题，并支持管理专题内容的能力。
【功能价值】

丰富客户APP的整体内容流形式，增加内容的展示形式和聚合形式，提升用户的消费渗透。
通过专题能力，可以帮助客户发现行业专题事件，构建实时专题，提升用户体验。

本文档将介绍如何获取专题列表和专题详情。

请求结构	说明
请求域名	stream-api.feedcoopapi.com
请求地址	/content/stream/topics
请求协议	HTTP/HTTPS
请求方式	GET

请求参数

其他参数请参见公共参数。

参数	描述	类型	是否必填	说明
hot_topic_id	专题ID	int64	否	当获取专题列表时，不传；当获取专题详情时，必填；

响应参数

参数	描述	类型	说明
ret	响应结果	long	参见“错误码”说明
req_id	本次请求标识	String	惟一标识本次请求，火山引擎侧使用该字段进行具体问题追踪和排查
msg	本次请求是否成功	String	success：成功
data	专题列表/专题详情	List

请求示例

获取专题列表

curl --location 'https://stream-api.feedcoopapi.com/content/stream/topics?access_token=xxx&timestamp=1687946143&signature=xxx&nonce=123&partner=xxx'

获取专题详情

curl --location 'https://stream-api.feedcoopapi.com/content/stream/topics?access_token=xxx&timestamp=1687946143&signature=xxx&nonce=123&partner=xxx&hot_topic_id=7249985595210993210'

响应示例

获取专题列表

{
    "ret": 0,
    "msg": "success",
    "message": "success",
    "data": [
        {
            "group_id": 7249367610955923494,
            "group_id_str": "7249367610955923494",
            "title": "xxx",
            "category": "entertainment",
            "introduction": "",
            "article_url": "https://open.toutiao.com/pages/hot-topic?access_token=xxx&biz_log=B3fR4jutcfaLqDvZuXhWVwZaJb9d1wEfivWT721BtqwSTkTs3DDGucQjKnJGMfDS8EHvZkQ7s5bE8yXkaJXgV4C&hot_board_gid=xxx&nonce=123&partner=xxx&signature=xxx&timestamp=1687946143&utm_source=xxx",
            "cover_image_list": [
                {
                    "url_list": [
                        {
                            "url": "http://p9-open-sign.byteimg.com/top-static-files-outer/breaknews/0271ebde-0810-4f0b-96c5-5f63308cb633~tplv-tt-cs0:960:540.jpeg?scene=content&x-expires=1719482280&x-signature=4HVuhdQpE4UTDhwaQCRlx0H2Hhw%3D"
                        }
                    ],
                    "height": 960,
                    "width": 540,
                    "uri": "top-static-files-outer/breaknews/0271ebde-0810-4f0b-96c5-5f63308cb633",
                    "url": "http://p9-open-sign.byteimg.com/top-static-files-outer/breaknews/0271ebde-0810-4f0b-96c5-5f63308cb633~tplv-tt-cs0:960:540.jpeg?scene=content&x-expires=1719482280&x-signature=4HVuhdQpE4UTDhwaQCRlx0H2Hhw%3D"
                }
            ],
            "publish_time": 1687908735,
            "global_position": 6,
            "blocks": null
        },
        ...
    ],
    "req_id": "20230628175800E47FBD266D9A197924D5",
    "has_more": false
}

获取专题详情

{
    "ret": 0,
    "msg": "success",
    "message": "success",
    "data": {
        "group_id": 7249592914706169911,
        "group_id_str": "7249592914706169911",
        "title": "xxx",
        "category": "culture",
        "introduction": "",
        "article_url": "https://open.toutiao.com/pages/hot-topic?access_token=xxx&biz_log=B3fR4jutcfaLqE1F8NJAaxUXWjrNqoykBmcv8W6QvVvzCQhq1NSJairC8My4uzqQUUw77LLVmaYCQqTw9vuqY4Q&hot_board_gid=7249592914706169911&nonce=123&partner=xxx&signature=xxx&timestamp=1687946143&utm_source=xxx",
        "cover_image_list": [
            {
                "url_list": [
                    {
                        "url": "http://p9-open-sign.byteimg.com/top-static-files-outer/breaknews/407f7972-c321-4023-b2d0-982e0c58aee6~tplv-tt-cs0:960:540.jpeg?scene=content&x-expires=1719561946&x-signature=hpy%2FMn9XSPcOO2YffXIk5YqhbkU%3D"
                    }
                ],
                "height": 960,
                "width": 540,
                "uri": "top-static-files-outer/breaknews/407f7972-c321-4023-b2d0-982e0c58aee6",
                "url": "http://p9-open-sign.byteimg.com/top-static-files-outer/breaknews/407f7972-c321-4023-b2d0-982e0c58aee6~tplv-tt-cs0:960:540.jpeg?scene=content&x-expires=1719561946&x-signature=hpy%2FMn9XSPcOO2YffXIk5YqhbkU%3D"
            }
        ],
        "publish_time": 1688021126,
        "global_position": 0,
        "blocks": [
            {
                "id": 1768138774616167,
                "title": "",
                "introduction": "",
                "articles": [
                    {
                        "abstract": "xxx",
                        "article_url": "https://partner.365yg.com/a7249660422435897888/?a_t=xxx&biz_log=B3fR4jutcfaLqE1F8NJAaxUXWjrNqoykBmcv8W6QvVvzCQhq1NSJairC8My4bReQ8BSDkXYXWhctD8xXPYZvKZJ&crypt=4247&form_scen=FROM_CONTENT&gy=4f22d81cc308b3f377b3f779638c47f17bfd51f9282f7349757c2a984de9e8b88b3171f0a21ca3c73c28d4214e50365c8174c8ec784e74064cdb1364c8a3210df83cebf722f9dff4c35935c5defb4dbd9f37e2ad09cc359240f88366f7a8d977&item_id=7249660422435897888&item_id=7249660422435897888&req_id=2023062916054675AA47BFCC36FC24E5AF&utm_source=xxx",                        
                        "comment_count": 86,
                        "comment_url": "https://open.toutiao.com/a7249660422435897888/comment/?utm_source=xxx&req_id=2023062916054675AA47BFCC36FC24E5AF&gy=4f22d81cc308b3f377b3f779638c47f17bfd51f9282f7349757c2a984de9e8b88b3171f0a21ca3c73c28d4214e50365c8174c8ec784e74064cdb1364c8a3210df83cebf722f9dff4c35935c5defb4dbd9f37e2ad09cc359240f88366f7a8d977&crypt=4247&form_scen=FROM_CONTENT&a_t=AqhjaIc63rBiwcNUL75jYRbfN8PSQXhYBMNtkUTpWqSMnjit4LZpfZR6iJGu5inPxJm6J6N43",
                        "cover_image_list": [
                            {
                                "url_list": [
                                    {
                                        "url": "http://p3-open-sign.byteimg.com/tos-cn-i-0004/o8pg4zTXIABNghAAJAGhv01AoECIQAf3ycBskN~tplv-obj.jpeg?scene=content&x-expires=1719561946&x-signature=ZUt1UMd4a9uPcOrszgFlC8VOCbI%3D"
                                    },
                                    {
                                        "url": "http://p3-open-sign.byteimg.com/tos-cn-i-0004/o8pg4zTXIABNghAAJAGhv01AoECIQAf3ycBskN~tplv-obj.jpeg?scene=content&x-expires=1719561946&x-signature=ZUt1UMd4a9uPcOrszgFlC8VOCbI%3D"
                                    },
                                    {
                                        "url": "http://p3-open-sign.byteimg.com/tos-cn-i-0004/o8pg4zTXIABNghAAJAGhv01AoECIQAf3ycBskN~tplv-obj.jpeg?scene=content&x-expires=1719561946&x-signature=ZUt1UMd4a9uPcOrszgFlC8VOCbI%3D"
                                    }
                                ],
                                "height": 1080,
                                "width": 1920,
                                "uri": "tos-cn-i-0004/o8pg4zTXIABNghAAJAGhv01AoECIQAf3ycBskN",
                                "url": "http://p9-open-sign.byteimg.com/tos-cn-i-0004/o8pg4zTXIABNghAAJAGhv01AoECIQAf3ycBskN~tplv-obj.jpeg?scene=content&x-expires=1719561946&x-signature=B74C1EAzXRhBivppYNawZPYM%2Bek%3D"
                            }
                        ],
                        "cover_mode": 1,
                        "digg_count": 1216,
                        "filter_words": [],
                        "group_id": 7249660422435897888,
                        "group_id_str": "7249660422435897888",                       
                        "has_video": true,
                        "is_stick": false,
                        "publish_time": 1688010000,
                        "share_count": 156,
                        "share_url": "https://partner.365yg.com/a7249660422435897888/?a_t=xxx&biz_log=B3fR4jutcfaLqE1F8NJAaxUXWjrNqoykBmcv8W6QvVvzCQhq1NSJairC8My4bReQ8BSDkXYXWhctD8xXPYZvKZJ&label=share&req_id=2023062916054675AA47BFCC36FC24E5AF&utm_source=xxx",
                        "source": "我在岛屿读书",
                        "title": "余华忆初识莫言经历 阿来秒变植物学家",
                        "user_info": {
                            "avatar_url": "https://p9-open-sign.onewsimg.com/user-avatar/a0a3780af8c0374088d850bbcb972ad5~tplv-obj.jpeg?scene=core&x-expires=1751097900&x-signature=1lpeWfU4KeZJDMAyIqumakpjU2o%3D",
                            "description": "",
                            "follow": false,
                            "follower_count": 337991,
                            "home_page": "https://open.toutiao.com/u981191026294333/?utm_source=xxx&label=homepage&a_t=xxx",
                            "media_id": 0,
                            "name": "我在岛屿读书",
                            "user_id": 981191026294333,
                            "user_verified": true
                        },
                        "video_duration": 3112,
                        "video_id": "V4pTA8rv5u4JK116tHkbnpCmGZTZRB8W5sP9U9GdxrTCcTwDqf7ccJanNJ5st4cDyGSX7aQuCUhHnagFqbfzkABKX1Hwxv4EYgXdaqhRpTPYqHwmtKXb8epoPw63RtkYr8hnJR6E85JC8JWamho",
                        "video_watch_count": 1452264,
                        "article_class": "短视频"
                    },
                    ...
                ]
            }
        ]
    },
    "req_id": "2023062916054675AA47BFCC36FC24E5AF",
    "has_more": false
}