# Analytics API

> Post and account analytics, platform-native insights and inbox analytics. Dates are UTC days (YYYY-MM-DD). History is limited by the plan (free 30 d, pro 365 d, business 730 d).

Base URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## List post analytics

`GET /analytics`

Posts (Socialit and external) with their metrics per platform, paginated, plus an overview. Defaults to the last 90 days (max 366). Dates are UTC days (YYYY-MM-DD). History is limited by the plan (free 30 d, pro 365 d, business 730 d).

Access: `read` · MCP tool: `list-post-analytics` · Zernio: `GET /v1/analytics`

### Query parameters

- `page` (integer; ≥ 1)
- `limit` (integer; 1–100)
- `platform` (string): Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"
- `profile_id` (string): Profile id (pro_…) or "all"
- `account_id` (string; 1–80 characters): Account id (sa_…)
- `source` (string; one of all, socialit, late, external): all (default), socialit (published through Socialit; alias late), external (imported)
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `tags` (string; ≤ 2000 characters): Comma-separated post tags (max 20): only Socialit posts carrying every tag (exact, case-sensitive). More than 200 matching published posts in the range → 400 (narrow the dates).
- `sort` (string; one of date, engagement, impressions, reach, likes, comments, shares, saves, clicks, views, engagement_rate)
- `order` (string; one of asc, desc)

```bash
curl "https://api.socialit.com/v1/analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "post_analytics",
      "id": "string",
      "post_id": "string",
      "status": "string",
      "source": "socialit",
      "content": "string",
      "profile_id": "string",
      "scheduled_at": "2026-10-13T09:00:00.000Z",
      "published_at": "2026-10-13T09:00:00.000Z",
      "platform": "string",
      "platform_post_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "sync_status": "synced",
      "calculated": true,
      "metrics": {
        "impressions": 1.5,
        "reach": 1.5,
        "views": 1.5,
        "likes": 1.5,
        "comments": 1.5,
        "shares": 1.5
      },
      "platforms": [
        {
          "object": "posting_analytics",
          "posting_id": "string",
          "account_id": "string",
          "account_username": "string",
          "platform": "string",
          "status": "string"
        }
      ],
      "last_synced_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com",
  "overview": {
    "total_posts": 1,
    "published_posts": 1,
    "scheduled_posts": 1,
    "last_synced_at": "2026-10-13T09:00:00.000Z",
    "stale_accounts": 1
  }
}
```

## Get analytics for one post

`GET /analytics/posts/{postId}`

Accepts a post id (pst_…), a posting id (sp_…) or a platform post id. Returns 202 (same body) while a metrics sync is pending; one is queued automatically.

Access: `read` · MCP tool: `get-post-analytics` · Zernio: `GET /v1/analytics`

### Path parameters

- `postId` (string; required; 1–300 characters): Post id (pst_…), posting id (sp_…) or the platform post id

```bash
curl "https://api.socialit.com/v1/analytics/posts/POST_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "post_analytics",
  "id": "string",
  "post_id": "string",
  "status": "string",
  "source": "socialit",
  "content": "string",
  "profile_id": "string",
  "scheduled_at": "2026-10-13T09:00:00.000Z",
  "published_at": "2026-10-13T09:00:00.000Z",
  "platform": "string",
  "platform_post_url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "sync_status": "synced",
  "calculated": true,
  "metrics": {
    "impressions": 1.5,
    "reach": 1.5,
    "views": 1.5,
    "likes": 1.5,
    "comments": 1.5,
    "shares": 1.5,
    "saves": 1.5,
    "clicks": 1.5,
    "quotes": 1.5,
    "follows": 1.5,
    "profile_views": 1.5,
    "website_clicks": 1.5,
    "watch_time_seconds": 1.5,
    "avg_view_duration_seconds": 1.5,
    "avg_view_percentage": 1.5,
    "completion_rate": 1.5,
    "replays": 1.5,
    "reposts": 1.5,
    "sends": 1.5,
    "outbound_clicks": 1.5,
    "pin_clicks": 1.5,
    "video_duration_seconds": 1.5,
    "earnings": 1.5,
    "engagements": 1.5,
    "engagement_rate": 1.5
  },
  "platforms": [
    {
      "object": "posting_analytics",
      "posting_id": "string",
      "account_id": "string",
      "account_username": "string",
      "platform": "string",
      "status": "string",
      "platform_post_id": "string",
      "platform_post_url": "https://example.com",
      "metrics": {
        "impressions": 1.5,
        "reach": 1.5,
        "views": 1.5,
        "likes": 1.5,
        "comments": 1.5,
        "shares": 1.5
      },
      "sync_status": "synced",
      "error_code": "string",
      "error_message": "string",
      "last_synced_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "last_synced_at": "2026-10-13T09:00:00.000Z"
}
```

## Analytics changed since a cursor

`GET /analytics/delta`

Cursor feed of changed post metric snapshots across every account you can read (oldest first). Call without cursor first to get the current position, load your baseline from GET /analytics, then poll with next_cursor. Cursors expire after 7 days.

Access: `read` · MCP tool: `get-analytics-delta` · Zernio: `GET /v1/analytics/delta`

### Query parameters

- `cursor` (string; ≤ 200 characters)
- `limit` (integer; 1–100)
- `platform` (string): Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"
- `profile_id` (string): Profile id (pro_…) or "all"

```bash
curl "https://api.socialit.com/v1/analytics/delta" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "analytics_delta",
  "data": [
    {
      "object": "analytics_change",
      "id": "string",
      "post_id": "string",
      "posting_id": "string",
      "account_id": "string",
      "profile_id": "string",
      "platform": "string",
      "platform_post_id": "string",
      "published_at": "2026-10-13T09:00:00.000Z",
      "synced_at": "2026-10-13T09:00:00.000Z",
      "is_deleted": true,
      "metrics": {
        "impressions": 1.5,
        "reach": 1.5,
        "views": 1.5,
        "likes": 1.5,
        "comments": 1.5,
        "shares": 1.5
      }
    }
  ],
  "next_cursor": "string",
  "has_more": true
}
```

