API การวิเคราะห์

API การวิเคราะห์ช่วยให้คุณเข้าถึงข้อมูลประสิทธิภาพของหลายช่องทาง ประวัติจำนวนผู้ติดตาม และตัวชี้วัดการมีส่วนร่วมของโพสต์จากบัญชี SNS ที่เชื่อมต่อไว้ผ่านโปรแกรม

📌 Endpoint

เมธอด	พาธ	คำอธิบาย	ขอบเขตสิทธิ์ที่จำเป็น
`GET`	`/v1/brand/analytics`	เรียกดูตัวชี้วัดโดยละเอียดตามช่วงเวลา แพลตฟอร์ม หรือการเชื่อมต่อ	`analytics:read` หรือ `*`
`GET`	`/v1/brand/analytics/overview`	สรุปภาพรวมย้อนหลัง 30 วันของทุกช่องทางในแบรนด์อย่างรวดเร็ว	`analytics:read` หรือ `*`

📊 ข้อมูลวิเคราะห์โดยละเอียด (`GET /v1/brand/analytics`)

เรียกดูตัวชี้วัดแบบรวมและแบบแยกรายช่องทางตามเกณฑ์การกรอง

พารามิเตอร์ของคำขอ

พารามิเตอร์	ประเภท	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
`range`	`string`	ไม่จำเป็น	`30d`	ช่วงเวลา (`7d`, `14d`, `30d`, `90d` หรือกำหนดเอง `YYYY-MM-DD..YYYY-MM-DD`)
`sns_type`	`string`	ไม่จำเป็น	-	กรองตามแพลตฟอร์ม (`instagram`, `threads`, `bluesky` ฯลฯ)
`connection_id`	`string`	ไม่จำเป็น	-	กรองตาม ID การเชื่อมต่อที่ระบุ

ตัวอย่างคำขอ

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

ตัวอย่างการตอบกลับ (`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"
    }
  ]
}

📈 สรุปภาพรวมแบรนด์ (`GET /v1/brand/analytics/overview`)

ดึงข้อมูลสรุปภาพรวมระดับสูงย้อนหลัง 30 วันอย่างรวดเร็ว เหมาะสำหรับวิดเจ็ตบนหน้าแดชบอร์ดและการสรุปผลรายวัน

ตัวอย่างคำขอ

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

ตัวอย่างการตอบกลับ (`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"
}

⚠️ หมายเหตุเกี่ยวกับตัวชี้วัดและขีดจำกัด

ขีดจำกัดของแผนบริการ: แผน Free รองรับการดูตัวชี้วัดย้อนหลังสูงสุด 30 วัน ส่วนแผน Growth ขึ้นไปสามารถเก็บข้อมูลได้นานขึ้น (90 วัน+)
การตีความ 0 เทียบกับ null:
- 0: ค่าของตัวชี้วัดที่วัดได้คือศูนย์จริงๆ
- null / unsupported: API ของแพลตฟอร์มไม่รองรับตัวชี้วัดนี้ หรือยังไม่ได้รับการตรวจสอบสิทธิ์

🔗 เอกสารที่เกี่ยวข้อง