API Analytics

API Analytics cho phép truy cập bằng lập trình vào dữ liệu hiệu suất đa kênh, lịch sử người theo dõi và các chỉ số tương tác bài viết trên các tài khoản mạng xã hội (SNS) đã kết nối.

📌 Điểm cuối

Phương thức	Đường dẫn	Mô tả	Scope yêu cầu
`GET`	`/v1/brand/analytics`	Truy vấn các chỉ số chi tiết theo khoảng thời gian, nền tảng hoặc kết nối	`analytics:read` hoặc `*`
`GET`	`/v1/brand/analytics/overview`	Tóm tắt nhanh trong 30 ngày trên tất cả các kênh thương hiệu	`analytics:read` hoặc `*`

📊 Phân tích chi tiết (`GET /v1/brand/analytics`)

Truy vấn các chỉ số tổng hợp và theo từng kênh dựa trên tiêu chí lọc.

Tham số truy vấn

Tham số	Loại	Bắt buộc	Mặc định	Mô tả
`range`	`string`	Tùy chọn	`30d`	Khoảng thời gian (`7d`, `14d`, `30d`, `90d`, hoặc tùy chỉnh `YYYY-MM-DD..YYYY-MM-DD`)
`sns_type`	`string`	Tùy chọn	-	Lọc theo nền tảng (`instagram`, `threads`, `bluesky`, v.v.)
`connection_id`	`string`	Tùy chọn	-	Lọc theo ID kết nối cụ thể

Ví dụ yêu cầu

curl -X GET "https://api.ankk.app/v1/brand/analytics?range=30d&sns_type=instagram" \
  -H "Authorization: Bearer spk_live_xxxxxxxx"

Ví dụ phản hồi (`200 OK`)

{
  "range": {
    "start": "2026-07-17T00:00:00Z",
    "end": "2026-08-16T00:00:00Z",
    "preset": "30d"
  },
  "totals": {
    "followers": 12500,
    "followers_change": 340,
    "published_posts": 28,
    "impressions": 84200,
    "reach": 61500,
    "engagement_rate": 4.8,
    "likes": 3210,
    "comments": 412,
    "shares": 180,
    "saves": 250
  },
  "by_channel": [
    {
      "connection_id": "conn_01jm8x9k2example",
      "sns_type": "instagram",
      "username": "acme_official",
      "followers": 12500,
      "posts_count": 28,
      "metrics_status": "synced"
    }
  ]
}

📈 Tổng quan thương hiệu (`GET /v1/brand/analytics/overview`)

Nhanh chóng lấy các bản tóm tắt cấp cao trong 30 ngày phù hợp cho các tiện ích bảng điều khiển và bản tin hàng ngày.

Ví dụ yêu cầu

curl -X GET "https://api.ankk.app/v1/brand/analytics/overview" \
  -H "Authorization: Bearer spk_live_xxxxxxxx"

Ví dụ phản hồi (`200 OK`)

{
  "brand_ref": "brand_01jm8v4k9example",
  "active_connections": 4,
  "summary_30d": {
    "total_published": 54,
    "total_failed": 1,
    "total_followers": 28400,
    "total_impressions": 195000
  },
  "synced_at": "2026-08-16T03:00:00Z"
}

⚠️ Lưu ý về các chỉ số & giới hạn

Giới hạn gói: Gói Miễn phí hỗ trợ các chỉ số trong 30 ngày qua. Các gói Tăng trưởng (Growth) trở lên cho phép thời gian lưu trữ kéo dài (90 ngày trở lên).
Cách hiểu 0 và null:
- 0: Giá trị chỉ số đo được thực sự là không.
- null / unsupported: API nền tảng không hỗ trợ chỉ số này hoặc quyền chưa được xác minh.

🔗 Tài liệu liên quan