## Get the daily metric history of a post

`GET /analytics/post-timeline`

One row per day and platform (last snapshot of the day). Defaults to the last 90 days.

Access: `read` · MCP tool: `get-post-timeline` · Zernio: `GET /v1/analytics/post-timeline`

### Query parameters

- `post_id` (string; required; 1–300 characters)
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)

```bash
curl "https://api.socialit.com/v1/analytics/post-timeline?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "post_timeline",
  "post_id": "string",
  "from_date": "string",
  "to_date": "string",
  "timeline": [
    {
      "date": "string",
      "posting_id": "string",
      "account_id": "string",
      "platform": "string",
      "platform_post_id": "string",
      "metrics": {
        "impressions": 1.5,
        "reach": 1.5,
        "views": 1.5,
        "likes": 1.5,
        "comments": 1.5,
        "shares": 1.5
      }
    }
  ]
}
```

## Sync external posts of an account now

`POST /posts/sync-external`

Fetches the account's latest posts from the network (including posts published natively), imports them with their metrics and, with url or post_id, returns the matching post. Debounced per account (15 s).

Access: `write` · MCP tool: `sync-external-posts` · Zernio: `POST /v1/posts/sync-external`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `url` (string; ≤ 2000 characters)
- `post_id` (string; ≤ 300 characters): Platform post id

```bash
curl -X POST "https://api.socialit.com/v1/posts/sync-external" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "url": "https://example.com",
    "post_id": "string"
  }'
```

Response 200:

```json
{
  "object": "external_post_sync",
  "account_id": "string",
  "synced": {
    "posts_found": 1,
    "posts_synced": 1,
    "skipped": true
  },
  "found": true,
  "post": {
    "object": "external_post",
    "post_id": "string",
    "posting_id": "string",
    "account_id": "string",
    "platform": "string",
    "platform_post_id": "string",
    "platform_post_url": "https://example.com",
    "content": "string",
    "published_at": "2026-10-13T09:00:00.000Z",
    "metrics": {
      "impressions": 1.5,
      "reach": 1.5,
      "views": 1.5,
      "likes": 1.5,
      "comments": 1.5,
      "shares": 1.5
    }
  },
  "posts": [
    {
      "object": "external_post",
      "post_id": "string",
      "posting_id": "string",
      "account_id": "string",
      "platform": "string",
      "platform_post_id": "string",
      "platform_post_url": "https://example.com",
      "content": "string",
      "published_at": "2026-10-13T09:00:00.000Z",
      "metrics": {
        "impressions": 1.5,
        "reach": 1.5,
        "views": 1.5,
        "likes": 1.5,
        "comments": 1.5,
        "shares": 1.5
      }
    }
  ]
}
```

## Get an analytics dashboard

`GET /analytics/dashboard`

Totals, follower growth, a daily series, top and recent posts in one call. Daily and total metrics use received attribution. Cross-network totals are Socialit-calculated (calculated: true) and come with a per-platform breakdown; YouTube numbers are never folded into derived rates. Pinterest analytics are never stored and are absent from stored aggregates.

Access: `read` · MCP tool: `get-analytics-dashboard` · Zernio: `GET /v1/analytics/dashboard`

### Query parameters

- `platform` (string): Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"
- `profile_id` (string): Profile id (pro_…) or "all"
- `account_id` (string; 1–80 characters): Account id (sa_…)
- `from_date` (string; required): UTC day (YYYY-MM-DD)
- `to_date` (string; required): UTC day (YYYY-MM-DD)
- `compare` (string; one of previous_period)
- `top_posts` (integer; 0–25)
- `recent_posts` (integer; 0–25)

```bash
curl "https://api.socialit.com/v1/analytics/dashboard?from_date=value&to_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "analytics_dashboard",
  "date_range": {
    "from_date": "string",
    "to_date": "string"
  },
  "calculated": true,
  "totals": {
    "impressions": 1.5,
    "reach": 1.5,
    "likes": 1.5,
    "comments": 1.5,
    "shares": 1.5,
    "saves": 1.5,
    "clicks": 1.5,
    "views": 1.5,
    "engagement": 1.5,
    "engagement_rate": 1.5
  },
  "previous_totals": {
    "impressions": 1.5,
    "reach": 1.5,
    "likes": 1.5,
    "comments": 1.5,
    "shares": 1.5,
    "saves": 1.5,
    "clicks": 1.5,
    "views": 1.5,
    "engagement": 1.5,
    "engagement_rate": 1.5
  },
  "followers": {
    "current": 1.5,
    "gained": 1.5,
    "by_account": [
      {
        "account_id": "string",
        "platform": "string",
        "current": 1.5,
        "gained": 1.5
      }
    ]
  },
  "previous_followers": {
    "current": 1.5,
    "gained": 1.5,
    "by_account": [
      {
        "account_id": "string",
        "platform": "string",
        "current": 1.5,
        "gained": 1.5
      }
    ]
  },
  "daily": [
    {
      "date": "string",
      "impressions": 1.5,
      "reach": 1.5,
      "engagement": 1.5,
      "views": 1.5,
      "followers_gained": 1.5
    }
  ],
  "platform_breakdown": [
    {
      "platform": "string",
      "posts": 1.5,
      "impressions": 1.5,
      "reach": 1.5,
      "likes": 1.5,
      "comments": 1.5,
      "shares": 1.5,
      "saves": 1.5,
      "clicks": 1.5,
      "views": 1.5,
      "engagement": 1.5,
      "followers": 1.5
    }
  ],
  "top_posts": [
    {
      "post_id": "string",
      "posting_id": "string",
      "account_id": "string",
      "platform": "string",
      "content": "string",
      "platform_post_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "published_at": "2026-10-13T09:00:00.000Z",
      "metrics": {
        "impressions": 1.5,
        "reach": 1.5,
        "likes": 1.5,
        "comments": 1.5,
        "shares": 1.5,
        "saves": 1.5
      }
    }
  ],
  "recent_posts": [
    {
      "post_id": "string",
      "posting_id": "string",
      "account_id": "string",
      "platform": "string",
      "content": "string",
      "platform_post_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "published_at": "2026-10-13T09:00:00.000Z",
      "metrics": {
        "impressions": 1.5,
        "reach": 1.5,
        "likes": 1.5,
        "comments": 1.5,
        "shares": 1.5,
        "saves": 1.5
      }
    }
  ],
  "data_as_of": "2026-10-13T09:00:00.000Z"
}
```

