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