एनालिटिक्स (Analytics) API

एनालिटिक्स (Analytics) API आपके जुड़े हुए SNS खातों में मल्टी-चैनल प्रदर्शन डेटा, फॉलोअर इतिहास और पोस्ट एंगेजमेंट मेट्रिक्स तक प्रोग्रामेटिक पहुंच सक्षम बनाता है।

📌 एंडपॉइंट्स (Endpoints)

विधि (Method)	पाथ (Path)	विवरण (Description)	आवश्यक स्कोप (Required Scope)
`GET`	`/v1/brand/analytics`	समय सीमा, प्लेटफॉर्म, या कनेक्शन के आधार पर विस्तृत मेट्रिक्स क्वेरी करें	`analytics:read` या `*`
`GET`	`/v1/brand/analytics/overview`	सभी ब्रांड चैनलों में त्वरित 30-दिवसीय सारांश	`analytics:read` या `*`

📊 विस्तृत एनालिटिक्स (`GET /v1/brand/analytics`)

फ़िल्टर मानदंडों के आधार पर एकत्रित और चैनल-दर-चैनल मेट्रिक्स क्वेरी करें।

क्वेरी पैरामीटर्स (Query Parameters)

पैरामीटर	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`range`	`string`	वैकल्पिक	`30d`	समय सीमा (`7d`, `14d`, `30d`, `90d`, या कस्टम `YYYY-MM-DD..YYYY-MM-DD`)
`sns_type`	`string`	वैकल्पिक	-	प्लेटफॉर्म द्वारा फ़िल्टर करें (`instagram`, `threads`, `bluesky`, आदि)
`connection_id`	`string`	वैकल्पिक	-	विशिष्ट कनेक्शन ID द्वारा फ़िल्टर करें

अनुरोध उदाहरण (Request Example)

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

प्रतिक्रिया उदाहरण (Response Example) (`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-दिवसीय सारांश तुरंत प्राप्त करें।

अनुरोध उदाहरण (Request Example)

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

प्रतिक्रिया उदाहरण (Response Example) (`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"
}

⚠️ मेट्रिक्स और सीमाओं पर नोट्स

प्लान सीमाएं (Plan Limits): Free प्लान पिछले 30 दिनों के मेट्रिक्स का समर्थन करता है। Growth प्लान और उससे ऊपर विस्तारित प्रतिधारण (90d+) सक्षम करते हैं।
0 बनाम null की व्याख्या:
- 0: मापा गया मेट्रिक मान वास्तव में शून्य है।
- null / unsupported: प्लेटफॉर्म API इस मेट्रिक का समर्थन नहीं करता है या अनुमति असत्यापित है।

🔗 संबंधित दस्तावेज़