Desarrolladores · API v1

Integra la reputación TopV
en tu sitio, Tebex, Discord.

API pública gratuita. Badges SVG embebibles. JSON con CORS abierto. Sin clave, sin registro, sin rate-limit punitivo.

Badges SVG

Embebibles vía <img>. 8 variantes de color, auto-match con el diseño de tu sitio.

API JSON

CORS * abierto. No se requiere clave. Caché CDN + stale-while-revalidate.

Estable

Endpoints versionados (/api/v1/*). Rate-limit razonable, 429 con Retry-After si se excede.

Inicio rápido

Badges SVG

HTML

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

Widget de voto 400×80 con botón. Para homepage de store.

HTML

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

API JSON

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}

Badge SVG 160×32 (creador). ?color= aceptado.

SVG

GET

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

Badge SVG 160×32 (servidor FiveM/RedM).

SVG

GET

/api/v1/widget/{slug}

Widget de voto 400×80 con botón. Para homepage de store.

SVG

GET

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

Widget de voto para servidor.

SVG

GET

/api/v1/creator/{slug}

Datos completos del creador: votos, calificación, reseñas, tier, enlaces.

JSON

GET

/api/v1/server/{slug}

Datos completos del servidor.

JSON

GET

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

Top N clasificación por votos.

JSON

GET

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

Búsqueda de texto completo (mín. 2 caracteres).

JSON

Parámetros de badge y widget

?color=

Fuerza una de las 8 variantes disponibles. Si está ausente, el color auto-match con el accent del perfil TopV.

orange

red

rose

coral

gold

violet

sky

mint

Límites de tasa

Badge / widget SVG

300 req/min por IP.

JSON creator / server / search

60 req/min por IP.

JSON rankings

30 req/min por IP (join + sort, más costoso).

Al exceder: respuesta 429 Too Many Requests · Retry-After: 60

Versionado

Usa /api/v1/* para compatibilidad a largo plazo. Los endpoints legacy (/api/badge/*, /api/widget/*, /api/public/*) siguen funcionando pero pueden evolucionar. En caso de breaking change, se introducirá un nuevo /api/v2 — v1 permanecerá intacto.

¿Eres creador de TopV?

El código para copiar y pegar en tu sitio ya está pre-generado en tu dashboard, con tu slug pre-rellenado y las 8 variantes de color en vista previa en vivo.

Abrir mi dashboard de Widgets