API publique

Affiche les serveurs de l'annuaire sur ton site ou dans ton bot. Crée ta clé dans Mon espace, onglet API.

Lecture seuleRecherche et fiches publiques
60 requêtes par minutePar clé
Une clé par développeurEn-tête Authorization: Bearer

GET/api/v1/servers

Recherche dans les serveurs publiés.

Paramètres
Paramètre	Rôle
q	Texte recherché
category	Identifiant de catégorie, par exemple gaming
tags	Tags séparés par des virgules
lang	Langue principale, par exemple fr
size	xs, s, m, l
premium	1 pour les serveurs Premium seulement
sort	relevance, bumped, members, rating, newest
page, perPage	Pagination, 50 résultats maximum par page

curl

curl -H "Authorization: Bearer ak_..." "https://listcord.me/api/v1/servers?q=minecraft&sort=members"

GET/api/v1/servers/{id}

Une fiche publique.

curl

curl -H "Authorization: Bearer ak_..." "https://listcord.me/api/v1/servers/42"

Réponse

{
  "id": 42, "guild_id": "1234567890", "name": "…", "slug": "…", "short_description": "…",
  "category": "gaming", "tags": ["minecraft"], "language": "fr", "member_count": 1200,
  "online_count": 310, "last_bump_at": "2026-11-05T10:00:00Z", "premium": false,
  "rating": 4.6, "review_count": 18
}

Widget

Pour le site d'un serveur listé. Le code prêt à copier est aussi dans Gérer, onglet Réglages.

HTML

<iframe src="https://listcord.me/widget/42?lang=fr&theme=dark" width="420" height="80" style="border:0"></iframe>
<img src="https://listcord.me/api/badge/42?lang=fr" alt="">

Erreurs

401: Clé absente ou invalide
404: Serveur introuvable
429: Limite atteinte : réessaie après le délai de l'en-tête Retry-After