Skip to main content

Analytics API

Get detailed analytics for your forms including views, completion rates, daily trends, device breakdowns, and top referrers.

Get Form Analytics

curl https://www.zevform.com/api/v1/forms/{formId}/analytics \
  -H "Authorization: Bearer zev_your_api_key"

Query Parameters

ParameterTypeDefaultDescription
daysnumber30Number of days to look back (max: 90)

Response

{
  "data": {
    "form": {
      "id": "form_abc123",
      "title": "Customer Feedback"
    },
    "overview": {
      "total_views": 1250,
      "total_starts": 890,
      "total_completions": 642,
      "total_responses": 642,
      "start_rate": 71,
      "completion_rate": 72,
      "avg_time_seconds": 95.4
    },
    "trends": [
      {
        "date": "2026-03-01",
        "views": 45,
        "starts": 32,
        "completions": 24,
        "responses": 24
      },
      {
        "date": "2026-03-02",
        "views": 52,
        "starts": 38,
        "completions": 28,
        "responses": 28
      }
    ],
    "devices": {
      "desktop": 720,
      "mobile": 480,
      "tablet": 50
    },
    "top_referrers": [
      { "url": "https://example.com", "count": 320 },
      { "url": "https://twitter.com", "count": 180 },
      { "url": "https://google.com", "count": 95 }
    ]
  }
}

Metrics Explained

MetricDescription
total_viewsNumber of times the form was opened
total_startsNumber of visitors who began filling the form
total_completionsNumber of visitors who completed the form
start_ratePercentage of viewers who started (starts / views)
completion_ratePercentage of starters who completed (completions / starts)
avg_time_secondsAverage time to complete the form in seconds
trendsDaily breakdown for the requested period
devicesCount of views by device type
top_referrersTop 10 referring URLs by view count