# Analytics API

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| `GET` | `/v1/analytics` | Get general analytics |
| `GET` | `/v1/analytics/youtube/daily-views` | Get YouTube video daily views |
| `GET` | `/v1/accounts/{accountId}/linkedin-aggregate-analytics` | LinkedIn account analytics |
| `GET` | `/v1/accounts/{accountId}/linkedin-post-analytics` | LinkedIn post analytics |
| `GET` | `/v1/accounts/follower-stats` | Follower count history |

## YouTube Daily Views

```bash
curl "https://zernio.com/api/v1/analytics/youtube/daily-views?accountId=ACCOUNT_ID&videoId=VIDEO_ID&startDate=2024-01-01&endDate=2024-01-31" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Response:

```json
{
  "success": true,
  "videoId": "dQw4w9WgXcQ",
  "dateRange": {
    "startDate": "2024-01-01",
    "endDate": "2024-01-31"
  },
  "totalViews": 15420,
  "dailyViews": [
    {
      "date": "2024-01-01",
      "views": 523,
      "estimatedMinutesWatched": 1045,
      "averageViewDuration": 120,
      "subscribersGained": 12,
      "subscribersLost": 2,
      "likes": 45,
      "comments": 8,
      "shares": 15
    }
  ]
}
```

**Note:** Requires `yt-analytics.readonly` scope. If missing, response includes `reauthorizeUrl`.

## LinkedIn Analytics

```bash
# Aggregate analytics for account
curl "https://zernio.com/api/v1/accounts/ACCOUNT_ID/linkedin-aggregate-analytics" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Analytics for specific post
curl "https://zernio.com/api/v1/accounts/ACCOUNT_ID/linkedin-post-analytics?postUrn=URN" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Follower Stats

```bash
curl "https://zernio.com/api/v1/accounts/follower-stats?profileId=PROFILE_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Returns historical follower counts across all connected accounts.