REST API
Get engagement funnel data showing how many visitors reached each scroll milestone (25%, 50%, 75%, 90%). Use this to understand reader engagement and identify content drop-off points.
GET
{{baseUrl}}/v1/analytics/funnelAuth required
| Property | Type | Description | Default |
|---|---|---|---|
days | number | Number of days to include in stats | 30 |
slug | string | Filter results to a specific article by slug | - |
| Property | Type | Description | Default |
|---|---|---|---|
period* | { days: number, startDate: string, endDate: string } | - | - |
funnel.pageViews* | number | Total page views in period | - |
funnel.reached25* | number | Count of visitors who scrolled 25% | - |
funnel.reached50* | number | Count of visitors who scrolled 50% | - |
funnel.reached75* | number | Count of visitors who scrolled 75% | - |
funnel.reached90* | number | Count of visitors who scrolled 90% | - |
funnel.percentages* | { reached25, reached50, reached75, reached90 } | Percentage values | - |
engagement.avgTimeOnPage* | number | Average time on page in seconds | - |
engagement.avgScrollDepth* | number | Average scroll depth (0-100) | - |
engagement.bounceRate* | number | Bounce rate percentage | - |
engagement.engagementRate* | number | Engagement rate percentage | - |
cURL Command
curl -X GET "https://api.simplist.blog/v1/analytics/funnel?days=7" \
-H "X-API-Key: YOUR_API_KEY"cURL Command
curl -X GET "https://api.simplist.blog/v1/analytics/funnel?days=30&slug=getting-started" \
-H "X-API-Key: YOUR_API_KEY"{
"period": {
"days": 7,
"startDate": "2025-12-12T00:00:00.000Z",
"endDate": "2025-12-19T12:00:00.000Z"
},
"funnel": {
"pageViews": 1250,
"reached25": 987,
"reached50": 654,
"reached75": 432,
"reached90": 321,
"percentages": {
"reached25": 79,
"reached50": 52,
"reached75": 35,
"reached90": 26
}
},
"engagement": {
"avgTimeOnPage": 145,
"avgScrollDepth": 58,
"bounceRate": 23,
"engagementRate": 77
}
}The funnel shows progressive engagement:
| Milestone | Meaning |
|---|---|
| 25% | Visitor started reading past the intro |
| 50% | Visitor is engaged with the content |
| 75% | Visitor read most of the article |
| 90% | Visitor reached the conclusion |
Healthy funnel benchmarks:
- 25%: 60-80% of visitors
- 50%: 40-60% of visitors
- 75%: 25-40% of visitors
- 90%: 15-30% of visitors
Low percentages may indicate:
- Content is too long
- Poor intro hook
- Missing visuals or formatting
- Content doesn't match expectations
- Content optimization: Identify where readers drop off
- A/B testing: Compare funnel performance between articles
- Editorial decisions: Prioritize improving low-performing content
- Reader insights: Understand engagement patterns
If you're using TypeScript/JavaScript, use the SDK instead: client.analytics.getFunnel()