数据

数据概览

指标概览与趋势:曝光、互动、点赞、评论、分享、发布量,以及互动率、平台占比、Top 内容、粉丝曲线、最佳发布时段热力图。可按时间范围 / 平台 / 单账号筛。口径与站内分析页完全一致(北京日历日)。

GET/api/v1/analytics/summary

analytics:read读档限流只读

鉴权与护栏

请求头 Authorization: Bearer <长期凭证>,凭证在设置页「接入外部系统 → 长期凭证」签发,见鉴权与权限。
凭证需带 scope analytics:read;签发者在工作区里的角色也要允许该动作。
限流:读档,每分钟 60 次(按凭证计),超出回 429 并带 Retry-After。
幂等:读端点,无需 Idempotency-Key。
只读端点:不写库、不外发。

查询参数

rangeenum: week · 30 · 90 · all可选

时间范围,默认 30。

platformenum: x · youtube · instagram · tiktok · facebook · threads · douyin · xiaohongshu · wechat_mp可选

只看某个平台。

accountIdstring可选

只看单个账号。

响应

成功返回 HTTP 200,信封为 { data, meta };右侧(窄屏在本页末尾)给出了各状态码的示例。所有错误都是 { error: { code, message, params }, meta },按机器码处理而不是按 message 匹配,码表见错误码。

状态码	可能的错误码
400	`invalid_input`
401	`unauthenticated`
403	`forbidden` / `workspace_not_found`
404	`not_found`
429	`rate_limited`
500	`internal`

示例

请求

curl -X GET "https://popkit.loxily.com/api/v1/analytics/summary?range=30&platform=x" \
  -H "Authorization: Bearer popkit_it_••••••••"

响应

成功(节选)

{
  "data": {
    "range": 30,
    "metrics": [
      {
        "key": "views",
        "value": 128430,
        "deltaPct": 12.4
      },
      {
        "key": "eng",
        "value": 5210,
        "deltaPct": 8.1
      },
      {
        "key": "likes",
        "value": 4120,
        "deltaPct": 6.3
      },
      {
        "key": "comments",
        "value": 640,
        "deltaPct": 21.5
      },
      {
        "key": "shares",
        "value": 450,
        "deltaPct": -3.2
      },
      {
        "key": "posts",
        "value": 18,
        "deltaPct": 0
      }
    ],
    "trend": {
      "dates": [
        "2026-08-22",
        "2026-08-23",
        "…"
      ],
      "eng": [
        120,
        98,
        0
      ]
    },
    "filled": 30,
    "bucket": "day",
    "snapshotFrom": null,
    "series": {
      "views": [
        4100,
        3980,
        0
      ],
      "eng": [
        120,
        98,
        0
      ],
      "likes": [
        90,
        80,
        0
      ],
      "comments": [
        20,
        11,
        0
      ],
      "shares": [
        10,
        7,
        0
      ],
      "posts": [
        1,
        0,
        0
      ]
    },
    "engRate": {
      "value": 4.06,
      "prev": 3.9,
      "deltaPts": 0.16,
      "series": [
        2.9,
        2.5,
        0
      ]
    },
    "share": [
      {
        "platform": "x",
        "eng": 3100,
        "pct": 59.5
      },
      {
        "platform": "instagram",
        "eng": 2110,
        "pct": 40.5
      }
    ],
    "top": [
      {
        "id": "pst_01J8ZK3R7QW6M2",
        "platform": "x",
        "title": "新功能上线",
        "eng": 890,
        "ratePct": 6.2
      }
    ],
    "followers": {
      "dates": [
        "2026-08-22",
        "…"
      ],
      "cum": [
        12100,
        12480
      ],
      "totalNow": 12480,
      "addedInRange": 380,
      "fromSnapshots": true
    },
    "heat": {
      "grid": [
        [
          0,
          3,
          12,
          40,
          55,
          30,
          8,
          2,
          0,
          0,
          0,
          0
        ],
        [
          "…"
        ]
      ],
      "max": 55
    },
    "peak": {
      "day": 2,
      "block": 4,
      "mult": 2.4
    },
    "hasData": true,
    "deepLink": "https://popkit.loxily.com/analytics?range=30&platform=x"
  },
  "meta": {
    "requestId": "6a1d0c9e-2b7f-4e3a-8c5d-1f0e9b8a7c80"
  }
}