## Get daily aggregated metrics

`GET /analytics/daily-metrics`

Per-day post counts and summed metrics plus a platform breakdown. Defaults to the last 180 days. Cross-network totals are Socialit-calculated (calculated: true) and come with a per-platform breakdown; YouTube numbers are never folded into derived rates. Pinterest analytics are never stored and are absent from stored aggregates.

Access: `read` · MCP tool: `get-daily-metrics` · Zernio: `GET /v1/analytics/daily-metrics`

### Query parameters

- `platform` (string): Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"
- `profile_id` (string): Profile id (pro_…) or "all"
- `account_id` (string; 1–80 characters): Account id (sa_…)
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `source` (string; one of all, socialit, late, external): all (default), socialit (published through Socialit; alias late), external (imported)
- `attribution` (string; one of publish, received)

```bash
curl "https://api.socialit.com/v1/analytics/daily-metrics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "daily_metrics",
  "from_date": "string",
  "to_date": "string",
  "attribution": "publish",
  "calculated": true,
  "daily": [
    {
      "date": "string",
      "post_count": 1,
      "platforms": {},
      "metrics": {
        "impressions": 1.5,
        "reach": 1.5,
        "likes": 1.5,
        "comments": 1.5,
        "shares": 1.5,
        "saves": 1.5
      }
    }
  ],
  "platform_breakdown": [
    {
      "platform": "string",
      "post_count": 1,
      "impressions": 1.5,
      "reach": 1.5,
      "likes": 1.5,
      "comments": 1.5,
      "shares": 1.5,
      "saves": 1.5,
      "clicks": 1.5,
      "views": 1.5
    }
  ]
}
```

## Get the best times to post

`GET /analytics/best-time`

Average engagement of published posts by UTC weekday (0 = Sunday) and hour, best slots first.

Access: `read` · MCP tool: `get-best-time-to-post` · Zernio: `GET /v1/analytics/best-time`

### Query parameters

- `platform` (string): Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"
- `profile_id` (string): Profile id (pro_…) or "all"
- `account_id` (string; 1–80 characters): Account id (sa_…)
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `source` (string; one of all, socialit, late, external): all (default), socialit (published through Socialit; alias late), external (imported)

```bash
curl "https://api.socialit.com/v1/analytics/best-time" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "best_time",
  "timezone": "Europe/Prague",
  "slots": [
    {
      "day_of_week": 1,
      "hour": 1,
      "avg_engagement": 1.5,
      "post_count": 1
    }
  ]
}
```

## Get content performance decay

`GET /analytics/content-decay`

Average share of a post's final engagement reached 1h, 6h, 24h, 3d, 7d and 30d after publishing.

Access: `read` · MCP tool: `get-content-decay` · Zernio: `GET /v1/analytics/content-decay`

### Query parameters

- `platform` (string): Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"
- `profile_id` (string): Profile id (pro_…) or "all"
- `account_id` (string; 1–80 characters): Account id (sa_…)
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `source` (string; one of all, socialit, late, external): all (default), socialit (published through Socialit; alias late), external (imported)

```bash
curl "https://api.socialit.com/v1/analytics/content-decay" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "content_decay",
  "buckets": [
    {
      "bucket_order": 1,
      "bucket_label": "string",
      "avg_pct_of_final": 1.5,
      "post_count": 1
    }
  ]
}
```

## Get posting frequency vs engagement

`GET /analytics/posting-frequency`

Average engagement rate and engagement per platform for each observed posts-per-week cadence.

Access: `read` · MCP tool: `get-posting-frequency` · Zernio: `GET /v1/analytics/posting-frequency`

### Query parameters

- `platform` (string): Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"
- `profile_id` (string): Profile id (pro_…) or "all"
- `account_id` (string; 1–80 characters): Account id (sa_…)
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `source` (string; one of all, socialit, late, external): all (default), socialit (published through Socialit; alias late), external (imported)

```bash
curl "https://api.socialit.com/v1/analytics/posting-frequency" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "posting_frequency",
  "frequency": [
    {
      "platform": "string",
      "posts_per_week": 1,
      "avg_engagement_rate": 1.5,
      "avg_engagement": 1.5,
      "weeks_count": 1
    }
  ]
}
```

## Get stored analytics of an account

`GET /analytics/accounts/{accountId}`

Daily follower snapshots and normalized daily insights collected by the analytics sync (Pinterest: live, cached for an hour).

Access: `read` · MCP tool: `get-account-analytics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Query parameters

- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)

```bash
curl "https://api.socialit.com/v1/analytics/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "account_analytics",
  "account_id": "string",
  "platform": "string",
  "username": "string",
  "date_range": {
    "from_date": "string",
    "to_date": "string"
  },
  "current": {
    "followers": 1,
    "following": 1,
    "posts_count": 1,
    "date": "string"
  },
  "snapshots": [
    {
      "date": "string",
      "followers": 1,
      "following": 1,
      "posts_count": 1
    }
  ],
  "insights": [
    {
      "date": "string",
      "metrics": {}
    }
  ],
  "totals": {
    "key": 1.5
  },
  "last_synced_at": "2026-10-13T09:00:00.000Z",
  "cached": true
}
```

## Get audience demographics of an account

`GET /analytics/accounts/{accountId}/demographics`

Live audience demographics from the network (age, gender, country, city, locale where available).

Access: `read` · MCP tool: `get-account-demographics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Query parameters

- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)

```bash
curl "https://api.socialit.com/v1/analytics/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/demographics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "demographics",
  "account_id": "string",
  "platform": "string",
  "metric": "string",
  "timeframe": "string",
  "video_id": "string",
  "title": "string",
  "published_at": "2026-10-13T09:00:00.000Z",
  "snapshot_date": "string",
  "date_range": {
    "since": "string",
    "until": "string"
  },
  "demographics": {
    "key": [
      {
        "dimension": "string",
        "value": 1.5
      }
    ]
  },
  "note": "string"
}
```

## Run a network analytics report

`GET /analytics/accounts/{accountId}/reports/{report}`

Live network-specific report (e.g. YouTube traffic sources, Pinterest top pins, Threads benchmarks). Extra query parameters are passed to the report.

Access: `read` · MCP tool: `get-account-report`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)
- `report` (string; required; 1–80 characters)

### Query parameters

- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)

```bash
curl "https://api.socialit.com/v1/analytics/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reports/REPORT" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "platform_report",
  "account_id": "string",
  "platform": "string",
  "report": "string",
  "data": {}
}
```

## Queue an analytics sync for an account

`POST /analytics/accounts/{accountId}/sync`

Refreshes stats, insights and post metrics in the background (202). analytics.synced fires when it completes.

Access: `write` · MCP tool: `sync-account-analytics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `scope` (array of string; ≥ 1 items, unique)

```bash
curl -X POST "https://api.socialit.com/v1/analytics/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/sync" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": [
      "stats"
    ]
  }'
```

Response 202:

```json
{
  "object": "analytics_sync",
  "account_id": "string",
  "status": "queued",
  "scope": [
    "string"
  ],
  "queued_at": "2026-10-13T09:00:00.000Z"
}
```

## Get YouTube channel insights

`GET /analytics/youtube/channel-insights`

Channel metrics from YouTube Analytics (2-3 day delay, max 89 days). Requires the yt-analytics.readonly scope.

Access: `read` · MCP tool: `get-youtube-channel-insights` · Zernio: `GET /v1/analytics/youtube/channel-insights`

### Query parameters

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `metrics` (string): Comma-separated metric names (network vocabulary)
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `metric_type` (string; one of total_value, time_series)

```bash
curl "https://api.socialit.com/v1/analytics/youtube/channel-insights?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "account_insights",
  "account_id": "string",
  "platform": "string",
  "date_range": {
    "since": "string",
    "until": "string"
  },
  "metric_type": "total_value",
  "breakdown": "string",
  "metrics": {
    "key": {
      "total": 1.5,
      "values": [
        {
          "date": "string",
          "value": 1.5
        }
      ],
      "breakdowns": [
        {
          "dimension": "string",
          "value": 1.5
        }
      ],
      "unit": "string",
      "currency": "USD"
    }
  },
  "unavailable_metrics": [
    {
      "metric": "string",
      "reason": "string",
      "message": "string"
    }
  ],
  "data_delay": "string"
}
```

## Get YouTube daily views of a video

`GET /analytics/youtube/daily-views`

Daily views, watch time and subscriber changes of one video (max 90 days; default ends 3 days ago).

Access: `read` · MCP tool: `get-youtube-daily-views` · Zernio: `GET /v1/analytics/youtube/daily-views`

### Query parameters

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `video_id` (string; required; 1–64 characters)
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)

```bash
curl "https://api.socialit.com/v1/analytics/youtube/daily-views?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd&video_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "youtube_daily_views",
  "account_id": "string",
  "video_id": "string",
  "title": "string",
  "duration_seconds": 1,
  "date_range": {
    "since": "string",
    "until": "string"
  },
  "provisional_since": "string",
  "total_views": 1.5,
  "daily_views": [
    {
      "date": "string",
      "views": 1.5,
      "estimated_minutes_watched": 1.5,
      "average_view_duration": 1.5,
      "average_view_percentage": 1.5,
      "subscribers_gained": 1.5,
      "subscribers_lost": 1.5,
      "likes": 1.5,
      "comments": 1.5,
      "shares": 1.5
    }
  ],
  "last_synced_at": "2026-10-13T09:00:00.000Z"
}
```

## Get the YouTube audience retention curve of a video

`GET /analytics/youtube/video-retention`

Access: `read` · MCP tool: `get-youtube-video-retention` · Zernio: `GET /v1/analytics/youtube/video-retention`

### Query parameters

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `video_id` (string; required; 1–64 characters)
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)

```bash
curl "https://api.socialit.com/v1/analytics/youtube/video-retention?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd&video_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "youtube_video_retention",
  "account_id": "string",
  "video_id": "string",
  "title": "string",
  "published_at": "2026-10-13T09:00:00.000Z",
  "duration_seconds": 1,
  "date_range": {
    "since": "string",
    "until": "string"
  },
  "provisional_since": "string",
  "retention_curve": [
    {
      "elapsed_video_time_ratio": 1.5,
      "audience_watch_ratio": 1.5,
      "relative_retention_performance": 1.5,
      "started_watching": 1.5,
      "stopped_watching": 1.5,
      "total_segment_impressions": 1.5
    }
  ],
  "note": "string"
}
```

## Get YouTube audience demographics

`GET /analytics/youtube/demographics`

Age and gender are viewer percentages; country values are views. Channel-wide or one video with video_id.

Access: `read` · MCP tool: `get-youtube-demographics` · Zernio: `GET /v1/analytics/youtube/demographics`

### Query parameters

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `video_id` (string; ≤ 64 characters)
- `breakdown` (string): age,gender,country
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)

```bash
curl "https://api.socialit.com/v1/analytics/youtube/demographics?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "demographics",
  "account_id": "string",
  "platform": "string",
  "metric": "string",
  "timeframe": "string",
  "video_id": "string",
  "title": "string",
  "published_at": "2026-10-13T09:00:00.000Z",
  "snapshot_date": "string",
  "date_range": {
    "since": "string",
    "until": "string"
  },
  "demographics": {
    "key": [
      {
        "dimension": "string",
        "value": 1.5
      }
    ]
  },
  "note": "string"
}
```

## Get LinkedIn organization analytics

`GET /analytics/linkedin/org-aggregate-analytics`

Share, follower and page statistics of a LinkedIn organization page (max 89 days).

Access: `read` · MCP tool: `get-linkedin-org-analytics` · Zernio: `GET /v1/analytics/linkedin/org-aggregate-analytics`

### Query parameters

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `metrics` (string): Comma-separated metric names (network vocabulary)
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `metric_type` (string; one of total_value, time_series)

```bash
curl "https://api.socialit.com/v1/analytics/linkedin/org-aggregate-analytics?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "account_insights",
  "account_id": "string",
  "platform": "string",
  "date_range": {
    "since": "string",
    "until": "string"
  },
  "metric_type": "total_value",
  "breakdown": "string",
  "metrics": {
    "key": {
      "total": 1.5,
      "values": [
        {
          "date": "string",
          "value": 1.5
        }
      ],
      "breakdowns": [
        {
          "dimension": "string",
          "value": 1.5
        }
      ],
      "unit": "string",
      "currency": "USD"
    }
  },
  "unavailable_metrics": [
    {
      "metric": "string",
      "reason": "string",
      "message": "string"
    }
  ],
  "data_delay": "string"
}
```

## Get LinkedIn personal account aggregate stats

`GET /accounts/{accountId}/linkedin/aggregate-analytics`

Totals or daily series across the member's posts (posts published through Socialit; LinkedIn API limitation).

Access: `read` · MCP tool: `get-linkedin-aggregate-analytics` · Zernio: `GET /v1/accounts/{accountId}/linkedin-aggregate-analytics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Query parameters

