Public URL Statistics
Get public click statistics for a single short link.
Resolves both URL generations (plus emoji aliases) on the system default domain and returns link facts plus the standard stats wire.
Authentication: Optional — an owner session additionally sees private-stats links and skips the password gate.
Privacy: A link with private stats answers exactly like a missing
code (404, byte-identical). Password-protected links answer 401
password_required; send the password via POST — never in the URL.
Rate Limits:
- Authenticated: 60/min, 2,000/day
- Anonymous: 20/min, 500/day
Authorizations
API key authentication. Pass your key as: Bearer spoo_<your_key>
Path Parameters
Query Parameters
Range start (ISO 8601). Defaults to 7 days before end_date.
50"2025-01-01T00:00:00Z"
Range end (ISO 8601). Defaults to now.
50"2025-12-31T23:59:59Z"
IANA timezone for time bucketing and formatting.
50"UTC"
"America/New_York"
Response
Successful Response
Response body for GET|POST /api/v1/public/stats/{short_code}.
v1, v2 Public facts about the link shown above the charts.
The modern stats wire shape (same as GET /api/v1/stats): summary, metrics keyed '{metric}by{dimension}', time_range, time_bucket_info, computed_metrics. v1 links carry a 'clicks_by_bots' dimension and no 'city'/'device'; v2 the reverse.

