Get Analytics

GET/analytics

Returns aggregate stats for the authenticated creator's content.

Query parameters

periodstringquery

7d | 30d | 90d | all (default: 30d).

Response fields

views.totalinteger

Total page views in the period.

views.uniqueinteger

Unique visitor count.

views.change_pctnumber

% change vs prior period.

revenue.total_usdnumber

Combined tips + subscription revenue.

subscribers.totalinteger

Active paying subscribers.

top_articlesArray<object>

Top 5 articles by views, with read-completion %.

curl "https://api.misar.io/blog/v1/analytics?period=7d" \
  -H "Authorization: Bearer mbk_YOUR_KEY"

{
  "period": "30d",
  "views": {
    "total": 18420,
    "unique": 12304,
    "change_pct": 14.2
  },
  "revenue": {
    "total_usd": 284.50,
    "tips_usd": 34.50,
    "subscriptions_usd": 250.00
  },
  "subscribers": {
    "total": 1204,
    "new": 87,
    "churned": 12
  },
  "top_articles": [
    {
      "slug": "building-ai-apps-with-next-js",
      "title": "Building AI Apps with Next.js",
      "views": 4210,
      "read_pct": 68
    }
  ]
}

const res = await fetch("https://api.misar.io/blog/v1/analytics?period=30d", {
  headers: { Authorization: `Bearer ${process.env.MISARBLOG_API_KEY}` },
});
const stats = await res.json();
console.log(stats.views.total);

Status codes

401 — Invalid or missing API key
400 — Invalid period value