公众号
取消
中文
中文
EN
取消
  • 服务端 API

    • # 获取发表内容发表详细数据

    调试诊断

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

    接口英文名：getarticletotaldetail

    本接口用于获取 圈选日期内 所有发表内容的详细数据。

    • 返回的数据包括 [开始日期-结束日期] 期间（包含区间首尾日期）发表的所有发表内容。
    • 统计方式为：每篇发表内容在统计周期内（最大30天），每天产生的指标数据的总和。

    # 1. 调用方式

    # HTTPS 调用

    POST https://api.weixin.qq.com/datacube/getarticletotaldetail?access_token=ACCESS_TOKEN

    # 云调用

    • 调用方法：datacube.getarticletotaldetail

    • 出入参和 HTTPS 调用相同，调用方式可查看 云调用 说明文档。

    # 第三方调用

    • 本接口支持第三方平台代商家调用。

    • 该接口所属的权限集 id 为：7

    • 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。

    # 2. 请求参数

    # 查询参数 Query String Parameters

    参数名类型必填示例说明
    access_tokenstring是ACCESS_TOKEN接口调用凭证，可使用 access_token、authorizer_access_token

    # 请求体 Request Payload

    参数名类型必填示例说明
    begin_datestring是2025-11-01起始日期(YYYY-MM-DD)
    end_datestring是2025-11-01结束日期(最大值为昨日)

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    listobjarray日期内文章数据列表
    is_delayboolean数据是否有延迟，is_delay=false表示数据是最新的

    # Res.list(Array) Object Payload

    日期内文章数据列表

    参数名类型示例说明
    ref_datestring2025-11-01文章发表日期
    msgidstring2247490098_1请注意：这里的msgid实际上是由msgid（图文消息id，这也就是群发/发布接口调用后返回的msg_data_id）和index（消息次序索引）组成， 例如12003_3， 其中12003是msgid，即一次群发/发布的消息的id； 3为index，假设该次群发/发布的图文消息共5个文章（因为可能为多图文），3表示5个中的第3个
    publish_typenumber0发表类型，0.已通知; 1.未开启通知;
    detail_listobjarray-每篇文章的详细数据

    # Res.list(Array).detail_listObject Payload

    每篇文章的详细数据

    参数名类型示例说明
    stat_datestring2025-11-01统计日期。下面统计数据是 [发表日期-统计日期] （包含区间首尾日期）期间内，所有指标新产生的数据总和
    read_usernumber4123阅读人数（即read_user_source里面来源为全部的阅读人数）
    read_user_sourceobjarray阅读数据（包含来源）
    share_usernumber366分享人数
    zaikan_usernumber191爱心赞人数
    like_usernumber386拇指赞人数
    comment_countnumber33留言条数
    collection_usernumber233微信收藏人数
    praise_moneynumber361赞赏金额，单位分
    read_subscribe_usernumber327阅读后关注人数
    read_delivery_ratenumber0.0271002阅读送达率
    read_finish_ratenumber0.6304348阅读完成率
    read_avg_activetimenumber1.0588236平均阅读时长，单位(min)
    read_jump_positionobjarray-用户跳出位置

    # Res.list(Array).detail_list.read_user_sourceObject Payload

    阅读数据（包含来源）

    参数名类型示例说明
    user_countnumber4123阅读人数
    scene_descstring全部阅读场景来源。包含如下场景： 全部、公众号消息、聊天会话、朋友圈、公众号主页、其他、推荐、搜一搜

    # Res.list(Array).detail_list.read_jump_positionObject Payload

    用户跳出位置

    参数名类型示例说明
    positionnumber1用户跳出位置，1-[0~20%], 2-[20%~40%], 3-[40%~60%], 4-[60%~80%], 5-[80%~100%]。其中position=1表示，用户在文章进度为0~20%的时候跳出，同理position=3表示用户在文章进度为40%~60%的时候跳出
    ratenumber0.5304147当前跳出位置所占用户比例

    # 4. 注意事项

    • 数据存储起始时间为2025-11-01，之前日期数据无效。

    • 日期范围仅支持查询1天。

    • 每篇文章仅统计发表日期起30天内的数据（比如发表于2025-11-01的内容，最多统计到2025-11-30）。

    • 如果选择日期内没有发表过文章，返回的数据为空。

    • 数据更新可能会有延迟，请以接口返回数据为准。

    # 5. 代码示例

    请求示例

    {
    "begin_date": "2025-11-01",
    "end_date": "2025-11-01"
}

    返回示例

    {
    "list": [
        {
            "ref_date": "2025-11-01",
            "msgid": "2247490098_1",
            "publish_type": 0,
            "detail_list": [
                {
                    "stat_date": "2025-11-01",
                    "read_user": 4123,
                    "read_user_source": [
                        {
                            "user_count": 4123,
                            "scene_desc": "全部"
                        },
                        {
                            "user_count": 234,
                            "scene_desc": "公众号消息"
                        }
                    ],
                    "share_user": 366,
                    "zaikan_user": 191,
                    "like_user": 386,
                    "comment_count": 33,
                    "collection_user": 233,
                    "praise_money": 361,
                    "read_subscribe_user": 327,
                    "read_delivery_rate": 0.0271002,
                    "read_finish_rate": 0.6304348,
                    "read_avg_activetime": 1.0588236,
                    "read_jump_position": [
                        {
                            "position": 1,
                            "rate": 0.5304147
                        },
                        {
                            "position": 2,
                            "rate": 0.1023412
                        }
                    ]
                },
                {
                    "stat_date": "2025-11-02",
                    "read_user": 4125,
                    "read_user_source": [
                        {
                            "user_count": 4125,
                            "scene_desc": "全部"
                        },
                        {
                            "user_count": 236,
                            "scene_desc": "公众号消息"
                        }
                    ],
                    "share_user": 366,
                    "zaikan_user": 195,
                    "like_user": 389,
                    "comment_count": 33,
                    "collection_user": 235,
                    "praise_money": 362,
                    "read_subscribe_user": 337,
                    "read_delivery_rate": 0.0271002,
                    "read_finish_rate": 0.6304348,
                    "read_avg_activetime": 1.0588236,
                    "read_jump_position": [
                        {
                            "position": 1,
                            "rate": 0.5304147
                        },
                        {
                            "position": 2,
                            "rate": 0.1023412
                        }
                    ]
                }
            ]
        }
    ],
    "is_delay": "false"
}

    # 6. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

    错误码错误描述解决方案
    -1system error系统繁忙，此时请开发者稍候再试
    0ok成功
    40001invalid credential access_token isinvalid or not latest 获取 access_token 时 AppSecret 错误，或者 access_token 无效。请开发者认真比对 AppSecret 的正确性，或查看是否正在为恰当的公众号调用接口
    61500date format error 日期格式错误
    61501date range error 日期范围超过接口限制

    # 7. 适用范围

    本接口在不同账号类型下的可调用情况：
    公众号服务号
    仅认证 仅认证
    • 仅认证：表示仅允许企业主体已认证账号调用，未认证或不支持认证的账号无法调用。
    • 其他未明确声明的账号类型，如无特殊说明，均不可调用此接口。