Read-only API
Offentlige profiler, live-status og katalogdata.
API-et er laget for små widgets, Discord-bots, dashboards og interne verktøy. Det returnerer kun offentlige profilfelt og kan brukes direkte fra nettleseren.
StatusOnline
FormatJSON
CORSEnabled
Endepunkter
Alle paths er relative til https://api.streamerspecs.no.
| Metode | Path | Beskrivelse |
|---|---|---|
| GET | /streamers | Lister offentlige streamerprofiler med paginering og filtre. |
| GET | /streamers/:slug | Henter én profil med specs, sosiale lenker, setup-media, reviews og stats. |
| GET | /live | Lister streamere som er live akkurat nå. |
| GET | /api | Returnerer maskinlesbar API-info som JSON. |
Eksempler
Kopier URL-en rett inn i curl, fetch eller en bot.
List streamers
curl https://api.streamerspecs.no/streamers?limit=10Detailed profiles
curl https://api.streamerspecs.no/streamers?detailed=true&limit=5One streamer
curl https://api.streamerspecs.no/streamers/arvenorskgamerLive now
curl https://api.streamerspecs.no/liveFiltere for /streamers
Bruk flere parametre sammen for smalere resultat.
| Parameter | Bruk |
|---|---|
q | Søk i navn, Twitch, bio, team, specs og sosiale felt. |
status | all, live eller offline. |
badge | all, featured, plus, partner eller verified. |
content | all, team, setup eller discord. |
game | Filtrer på aktiv Twitch-kategori når streamere er live. |
page | Side, starter på 1. |
limit | Antall resultater per side, maks 100. |
detailed | true gir specs, lenker, setup-media, reviews og stats i listen. |
Responsformat
Lister returnerer alltid data og meta.
{
"data": [
{
"slug": "arvenorskgamer",
"displayName": "ArveNorskGamer",
"twitchLogin": "arvenorskgamer",
"badges": { "plus": true, "partner": true },
"urls": { "profile": "https://streamerspecs.no/streamers/arvenorskgamer" },
"live": { "live": false, "gameName": "", "viewerCount": 0 }
}
],
"meta": { "total": 1, "page": 1, "pageSize": 10 }
}
Vanlige felter
slugbrukes i offentlige profil-URL-er.badgesviser Plus, partner og verifisering.liveinneholder Twitch-status når tilgjengelig.metagir paginering og totaler.