NetStats API

Public JSON endpoints used by the Network pages (no auth), plus a token-protected API for external integrations.

Public endpoints (website)

Method Path Description
GET /network/data/status/ Network snapshot + top users/channels today + recent history
GET /network/data/channel/<channel>/ Channel profile payload (overview, hourly lines, top users today)
GET /network/data/user/<nick>/ User profile payload (overview + hourly activity)
GET /network/data/countries/ Country distribution (from NetStats CTCP/WHOIS when available)
GET /network/data/clients/ IRC client distribution (from NetStats CTCP VERSION when available)
GET /network/data/history/ Recent network history points
GET /network/netstats/api/index.json Machine-readable index of NetStats endpoints

Token-protected endpoints (external)

Method Path Description
GET /api/netstats/ NetStats API index (token)
GET /api/netstats/status/ Network snapshot + top users/channels today + recent history (token)
GET /api/netstats/channel/<channel>/ Channel profile payload (token)
GET /api/netstats/user/<nick>/ User profile payload (token)
GET /api/netstats/countries/ Country distribution (token)
GET /api/netstats/clients/ IRC client distribution (token)
GET /api/netstats/history/ Recent network history points (token)
GET /api/netstats/operators/ IRC operators (token)
GET /api/netstats/servers/ Linked servers (token)
Auth: Authorization: Token <your-token>

Quick examples

$ curl https://irc4fun.net/network/data/status/
$ curl https://irc4fun.net/network/data/channel/%23irc4fun/
$ curl https://irc4fun.net/network/data/user/reverse/
$ curl https://irc4fun.net/network/netstats/api/index.json

$ curl -H "Authorization: Token YOUR_TOKEN" https://irc4fun.net/api/netstats/status/
$ curl -H "Authorization: Token YOUR_TOKEN" https://irc4fun.net/api/netstats/channel/%23irc4fun/
$ curl -H "Authorization: Token YOUR_TOKEN" https://irc4fun.net/api/netstats/user/reverse/
$ curl -H "Authorization: Token YOUR_TOKEN" https://irc4fun.net/api/netstats/
Note: channels must be URL-encoded (e.g. #irc4fun → %23irc4fun).