Retrieve pre-calculated metrics and KPIs for your application.
Endpoint
GET /analytics/metrics
Authentication
Required: Bearer token in Authorization header
Authorization: Bearer YOUR_API_KEY
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
app_id | string | Yes | Your application ID |
metric | string | Yes | Metric name (e.g., dau, mau, retention, revenue) |
start_date | string | No | Start date (ISO 8601 format: YYYY-MM-DD) |
end_date | string | No | End date (ISO 8601 format: YYYY-MM-DD) |
granularity | string | No | Time granularity: hour, day (default), week, month |
Available Metrics
dau- Daily Active Usersmau- Monthly Active Usersretention- User Retention Raterevenue- Total Revenuearpu- Average Revenue Per Userconversion- Conversion Ratechurn- Churn Rate
Response
{
"success": true,
"metric": "dau",
"data": [
{
"date": "2024-01-01",
"value": 1250
},
{
"date": "2024-01-02",
"value": 1340
}
],
"metadata": {
"app_id": "app_123",
"start_date": "2024-01-01",
"end_date": "2024-01-31",
"granularity": "day"
}
}
Examples
JavaScript
const params = new URLSearchParams({
app_id: 'app_123',
metric: 'dau',
start_date: '2024-01-01',
end_date: '2024-01-31',
granularity: 'day'
});
const response = await fetch(`https://api.appizer.com/v1/analytics/metrics?${params}`, {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
});
const data = await response.json();
console.log(data);
Python
import requests
params = {
'app_id': 'app_123',
'metric': 'dau',
'start_date': '2024-01-01',
'end_date': '2024-01-31',
'granularity': 'day'
}
response = requests.get(
'https://api.appizer.com/v1/analytics/metrics',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params=params
)
print(response.json())
cURL
curl -X GET "https://api.appizer.com/v1/analytics/metrics?app_id=app_123&metric=dau&start_date=2024-01-01&end_date=2024-01-31&granularity=day" \
-H "Authorization: Bearer YOUR_API_KEY"
Error Responses
| Status Code | Description |
|---|---|
| 400 | Bad Request - Invalid parameters or unsupported metric |
| 401 | Unauthorized - Invalid or missing API key |
| 404 | Not Found - App ID not found |
| 429 | Too Many Requests - Rate limit exceeded (100 requests/minute) |
| 500 | Internal Server Error - Something went wrong on our end |
Rate Limits
- 100 requests per minute
Best Practices
- Use pre-calculated metrics instead of custom queries for better performance
- Request only the date range you need
- Cache metric data when appropriate
- Use appropriate granularity for your use case
- Monitor API usage to stay within rate limits