全量库通用原文

本页内容

接口URL：https://open.datastory.com.cn/api/indicator.knowledge.post.list
请求方式：POST
描述：通过该接口可查询全量库的通用原文，第一版默认只查询抖音短视频原文。

2. 输入参数 #

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

参数名称 必选 默认值 类型 参数示例 描述
filters 是 RequestKnowledgePostFilters (见接口数据结构) 查询过滤条件

3. 输出参数 #

参数名称 必选 类型 参数示例 描述
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. 状态码 #

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

状态码 描述