- `aggregation` (string; one of TOTAL, DAILY)
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `metrics` (string): IMPRESSION,MEMBERS_REACHED,REACTION,COMMENT,RESHARE,POST_SAVE,POST_SEND

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/aggregate-analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "linkedin_aggregate_analytics",
  "account_id": "string",
  "platform": "string",
  "account_type": "string",
  "username": "string",
  "aggregation": "TOTAL",
  "date_range": {
    "since": "string",
    "until": "string"
  },
  "analytics": {
    "key": 1.5
  },
  "skipped_metrics": [
    "string"
  ],
  "note": "string",
  "last_updated": "2026-10-13T09:00:00.000Z"
}
```

## Get LinkedIn post stats

`GET /accounts/{accountId}/linkedin/post-analytics`

Access: `read` · MCP tool: `get-linkedin-post-analytics` · Zernio: `GET /v1/accounts/{accountId}/linkedin-post-analytics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Query parameters

- `urn` (string; required; 1–300 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/post-analytics?urn=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "linkedin_post_analytics",
  "account_id": "string",
  "platform": "string",
  "account_type": "string",
  "username": "string",
  "post_urn": "string",
  "analytics": {
    "impressions": 1.5,
    "reach": 1.5,
    "likes": 1.5,
    "comments": 1.5,
    "shares": 1.5,
    "saves": 1.5,
    "sends": 1.5,
    "clicks": 1.5,
    "views": 1.5,
    "engagement_rate": 1.5
  },
  "last_updated": "2026-10-13T09:00:00.000Z"
}
```

## Get LinkedIn post reactions

`GET /accounts/{accountId}/linkedin/post-reactions`

Individual reactions on an organization post (offset cursor).

Access: `read` · MCP tool: `get-linkedin-post-reactions` · Zernio: `GET /v1/accounts/{accountId}/linkedin-post-reactions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Query parameters

