StreamerSpecsPublic API

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.

MetodePathBeskrivelse
GET/streamersLister offentlige streamerprofiler med paginering og filtre.
GET/streamers/:slugHenter én profil med specs, sosiale lenker, setup-media, reviews og stats.
GET/liveLister streamere som er live akkurat nå.
GET/apiReturnerer 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=10
Detailed profiles
curl https://api.streamerspecs.no/streamers?detailed=true&limit=5
One streamer
curl https://api.streamerspecs.no/streamers/arvenorskgamer
Live now
curl https://api.streamerspecs.no/live

Filtere for /streamers

Bruk flere parametre sammen for smalere resultat.

ParameterBruk
qSøk i navn, Twitch, bio, team, specs og sosiale felt.
statusall, live eller offline.
badgeall, featured, plus, partner eller verified.
contentall, team, setup eller discord.
gameFiltrer på aktiv Twitch-kategori når streamere er live.
pageSide, starter på 1.
limitAntall resultater per side, maks 100.
detailedtrue 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

  • slug brukes i offentlige profil-URL-er.
  • badges viser Plus, partner og verifisering.
  • live inneholder Twitch-status når tilgjengelig.
  • meta gir paginering og totaler.