Skip to main content
GET
https://app.usehardal.com
/
api
/
websites
/
{websiteId}
/
metrics
Metrics API
curl --request GET \
  --url https://app.usehardal.com/api/websites/{websiteId}/metrics \
  --header 'Authorization: Bearer <token>'
{
  "timeseries": [
    {
      "date": "2024-01-15T10:00:00Z",
      "pageviews": 125,
      "visitors": 89,
      "sessions": 92,
      "bounce_rate": 45.2,
      "avg_duration": 180.5
    },
    {
      "date": "2024-01-15T11:00:00Z",
      "pageviews": 143,
      "visitors": 95,
      "sessions": 98,
      "bounce_rate": 42.1,
      "avg_duration": 195.3
    }
  ],
  "countries": [
    {
      "country": "Turkey",
      "visitors": 450,
      "percentage": 50.6
    },
    {
      "country": "United States",
      "visitors": 280,
      "percentage": 31.5
    }
  ],
  "browsers": [
    {
      "browser": "Chrome",
      "visitors": 520,
      "percentage": 58.4
    },
    {
      "browser": "Safari",
      "visitors": 200,
      "percentage": 22.5
    }
  ],
  "os": [
    {
      "os": "Windows",
      "visitors": 400,
      "percentage": 45.0
    },
    {
      "os": "macOS",
      "visitors": 250,
      "percentage": 28.1
    }
  ],
  "devices": [
    {
      "device": "Desktop",
      "visitors": 500,
      "percentage": 56.2
    },
    {
      "device": "Mobile",
      "visitors": 350,
      "percentage": 39.3
    }
  ],
  "pages": [
    {
      "path": "/",
      "title": "Home Page",
      "pageviews": 850,
      "visitors": 420,
      "percentage": 34.0
    },
    {
      "path": "/products",
      "title": "Products",
      "pageviews": 520,
      "visitors": 280,
      "percentage": 20.8
    }
  ],
  "referrers": [
    {
      "referrer": "google.com",
      "visitors": 320,
      "percentage": 36.0
    },
    {
      "referrer": "twitter.com",
      "visitors": 150,
      "percentage": 16.9
    }
  ],
  "totals": {
    "pageviews": 2500,
    "visitors": 890,
    "sessions": 920,
    "bounce_rate": 45.2,
    "avg_duration": 180.5,
    "events": 5230
  }
}
Get comprehensive analytics data including time series charts, visitor breakdowns, and aggregated totals. Perfect for building dashboards and analyzing website performance across multiple dimensions.
​
websiteId
string
required
Your website signal ID
​
timeframe
string
default:"today"
Time period: today, yesterday, last7days, last30days, custom
​
interval
string
default:"hourly"
Data granularity: minute, hourly, daily, weekly, monthly
​
targetSignalId
string
default:"websiteId"
Target signal ID for analytics data (use inherited signal ID if different from websiteId, otherwise same as websiteId)
​
timezone
string
default:"UTC"
Timezone for date calculations (e.g., Asia/Istanbul, America/New_York)
​
isHybrid
boolean
default:"false"
Whether this is a hybrid/self-hosted signal
​
startDate
string
Start date for custom timeframe (ISO format)
​
endDate
string
End date for custom timeframe (ISO format)
{
  "timeseries": [
    {
      "date": "2024-01-15T10:00:00Z",
      "pageviews": 125,
      "visitors": 89,
      "sessions": 92,
      "bounce_rate": 45.2,
      "avg_duration": 180.5
    },
    {
      "date": "2024-01-15T11:00:00Z",
      "pageviews": 143,
      "visitors": 95,
      "sessions": 98,
      "bounce_rate": 42.1,
      "avg_duration": 195.3
    }
  ],
  "countries": [
    {
      "country": "Turkey",
      "visitors": 450,
      "percentage": 50.6
    },
    {
      "country": "United States",
      "visitors": 280,
      "percentage": 31.5
    }
  ],
  "browsers": [
    {
      "browser": "Chrome",
      "visitors": 520,
      "percentage": 58.4
    },
    {
      "browser": "Safari",
      "visitors": 200,
      "percentage": 22.5
    }
  ],
  "os": [
    {
      "os": "Windows",
      "visitors": 400,
      "percentage": 45.0
    },
    {
      "os": "macOS",
      "visitors": 250,
      "percentage": 28.1
    }
  ],
  "devices": [
    {
      "device": "Desktop",
      "visitors": 500,
      "percentage": 56.2
    },
    {
      "device": "Mobile",
      "visitors": 350,
      "percentage": 39.3
    }
  ],
  "pages": [
    {
      "path": "/",
      "title": "Home Page",
      "pageviews": 850,
      "visitors": 420,
      "percentage": 34.0
    },
    {
      "path": "/products",
      "title": "Products",
      "pageviews": 520,
      "visitors": 280,
      "percentage": 20.8
    }
  ],
  "referrers": [
    {
      "referrer": "google.com",
      "visitors": 320,
      "percentage": 36.0
    },
    {
      "referrer": "twitter.com",
      "visitors": 150,
      "percentage": 16.9
    }
  ],
  "totals": {
    "pageviews": 2500,
    "visitors": 890,
    "sessions": 920,
    "bounce_rate": 45.2,
    "avg_duration": 180.5,
    "events": 5230
  }
}