Entwickler · API v1

Integriere die TopV-Reputation
in deine Seite, Tebex, Discord.

Kostenlose öffentliche API. Einbettbare SVG-Badges. JSON mit offenem CORS. Kein Schlüssel, keine Anmeldung, kein rigoroses Rate-Limit.

SVG-Badges

Einbettbar via <img>. 8 Farbvarianten, Auto-Match mit deinem Site-Design.

JSON-API

Offenes CORS *. Kein Schlüssel erforderlich. CDN-Cache + stale-while-revalidate.

Stabil

Versionierte Endpunkte (/api/v1/*). Angemessenes Rate-Limit, 429 mit Retry-After bei Überschreitung.

Schnellstart

SVG-Badges

HTML

<a href="https://topv.gg/creators/quasar-store">
  <img src="https://topv.gg/api/v1/badge/quasar-store" alt="TopV" />
</a>

Vote-Widget 400×80 mit Button. Für Store-Homepage.

HTML

<a href="https://topv.gg/creators/quasar-store">
  <img src="https://topv.gg/api/v1/widget/quasar-store" alt="Vote on TopV" />
</a>

JSON-API

JavaScript

const res = await fetch("https://topv.gg/api/v1/creator/quasar-store");
const data = await res.json();
console.log(data.votes, data.rating, data.reviews);

Endpunkte

GET

/api/v1/badge/{slug}

SVG-Badge 160×32 (Creator). ?color= akzeptiert.

SVG

GET

/api/v1/badge/server/{slug}

SVG-Badge 160×32 (FiveM/RedM-Server).

SVG

GET

/api/v1/widget/{slug}

Vote-Widget 400×80 mit Button. Für Store-Homepage.

SVG

GET

/api/v1/widget/server/{slug}

Server-Vote-Widget.

SVG

GET

/api/v1/creator/{slug}

Vollständige Creator-Daten: Stimmen, Bewertung, Rezensionen, Tier, Links.

JSON

GET

/api/v1/server/{slug}

Vollständige Server-Daten.

JSON

GET

/api/v1/rankings?type=creators|servers&limit=10

Top N Rangliste nach Stimmen.

JSON

GET

/api/v1/search?q=query&type=creators|servers|all

Volltextsuche (mind. 2 Zeichen).

JSON

Badge- und Widget-Parameter

?color=

Erzwingt eine der 8 verfügbaren Varianten. Wenn fehlend, wird die Farbe automatisch an den Akzent des TopV-Profils angepasst.

orange

red

rose

coral

gold

violet

sky

mint

Rate-Limits

Badge / widget SVG

300 Anfragen/Min pro IP.

JSON creator / server / search

60 Anfragen/Min pro IP.

JSON rankings

30 Anfragen/Min pro IP (Join + Sort, aufwendiger).

Bei Überschreitung: Antwort 429 Too Many Requests · Retry-After: 60

Versionierung

Verwende /api/v1/* für langfristige Kompatibilität. Legacy-Endpunkte (/api/badge/*, /api/widget/*, /api/public/*) bleiben funktional, können sich aber weiterentwickeln. Bei Breaking Changes wird ein neues /api/v2 eingeführt — v1 bleibt unverändert.

Bist du TopV-Creator?

Der Code zum Kopieren für deine Seite ist bereits in deinem Dashboard vorgeneriert, mit deinem Slug vorgefüllt und den 8 Farbvarianten in Live-Vorschau.

Mein Widgets-Dashboard öffnen