REST API
Retrieve comprehensive analytics statistics for your project, including total views, top articles, and geographic data.
GET
{{baseUrl}}/v1/analytics/statsAuth required
| Property | Type | Description | Default |
|---|---|---|---|
days | number | Number of days to include in stats | 30 |
| Property | Type | Description | Default |
|---|---|---|---|
period* | { days: number, startDate: string, endDate: string } | - | - |
summary* | { totalViews, uniqueVisitors, avgViewsPerVisitor } | - | - |
requestSource | { sdk: number, direct: number } | Percentage breakdown | - |
topArticles* | Array<{ articleId, title, slug, views }> | - | - |
topCountries* | Array<{ country, views }> | - | - |
cURL Command
curl -X GET "https://api.simplist.blog/v1/analytics/stats?days=7" \
-H "X-API-Key: YOUR_API_KEY"{
"data": {
"period": {
"days": 7,
"startDate": "2025-12-02T00:00:00Z",
"endDate": "2025-12-09T23:59:59Z"
},
"summary": {
"totalViews": 3542,
"uniqueVisitors": 1876,
"avgViewsPerVisitor": 1.89
},
"requestSource": {
"sdk": 75,
"direct": 25
},
"topArticles": [
{
"articleId": "art_123",
"title": "Getting Started with Simplist",
"slug": "getting-started",
"views": 847
},
{
"articleId": "art_456",
"title": "Advanced Features",
"slug": "advanced-features",
"views": 623
}
],
"topCountries": [
{ "country": "United States", "views": 1245 },
{ "country": "France", "views": 687 },
{ "country": "Germany", "views": 432 }
]
}
}- Dashboard: Display project statistics
- Reports: Generate analytics reports
- Monitoring: Track trends over time
- Content strategy: Identify popular articles
If you're using TypeScript/JavaScript, you can use the SDK instead: client.analytics.getStats()