- `urn` (string; required; 1–300 characters)
- `limit` (integer; 1–100)
- `cursor` (integer)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/post-reactions?urn=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "linkedin_post_reactions",
  "account_id": "string",
  "post_urn": "string",
  "data": [
    {
      "reaction_type": "string",
      "reaction_label": "string",
      "reacted_at": "2026-10-13T09:00:00.000Z",
      "from": {
        "urn": "string",
        "name": "string",
        "headline": "string",
        "username": "string",
        "profile_picture": "string",
        "profile_url": "https://example.com"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "string",
  "total": 1,
  "last_updated": "2026-10-13T09:00:00.000Z"
}
```

## Get TikTok account insights

`GET /analytics/tiktok/account-insights`

Live counters plus daily history joined from Socialit snapshots (max 89 days).

Access: `read` · MCP tool: `get-tiktok-account-insights` · Zernio: `GET /v1/analytics/tiktok/account-insights`

### Query parameters

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `metrics` (string): Comma-separated metric names (network vocabulary)
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `metric_type` (string; one of total_value, time_series)

```bash
curl "https://api.socialit.com/v1/analytics/tiktok/account-insights?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "account_insights",
  "account_id": "string",
  "platform": "string",
  "date_range": {
    "since": "string",
    "until": "string"
  },
  "metric_type": "total_value",
  "breakdown": "string",
  "metrics": {
    "key": {
      "total": 1.5,
      "values": [
        {
          "date": "string",
          "value": 1.5
        }
      ],
      "breakdowns": [
        {
          "dimension": "string",
          "value": 1.5
        }
      ],
      "unit": "string",
      "currency": "USD"
    }
  },
  "unavailable_metrics": [
    {
      "metric": "string",
      "reason": "string",
      "message": "string"
    }
  ],
  "data_delay": "string"
}
```

## Get Facebook Page insights

`GET /analytics/facebook/page-insights`

Current (post-November 2025) Page metrics; followers_gained / followers_lost are synthesized from daily follows/unfollows (max 89 days).

Access: `read` · MCP tool: `get-facebook-page-insights` · Zernio: `GET /v1/analytics/facebook/page-insights`

### Query parameters

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `metrics` (string): Comma-separated metric names (network vocabulary)
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `metric_type` (string; one of total_value, time_series)

```bash
curl "https://api.socialit.com/v1/analytics/facebook/page-insights?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "account_insights",
  "account_id": "string",
  "platform": "string",
  "date_range": {
    "since": "string",
    "until": "string"
  },
  "metric_type": "total_value",
  "breakdown": "string",
  "metrics": {
    "key": {
      "total": 1.5,
      "values": [
        {
          "date": "string",
          "value": 1.5
        }
      ],
      "breakdowns": [
        {
          "dimension": "string",
          "value": 1.5
        }
      ],
      "unit": "string",
      "currency": "USD"
    }
  },
  "unavailable_metrics": [
    {
      "metric": "string",
      "reason": "string",
      "message": "string"
    }
  ],
  "data_delay": "string"
}
```

## Get lifetime monetization earnings of a Facebook post

`GET /analytics/facebook/post-earnings`

Lifetime (cumulative) values in the platform's raw unit; never sum across posts or dates.

Access: `read` · MCP tool: `get-facebook-post-earnings` · Zernio: `GET /v1/analytics/facebook/post-earnings`

### Query parameters

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `post_id` (string; required; 1–200 characters)
- `metrics` (string): Comma-separated metric names (network vocabulary)

```bash
curl "https://api.socialit.com/v1/analytics/facebook/post-earnings?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd&post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "post_earnings",
  "account_id": "string",
  "platform": "string",
  "post_id": "string",
  "period": "lifetime",
  "metrics": {
    "key": {
      "total": 1.5,
      "unit": "string",
      "currency": "USD"
    }
  },
  "unavailable_metrics": [
    {
      "metric": "string",
      "reason": "string",
      "message": "string"
    }
  ],
  "data_delay": "string"
}
```

## Get Facebook Page follower demographics

`GET /analytics/facebook/demographics`

Followers by country and city (Meta removed age and gender for Pages in November 2025).

Access: `read` · MCP tool: `get-facebook-demographics` · Zernio: `GET /v1/analytics/facebook/demographics`

### Query parameters

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `breakdown` (string): country,city

```bash
curl "https://api.socialit.com/v1/analytics/facebook/demographics?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "demographics",
  "account_id": "string",
  "platform": "string",
  "metric": "string",
  "timeframe": "string",
  "video_id": "string",
  "title": "string",
  "published_at": "2026-10-13T09:00:00.000Z",
  "snapshot_date": "string",
  "date_range": {
    "since": "string",
    "until": "string"
  },
  "demographics": {
    "key": [
      {
        "dimension": "string",
        "value": 1.5
      }
    ]
  },
  "note": "string"
}
```

## Get the reaction breakdown of a Facebook post

`GET /accounts/{accountId}/facebook/post-reactions`

Access: `read` · MCP tool: `get-facebook-post-reactions` · Zernio: `GET /v1/accounts/{accountId}/facebook-post-reactions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Query parameters

