Ontwikkelaars · API v1

Integreer TopV-reputatie
in je site, Tebex, Discord.

Gratis publieke API. Embed-bare SVG-badges. JSON met open CORS. Geen sleutel, geen aanmelding, geen straffende rate-limit.

SVG-badges

Embedbaar via <img>. 8 kleurvarianten, automatische match met het ontwerp van je site.

JSON API

Open CORS *. Geen sleutel vereist. CDN-cache + stale-while-revalidate.

Stabiel

Geversieerde endpoints (/api/v1/*). Redelijke rate-limit, 429 met Retry-After bij overschrijding.

Snelstart

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 met knop. Voor 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);

Endpoints

GET
/api/v1/badge/{slug}
SVG-badge 160×32 (creator). ?color= geaccepteerd.
SVG
GET
/api/v1/badge/server/{slug}
SVG-badge 160×32 (FiveM/RedM-server).
SVG
GET
/api/v1/widget/{slug}
Vote-widget 400×80 met knop. Voor store-homepage.
SVG
GET
/api/v1/widget/server/{slug}
Server-vote-widget.
SVG
GET
/api/v1/creator/{slug}
Volledige creator-data: stemmen, beoordeling, recensies, tier, links.
JSON
GET
/api/v1/server/{slug}
Volledige server-data.
JSON
GET
/api/v1/rankings?type=creators|servers&limit=10
Top N klassement op stemmen.
JSON
GET
/api/v1/search?q=query&type=creators|servers|all
Full-text zoeken (min. 2 tekens).
JSON

Badge- en widget-parameters

?color=

Forceer een van de 8 beschikbare varianten. Bij afwezigheid past de kleur automatisch bij het accent van het TopV-profiel.

orange
red
rose
coral
gold
violet
sky
mint

Snelheidslimieten

Badge / widget SVG
300 verzoeken/min per IP.
JSON creator / server / search
60 verzoeken/min per IP.
JSON rankings
30 verzoeken/min per IP (join + sort, zwaarder).

Bij overschrijding: antwoord 429 Too Many Requests · Retry-After: 60

Versiebeheer

Gebruik /api/v1/* voor langdurige compatibiliteit. Legacy-endpoints (/api/badge/*, /api/widget/*, /api/public/*) blijven functioneel maar kunnen evolueren. Bij breaking changes wordt een nieuwe /api/v2 geïntroduceerd — v1 blijft intact.

Ben je een TopV-creator?

De code om te kopiëren en plakken voor je site is al voorgegenereerd in je dashboard, met je slug vooraf ingevuld en de 8 kleurvarianten in live preview.

Mijn Widgets-dashboard openen