> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kakiyo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics Overview

> Get comprehensive analytics and performance metrics for your entire team

## Overview

Get comprehensive analytics and performance metrics for your entire team. This endpoint provides a complete dashboard view of all campaigns, agents, prospects, and key performance indicators.

## Use Cases

* **Dashboard Creation**: Build comprehensive analytics dashboards
* **Performance Monitoring**: Track team-wide performance metrics
* **Reporting**: Generate executive summaries and reports
* **Trend Analysis**: Monitor activity trends over time

## Response Structure

The response includes four main sections:

### Summary Statistics

* Total campaigns (active, paused, completed)
* Agent metrics (total and active agents)
* Prospect metrics (total, qualified, responses)

### Performance Metrics

* Conversion rates and response rates
* Average messages per prospect
* Qualification rates

### Activity Metrics

* 24-hour activity summary
* Weekly activity trends

### Campaign Breakdown

* Individual campaign performance
* Status distribution

## Example Response

```json theme={null}
{
  "summary": {
    "totalCampaigns": 15,
    "activeCampaigns": 8,
    "pausedCampaigns": 5,
    "completedCampaigns": 2,
    "totalAgents": 3,
    "activeAgents": 2,
    "totalProspects": 1250,
    "totalMessages": 3420,
    "totalQualified": 89,
    "totalAnswers": 234,
    "totalClosed": 45
  },
  "metrics": {
    "conversionRate": 7.12,
    "responseRate": 18.72,
    "averageMessagesPerProspect": 2.74,
    "qualificationRate": 38.03
  },
  "activity": {
    "last24Hours": {
      "messages": 45,
      "qualified": 3
    },
    "lastWeek": {
      "messages": 312,
      "qualified": 18
    }
  },
  "campaigns": [
    {
      "id": "campaign_123",
      "name": "Q4 Enterprise Outreach",
      "status": "active",
      "prospects": 150,
      "messages": 420,
      "qualified": 12,
      "answers": 35,
      "conversionRate": 8.0,
      "responseRate": 23.33
    }
  ]
}
```

## Testing Example

```bash theme={null}
curl -X GET "https://api.kakiyo.com/v1/analytics/overview" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

```javascript theme={null}
// JavaScript/Node.js
const response = await fetch('https://api.kakiyo.com/v1/analytics/overview', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const analytics = await response.json();
console.log('Team Analytics:', analytics);
```

```python theme={null}
# Python
import requests

response = requests.get(
    'https://api.kakiyo.com/v1/analytics/overview',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    }
)

analytics = response.json()
print('Team Analytics:', analytics)
```

## Key Metrics Explained

### Conversion Rate

Percentage of prospects that became qualified leads out of total prospects contacted.

### Response Rate

Percentage of prospects that responded to outreach messages.

### Qualification Rate

Percentage of responding prospects that were marked as qualified.

### Average Messages Per Prospect

Average number of messages sent per prospect across all campaigns.

## Best Practices

1. **Regular Monitoring**: Check analytics daily to identify trends
2. **Performance Comparison**: Compare metrics across different time periods
3. **Campaign Optimization**: Use data to optimize underperforming campaigns
4. **Resource Allocation**: Allocate agents based on performance metrics


## OpenAPI

````yaml GET /analytics/overview
openapi: 3.1.0
info:
  title: Kakiyo API
  description: API for automating LinkedIn outreach campaigns with AI-powered conversations
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.kakiyo.com/v1
security:
  - bearerAuth: []
paths:
  /analytics/overview:
    get:
      summary: Analytics Overview
      description: Get comprehensive analytics and performance metrics for your entire team
      operationId: getAnalyticsOverview
      responses:
        '200':
          description: Analytics overview retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  summary:
                    type: object
                    properties:
                      totalCampaigns:
                        type: integer
                        example: 15
                      activeCampaigns:
                        type: integer
                        example: 8
                      totalProspects:
                        type: integer
                        example: 1250
                      totalQualified:
                        type: integer
                        example: 89
                  metrics:
                    type: object
                    properties:
                      conversionRate:
                        type: number
                        example: 7.12
                      responseRate:
                        type: number
                        example: 18.72
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          example: validation_error
        message:
          type: string
          example: The request parameters failed validation
        details:
          type: array
          items:
            type: object
            properties:
              field:
                type: string
                example: name
              message:
                type: string
                example: The name field is required
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````