- `post_id` (string; required; 1–200 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/post-reactions?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "facebook_post_reactions",
  "account_id": "string",
  "platform": "string",
  "username": "string",
  "post_id": "string",
  "total": 1.5,
  "breakdown": {
    "like": 1.5,
    "love": 1.5,
    "haha": 1.5,
    "wow": 1.5,
    "sad": 1.5,
    "angry": 1.5,
    "care": 1.5
  },
  "last_updated": "2026-10-13T09:00:00.000Z"
}
```

## Get Instagram account insights

`GET /analytics/instagram/account-insights`

Only reach supports metric_type=time_series (Instagram API limitation). Breakdowns need metric_type=total_value.

Access: `read` · MCP tool: `get-instagram-account-insights` · Zernio: `GET /v1/analytics/instagram/account-insights`

### Query parameters

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `metrics` (string): Comma-separated metric names (network vocabulary)
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `metric_type` (string; one of total_value, time_series)
- `breakdown` (string; one of media_product_type, follow_type, follower_type, contact_button_type)

```bash
curl "https://api.socialit.com/v1/analytics/instagram/account-insights?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "account_insights",
  "account_id": "string",
  "platform": "string",
  "date_range": {
    "since": "string",
    "until": "string"
  },
  "metric_type": "total_value",
  "breakdown": "string",
  "metrics": {
    "key": {
      "total": 1.5,
      "values": [
        {
          "date": "string",
          "value": 1.5
        }
      ],
      "breakdowns": [
        {
          "dimension": "string",
          "value": 1.5
        }
      ],
      "unit": "string",
      "currency": "USD"
    }
  },
  "unavailable_metrics": [
    {
      "metric": "string",
      "reason": "string",
      "message": "string"
    }
  ],
  "data_delay": "string"
}
```

## Get Instagram follower history

`GET /analytics/instagram/follower-history`

Daily follower count from Socialit snapshots joined with Instagram's new-follower series (max 89 days).

Access: `read` · MCP tool: `get-instagram-follower-history` · Zernio: `GET /v1/analytics/instagram/follower-history`

### Query parameters

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `metrics` (string): Comma-separated metric names (network vocabulary)
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `metric_type` (string; one of total_value, time_series)

```bash
curl "https://api.socialit.com/v1/analytics/instagram/follower-history?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "account_insights",
  "account_id": "string",
  "platform": "string",
  "date_range": {
    "since": "string",
    "until": "string"
  },
  "metric_type": "total_value",
  "breakdown": "string",
  "metrics": {
    "key": {
      "total": 1.5,
      "values": [
        {
          "date": "string",
          "value": 1.5
        }
      ],
      "breakdowns": [
        {
          "dimension": "string",
          "value": 1.5
        }
      ],
      "unit": "string",
      "currency": "USD"
    }
  },
  "unavailable_metrics": [
    {
      "metric": "string",
      "reason": "string",
      "message": "string"
    }
  ],
  "data_delay": "string"
}
```

## Get Instagram audience demographics

`GET /analytics/instagram/demographics`

Top 45 entries per dimension; requires at least 100 followers.

Access: `read` · MCP tool: `get-instagram-demographics` · Zernio: `GET /v1/analytics/instagram/demographics`

### Query parameters

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `metric` (string; one of follower_demographics, engaged_audience_demographics)
- `breakdown` (string): age,city,country,gender
- `timeframe` (string; one of this_week, this_month)

```bash
curl "https://api.socialit.com/v1/analytics/instagram/demographics?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "demographics",
  "account_id": "string",
  "platform": "string",
  "metric": "string",
  "timeframe": "string",
  "video_id": "string",
  "title": "string",
  "published_at": "2026-10-13T09:00:00.000Z",
  "snapshot_date": "string",
  "date_range": {
    "since": "string",
    "until": "string"
  },
  "demographics": {
    "key": [
      {
        "dimension": "string",
        "value": 1.5
      }
    ]
  },
  "note": "string"
}
```

## Get Instagram followers online per hour

`GET /analytics/instagram/online-followers`

Access: `read` · MCP tool: `get-instagram-online-followers` · Zernio: `GET /v1/analytics/instagram/online-followers`

### Query parameters

- `account_id` (string; required; 1–80 characters): Account id (sa_…)

```bash
curl "https://api.socialit.com/v1/analytics/instagram/online-followers?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "online_followers",
  "account_id": "string",
  "platform": "string",
  "metric": "string",
  "days": [
    {
      "end_time": "string",
      "hours": {}
    }
  ],
  "note": "string"
}
```

## Get Google Business Profile performance metrics

`GET /analytics/googlebusiness/performance`

Daily impressions, clicks, calls, directions, conversations, bookings and food orders (2-3 day delay, up to 18 months back).

Access: `read` · MCP tool: `get-google-business-performance` · Zernio: `GET /v1/analytics/googlebusiness/performance`

### Query parameters

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `metrics` (string): Comma-separated metric names (network vocabulary)
- `from_date` (string): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)

```bash
curl "https://api.socialit.com/v1/analytics/googlebusiness/performance?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "account_insights",
  "account_id": "string",
  "platform": "string",
  "date_range": {
    "since": "string",
    "until": "string"
  },
  "metric_type": "total_value",
  "breakdown": "string",
  "metrics": {
    "key": {
      "total": 1.5,
      "values": [
        {
          "date": "string",
          "value": 1.5
        }
      ],
      "breakdowns": [
        {
          "dimension": "string",
          "value": 1.5
        }
      ],
      "unit": "string",
      "currency": "USD"
    }
  },
  "unavailable_metrics": [
    {
      "metric": "string",
      "reason": "string",
      "message": "string"
    }
  ],
  "data_delay": "string"
}
```

## Get Google Business Profile search keywords

`GET /analytics/googlebusiness/search-keywords`

Access: `read` · MCP tool: `get-google-business-search-keywords` · Zernio: `GET /v1/analytics/googlebusiness/search-keywords`

### Query parameters

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `start_month` (string; pattern ^\d{4}-\d{2}$)
- `end_month` (string; pattern ^\d{4}-\d{2}$)

```bash
curl "https://api.socialit.com/v1/analytics/googlebusiness/search-keywords?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "search_keywords",
  "account_id": "string",
  "platform": "string",
  "month_range": {
    "start_month": "string",
    "end_month": "string"
  },
  "keywords": [
    {
      "keyword": "string",
      "impressions": 1.5
    }
  ],
  "note": "string"
}
```

## Get inbox messaging volume

`GET /analytics/inbox/volume`

Access: `read` · MCP tool: `get-inbox-volume` · Zernio: `GET /v1/analytics/inbox/volume`

### Query parameters

- `from_date` (string; required): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `platform` (string): Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"
- `profile_id` (string): Profile id (pro_…) or "all"
- `account_id` (string; 1–80 characters): Account id (sa_…)
- `source` (string; one of human, api, workflow, sequence, broadcast, comment_automation, automation, contact, platform)

```bash
curl "https://api.socialit.com/v1/analytics/inbox/volume?from_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "inbox_volume",
  "from_date": "string",
  "to_date": "string",
  "summary": {
    "received": 1,
    "sent": 1,
    "read": 1,
    "failed": 1,
    "unique_conversations": 1
  },
  "timeseries": [
    {
      "date": "string",
      "received": 1,
      "sent": 1,
      "read": 1,
      "failed": 1
    }
  ],
  "by_platform": [
    {
      "platform": "string",
      "received": 1,
      "sent": 1,
      "read": 1,
      "failed": 1
    }
  ]
}
```

## Get the inbox day × hour heatmap

`GET /analytics/inbox/heatmap`

Sparse buckets; dow is ISO (1 = Monday … 7 = Sunday), hours in UTC.

Access: `read` · MCP tool: `get-inbox-heatmap` · Zernio: `GET /v1/analytics/inbox/heatmap`

### Query parameters

- `from_date` (string; required): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `platform` (string): Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"
- `profile_id` (string): Profile id (pro_…) or "all"
- `account_id` (string; 1–80 characters): Account id (sa_…)
- `source` (string; one of human, api, workflow, sequence, broadcast, comment_automation, automation, contact, platform)
- `action` (string; one of message.received, message.sent, message.read, all)

```bash
curl "https://api.socialit.com/v1/analytics/inbox/heatmap?from_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "inbox_heatmap",
  "from_date": "string",
  "to_date": "string",
  "buckets": [
    {
      "dow": 1,
      "hour": 1,
      "received": 1,
      "sent": 1,
      "read": 1
    }
  ]
}
```

## Get inbox messages by source

`GET /analytics/inbox/source-breakdown`

Access: `read` · MCP tool: `get-inbox-source-breakdown` · Zernio: `GET /v1/analytics/inbox/source-breakdown`

### Query parameters

- `from_date` (string; required): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `platform` (string): Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"
- `profile_id` (string): Profile id (pro_…) or "all"
- `account_id` (string; 1–80 characters): Account id (sa_…)

```bash
curl "https://api.socialit.com/v1/analytics/inbox/source-breakdown?from_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "inbox_source_breakdown",
  "from_date": "string",
  "to_date": "string",
  "sources": [
    {
      "source": "string",
      "received": 1,
      "sent": 1,
      "read": 1,
      "by_platform": [
        {
          "platform": "string",
          "received": 1,
          "sent": 1,
          "read": 1
        }
      ]
    }
  ]
}
```

## Get inbox response-time stats

`GET /analytics/inbox/response-time`

Time to first response (each inbound streak paired with the next outbound message), summary and histogram.

Access: `read` · MCP tool: `get-inbox-response-time` · Zernio: `GET /v1/analytics/inbox/response-time`

### Query parameters

- `from_date` (string; required): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `platform` (string): Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"
- `profile_id` (string): Profile id (pro_…) or "all"
- `account_id` (string; 1–80 characters): Account id (sa_…)

```bash
curl "https://api.socialit.com/v1/analytics/inbox/response-time?from_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "inbox_response_time",
  "from_date": "string",
  "to_date": "string",
  "summary": {
    "sample_size": 1,
    "median_seconds": 1,
    "p90_seconds": 1,
    "p99_seconds": 1,
    "mean_seconds": 1,
    "fastest_seconds": 1,
    "slowest_seconds": 1
  },
  "histogram": [
    {
      "bucket": "string",
      "lower_seconds": 1,
      "upper_seconds": 1,
      "count": 1
    }
  ]
}
```

## Get top accounts by inbox volume

`GET /analytics/inbox/top-accounts`

Access: `read` · MCP tool: `get-inbox-top-accounts` · Zernio: `GET /v1/analytics/inbox/top-accounts`

### Query parameters

- `from_date` (string; required): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `platform` (string): Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"
- `profile_id` (string): Profile id (pro_…) or "all"
- `account_id` (string; 1–80 characters): Account id (sa_…)
- `source` (string; one of human, api, workflow, sequence, broadcast, comment_automation, automation, contact, platform)
- `limit` (integer; 1–50)

```bash
curl "https://api.socialit.com/v1/analytics/inbox/top-accounts?from_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "inbox_top_accounts",
  "from_date": "string",
  "to_date": "string",
  "accounts": [
    {
      "account_id": "string",
      "platform": "string",
      "display_name": "string",
      "username": "string",
      "received": 1,
      "sent": 1,
      "total": 1,
      "conversations": 1,
      "median_response_seconds": 1,
      "replied_count": 1
    }
  ]
}
```

## List conversation analytics

`GET /analytics/inbox/conversations`

Access: `read` · MCP tool: `list-conversation-analytics` · Zernio: `GET /v1/analytics/inbox/conversations`

### Query parameters

- `from_date` (string; required): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)
- `platform` (string): Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"
- `profile_id` (string): Profile id (pro_…) or "all"
- `account_id` (string; 1–80 characters): Account id (sa_…)
- `source` (string; one of human, api, workflow, sequence, broadcast, comment_automation, automation, contact, platform)
- `page` (integer; ≥ 1)
- `limit` (integer; 1–100)
- `sort` (string; one of last_message_at, first_message_at, total_messages, received, sent, read, failed)
- `order` (string; one of asc, desc)

```bash
curl "https://api.socialit.com/v1/analytics/inbox/conversations?from_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "conversation_analytics",
      "conversation_id": "string",
      "platform_conversation_id": "string",
      "account_id": "string",
      "platform": "string",
      "participant_name": "string",
      "participant_username": "string",
      "participant_picture": "string",
      "last_message": "string",
      "total_messages": 1,
      "received": 1,
      "sent": 1,
      "read": 1,
      "failed": 1,
      "first_message_at": "2026-10-13T09:00:00.000Z",
      "last_message_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com",
  "from_date": "string",
  "to_date": "string"
}
```

## Get analytics of one conversation

`GET /analytics/inbox/conversations/{conversationId}`

Access: `read` · MCP tool: `get-conversation-analytics` · Zernio: `GET /v1/analytics/inbox/conversations/{conversationId}`

### Path parameters

- `conversationId` (string; required; 1–300 characters): Conversation id (conv_…) or the platform conversation id

### Query parameters

- `from_date` (string; required): UTC day (YYYY-MM-DD)
- `to_date` (string): UTC day (YYYY-MM-DD)

```bash
curl "https://api.socialit.com/v1/analytics/inbox/conversations/CONVERSATION_ID?from_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "conversation_analytics_detail",
  "conversation_id": "string",
  "platform_conversation_id": "string",
  "platform": "string",
  "from_date": "string",
  "to_date": "string",
  "summary": {
    "received": 1,
    "sent": 1,
    "read": 1,
    "failed": 1,
    "total_messages": 1,
    "first_message_at": "2026-10-13T09:00:00.000Z",
    "last_message_at": "2026-10-13T09:00:00.000Z"
  },
  "timeseries": [
    {
      "date": "string",
      "received": 1,
      "sent": 1,
      "read": 1,
      "failed": 1
    }
  ],
  "by_source": [
    {
      "source": "string",
      "count": 1
    }
  ]
}
```


---

Source: https://socialit.com/docs/api-reference/analytics/
