参数名称	必选	类型	参数示例	描述
code	否	integer	0	返回状态码，内部定义
data	否	ResponseDataOfKnowledgePostInfo	(见接口示例)	查询过滤条件
msg	否	string	"接口返回成功！"	接口返回信息说明，在接口返回失败时会有
openStrategy	否	boolean	false	是否接受缓存
success	否	boolean	true	接口返回是否成功

4. 数据结构

4.1 RequestKnowledgePostFilters

参数名	必选	类型	参数示例	描述
itemIds	否		array	["91682442230"]	站内唯一视频id
publishTimeStamp	否	最近30天	object	{"start":1656604800000,"end":1659196800000}	查询的时间戳范围
userItemIds	否		array	["532636039652973"]	视频发表用户id
secUserItemIds	否		array	["MS4wLjABAAAA1kSDpp6l7e1dT6SwR-De2a4K-ApvlSwyLHlm-J_ZJVU"]	抖音sec_uid
limitSize	否		int	50	查询数据量

4.2 ResponseDataOfKnowledgePostInfo

参数名	必选	类型	参数示例	描述
dataset	否	[Array of KnowledgePostInfo]	(请参考数据字典)	返回结果数组
meta	否	array	"list"	返回数据格式：list、aggregation、graph
page	否	integer	1	分页查询的页码
pageSize	否	integer	"20"	分页查询的单页数据条数
time	否	integer	"955"	查询总耗时，单位毫秒
total	否	integer	"34500230"	查询数据总量

5. 示例

示例1 查看品类下的评论详情

查看2022-08-01至2022-08-31时间范围，站内唯一视频id"7126566997604781348"的数据。

输入示例

{
    "filters": {
        "itemIds": [
            "7126566997604781348"
        ],
        "publishTimeStamp": {
            "start": 1656604800000,
            "end": 1659196800000
        }
    }
}

输出示例

{
    "success": true,
    "openStrategy": false,
    "code": 0,
    "msg": "接口返回成功！",
    "data": {
        "meta": {
            "datasetType": "list"
        },
        "dataset": [
            {
                "id": "fcf3138fffcd3839fc626b6e57032014",
                "itemId": "7126566997604781348",
                "siteId": "1003583",
                "catId": "12",
                "siteName": "抖音app",
                "authorName": "桃花聊",
                "userItemId": "532636039652973",
                "publishTimestamp": 1659283199000,
                "publishDateDate": "20220731",
                "publishDateHour": "2022073123",
                "videoUrl": "https://www.iesdouyin.com/share/video/7126566997604781348?schema_type=37",
                "videoDuration": 0,
                "title": "@桃花聊创作的原声",
                "content": "这个小姐姐在本区，想找个喜欢的老乡，合适就约会！",
                "sentiment": "0",
                "keywords": [
                    "合适",
                    "喜欢",
                    "小姐姐",
                    "约会",
                    "老乡"
                ],
                "fingerprint": "a3df3db419b4be08547d6e646bdb4e7d",
                "isAd": "1",
                "isRobot": "0",
                "interactionCnt": 0,
                "collectionCnt": 0,
                "likeCnt": 0,
                "shareCnt": 0,
                "commentCnt": 0,
                "thumbnailUrl": "https://p6.douyinpic.com/web.business.image/20220730dbbd8d1b1887fc464ff2bee4~tplv-dy-360p.jpeg",
                "isPrivate": "0",
                "isRecom": "0",
                "videoPlayUrls": [
                    "https://p95-sign.douyinpic.com/web.business.image/20220730dbbd8d1b1887fc464ff2bee4~noop.webp?x-expires=1661875200&x-signature=DMqB3kd0WdwO%2BWbpwi1UPnkJqeM%3D&from=4257465056&s=PackSourceEnum_AWEME_DETAIL&se=false&biz_tag=aweme_images&l=202208010020550101420330293F9CC730"
                ],
                "audioPlayUrls": [
                    "https://sf3-cdn-tos.douyinstatic.com/obj/tos-cn-ve-2774/ebee79fd5d8f4c21b2d4d6d1a8ceffdc"
                ],
                "city": "未知",
                "cityLevel": "-2",
                "volumeType": "UKN",
                "socialMediaAd": "6",
                "platformIsAd": "1",
                "postType": "image",
                "secUserItemId": "MS4wLjABAAAA1kSDpp6l7e1dT6SwR-De2a4K-ApvlSwyLHlm-J_ZJVU",
                "otherData": "{\"terminal\":\"APP\",\"itemInfo\":\"{\\\"has_item\\\":\\\"0\\\"}\"}",
                "augmentTimestamp": 1634054400000,
                "sourceCrawlerId": "1116524",
                "crawlerTimestamp": 1659284473000,
                "taskIds": [
                    "24745389"
                ],
                "updateTimestamp": 1659284504000,
                "firstCrawlerTimestamp": 1659284473000,
                "firstUpdateTimestamp": 1659284504000
            }
        ],
        "total": 1,
        "time": 1655
    }
}

6. 状态码

以下仅列出了接口业务逻辑相关的状态码。

状态码	描述