# Analytics APIs

The Freddy Analytics APIs provide comprehensive usage tracking and analytics capabilities for organizations, offering deep insights into AI model usage patterns, costs, and optimization opportunities.

## Key Features

- **Multi-timeframe Analysis**: Yearly, monthly, daily, and hourly breakdowns
- **Neurons-focused Analytics**: Specialized insights for neuron usage and optimization
- **API Key Tracking**: Separate analytics for programmatic vs. web usage
- **CHF-only Pricing**: All costs reported in Swiss Francs
- **Synapse-based Metrics**: Modern AI usage measurement (input/output synapses)
- **Organization-scoped**: All data filtered by organization access


## Authentication

All analytics endpoints require API key authentication. The API key must belong to the organization specified in the request path.

**Headers Required:**


```
X-API-Key: your-api-key-here
# or
Api-Key: your-api-key-here
```

## Analytics Categories

### Usage Analytics

Track overall usage patterns across different time periods with detailed cost and request metrics.

### Neurons Analytics

Specialized analytics for neuron usage with optimization insights, efficiency scores, and forecasting.

### API Key Analytics

Monitor programmatic API usage separately from web-based interactions.

## Rate Limits

- **Usage Analytics**: 100 requests per minute per organization
- **Neurons Analytics**: 50 requests per minute per organization
- **API Key Analytics**: 100 requests per minute per organization


## Data Freshness

- **Usage Analytics**: Real-time data from usage events
- **Neurons Analytics**: Aggregated data updated every 15 minutes
- **API Key Analytics**: Real-time data from API key usage