Usage & Analytics API

Monitor your API usage, view request logs, and track per-key statistics.

Usage Analytics

GET /users/me/analytics

Returns comprehensive analytics for the authenticated user.

Query Parameters

Parameter	Type	Description
period	string	Time period: 7d, 30d, 90d (default: 30d)

Example

curl "https://api.meetbot.dev/v1/users/me/analytics?period=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "apiCalls": {
    "today": 42,
    "thisMonth": 1250,
    "total": 8500,
    "dailyBreakdown": [
      { "date": "2024-01-14", "count": 38 },
      { "date": "2024-01-15", "count": 42 }
    ]
  },
  "bots": {
    "created": 25,
    "active": 2,
    "platformBreakdown": {
      "google": 15,
      "zoom": 8,
      "teams": 2
    },
    "statusBreakdown": {
      "DONE": 20,
      "IN_CALL": 2,
      "FATAL": 3
    },
    "dailyCreated": [
      { "date": "2024-01-14", "count": 1 },
      { "date": "2024-01-15", "count": 3 }
    ]
  },
  "recordings": {
    "total": 20,
    "totalDurationSeconds": 72000,
    "storageUsedMb": 1500.5
  },
  "transcriptions": {
    "total": 15,
    "totalMinutes": 450.5
  },
  "webhooks": {
    "totalDeliveries": 200,
    "successRate": 98.5,
    "avgResponseTimeMs": 125.3
  }
}

API Request Logs

GET /users/me/api-logs

Returns paginated API request logs for the authenticated user.

Query Parameters

Parameter	Type	Description
page	integer	Page number (default: 1)
page_size	integer	Items per page (default: 20, max: 100)
method	string	Filter by HTTP method (GET, POST, etc.)
status_code	integer	Filter by response status code
path	string	Filter by path (substring match)
api_key_id	integer	Filter by specific API key
start_date	string	Filter after this ISO date
end_date	string	Filter before this ISO date

Example

curl "https://api.meetbot.dev/v1/users/me/api-logs?page=1&method=POST" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "logs": [
    {
      "id": 100,
      "method": "POST",
      "path": "/api/v1/bots",
      "statusCode": 201,
      "responseTimeMs": 45,
      "apiKeyId": 1,
      "apiKeyName": "Production Key",
      "ipAddress": "192.168.1.1",
      "userAgent": "curl/7.85.0",
      "createdAt": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 500,
  "page": 1,
  "page_size": 20
}

API Key Usage

GET /api-keys/{key_id}/usage

Returns usage statistics for a specific API key.

Example

curl "https://api.meetbot.dev/v1/api-keys/1/usage" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

{
  "requestsToday": 15,
  "requestsThisMonth": 450,
  "requestsTotal": 2500,
  "recentRequests": [
    {
      "method": "GET",
      "path": "/api/v1/bots",
      "statusCode": 200,
      "createdAt": "2024-01-15T10:30:00Z"
    }
  ]
}