API Reference

Build anything on SuperNetwork.

Programmatic access to listing data, vote records, and image hosting. Perfect for vote-reward bots, server plugins, and custom dashboards.


API Reference

v1 - Stable


SuperNetwork API

The SuperNetwork public API gives you programmatic access to listing data, vote records, and more — perfect for vote-reward bots, server plugins, dashboards, or any integration that needs live data from the directory.

Base URL

http

https://api.supernetwork.dev/api/v1

Versioning

The current API version is v1. All endpoints are prefixed with /api/v1/. If breaking changes are ever introduced, a new version prefix will be used and the old version will remain available with advance notice.

All responses are JSON. Always send an Accept: application/json header and be prepared to handle new optional fields being added to responses in a non-breaking way.

Quick start

bash

# 1. Get your API key at https://dashboard.supernetwork.dev/account/settings

# 2. Make your first request
curl https://api.supernetwork.dev/api/v1/servers \
  -H "Authorization: Bearer sn_your_key_here"

# 3. Check vote status
curl "https://api.supernetwork.dev/api/v1/votes?userId=clx...&serverId=clx..." \
  -H "Authorization: Bearer sn_your_key_here"