Question

获取文章列表API介绍

开发者用户可通过本接口来获取图文、图集、视频类型的文章列表，支持用户按照百家号作者帐号ID、文章类型、时间批量查询。单次最多可查询20篇文章数据。

用户上传的图片/视频素材在异步处理的过程中，可能存在处理失败/超时等情况，含有此类素材的文章将不会显示在文章列表，可以使用文章状态API定位问题。

接口地址

URL：https://baijiahao.baidu.com/builderinner/open/resource/query/articleListall

接口参数

参数名称	类型	是否必须	描述
app_token	string	是	授权密钥
app_id	string	是	作者帐号ID
start_time	string	否	支持按照年月日格式（2019-06-01）进行查询，仅支持查询到日维度的数据
end_time	string	否	支持按照年月日格式（2019-07-01）进行查询，仅支持查询到日维度的数据
page_no	int	否	查询页码，不传默认为1
page_size	int	否	查询条数，不能超过20，不传默认为20
article_type	string	否	文章类型，news-图文、gallery-图集、video-视频，ugc_video-小视频，不传默认查询所有支持的文章类型
collection	string	否	文章状态集，不传默认查询所有支持的文章状态集 draft-草稿、publish-已发布、pre_publish-待发布、withdraw-已撤回、rejected-未通过

状态集指的是百家号后台内容管理中的文章集合分类，并非文章真实状态。

返回值及解释

参数名称	类型	描述
errno	int	错误码
errmsg	string	错误信息
data	dict	返回数据
-page	dict	分页数据
--page_no	int	查询页码

状态集及状态映射

状态	含义	隶属状态集
draft	草稿	draft
publish	已发布	publish
published	已发布旧状态码	publish
pre_publish	等待发布，一般用于定时发布	pre_publish
audit	审核中	pre_publish
withdraw	撤回	withdraw
rejected	审核未通过	rejected
forbidden	已下线	rejected

查询条件示例

{
    "app_id": "INPUT_ID_HERE",
    "app_token": "INPUT_TOKEN_HERE",
    "page_size": 2,
    "page_no": 1,
    "article_type": "news",
    "end_time": "2018-10-30"
}

返回结果示例

{
    "errno": 0,
    "errmsg": "成功",
    "data": {
        "page": {
            "page_no": 1,
            "page_size": 2,
            "items_count": 2,
            "has_next": true
        },
        "items": {
            "1111111111": {
                "article_id": "1111111111",
                "app_id": "1111111111",
                "nid": "11111111112",
                "updated_at": 1540886721,
                "type": "news",
                "status": "analyze",
                "collection": "pre_publish",
                "title": "示例标题",
                "article_url": "http://baijiahao.baidu.com/s?id=1111111111"
            },
            "22222222": {
                "article_id": "22222222",
                "app_id": "22222222",
                "nid": "222222223",
                "updated_at": 1540883519,
                "type": "news",
                "status": "audit",
                "collection": "pre_publish",
                "title": "示例标题2",
                "article_url": "http://baijiahao.baidu.com/s?id=22222222"
            }
        }
    }
}