Analytics

All analytics endpoints require analytics:read permission on your API key.

Per-link stats

Get click count and basic stats for a specific link:

curl https://qck.sh/public-api/v1/links/{id}/stats \
  -H "X-API-Key: qck_your_api_key_here"

Summary

Aggregate stats across all your links:

curl https://qck.sh/public-api/v1/analytics/summary \
  -H "X-API-Key: qck_your_api_key_here"

Timeseries

Daily click data. Use days for relative ranges or start_date/end_date (YYYY-MM-DD) for absolute dates:

curl "https://qck.sh/public-api/v1/analytics/timeseries?days=30" \
  -H "X-API-Key: qck_your_api_key_here"

Geography

Clicks grouped by country:

curl "https://qck.sh/public-api/v1/analytics/geo?days=30" \
  -H "X-API-Key: qck_your_api_key_here"

Devices

Clicks by device type, browser, and OS:

curl "https://qck.sh/public-api/v1/analytics/devices?days=30" \
  -H "X-API-Key: qck_your_api_key_here"

Referrers

Where your clicks come from:

curl "https://qck.sh/public-api/v1/analytics/referrers?days=30" \
  -H "X-API-Key: qck_your_api_key_here"

Hourly patterns

Click distribution by hour of day (0–23), useful for timing campaigns:

curl "https://qck.sh/public-api/v1/analytics/hourly?days=30" \
  -H "X-API-Key: qck_your_api_key_here"

Volume limits

Tracked clicks per month by tier: Free (5,000), Basic (150,000), Growth (1,000,000), Pro (2,000,000), Business (10,000,000), Scale (25,000,000).

When you exceed your monthly allowance, query windows are clamped to the most recent data within the allowance — the cutoff_date field in the usage object of every analytics response shows the clamp point.

Data retention

How far back you can query depends on your tier:

Tier	Retention
Free	6 months
Basic ($19/mo)	1 year
Growth ($49/mo)	3 years
Pro ($99/mo) and above	Unlimited