> For the complete documentation index, see [llms.txt](https://docs.discordtop.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.discordtop.net/api-reference/api-v7/guild.md).

# Guild

Consultation des statistiques DiscordTop de la guilde associée au token développeur.

## Récupérer les statistiques DiscordTop de sa guilde

> Retourne les statistiques DiscordTop de la guilde associée au token développeur.\
> \
> \*\*Important :\*\*\
> \- Cette route est réservée aux serveurs Premium.\
> \- Le token doit être passé en Bearer ou via \`X-Api-Token\`.\
> \- La guilde doit être active sur DiscordTop.\
> \- Les informations retournées sont uniquement des métriques DiscordTop.<br>

```json
{"openapi":"3.0.3","info":{"title":"DiscordTop Developer API - Version 7","version":"7.0"},"tags":[{"name":"Guild","description":"Consultation des statistiques DiscordTop de la guilde associée au token développeur."}],"servers":[{"url":"https://api.discordtop.net/v7","description":"API Developer - Production (v7)"}],"security":[{"ApiTokenAuth":[]}],"components":{"securitySchemes":{"ApiTokenAuth":{"type":"http","scheme":"bearer","bearerFormat":"DTOP-Dev-Token"}},"parameters":{"ApiTokenQuery":{"name":"api_token","in":"query","required":false,"description":"Ancienne méthode pour passer le token dans l'URL.\nIl est recommandé d'utiliser `Authorization: Bearer <token>`.\n","schema":{"type":"string"},"deprecated":true},"LocaleQuery":{"name":"locale","in":"query","required":false,"description":"Force la langue de la réponse (`fr`, `en`, etc.).\nSi absent : utilise `X-Locale`, puis `Accept-Language`, sinon fallback `en`.\n","schema":{"type":"string"}},"XLocaleHeader":{"name":"X-Locale","in":"header","required":false,"description":"Locale forcée, surpasse `Accept-Language`.","schema":{"type":"string"}},"AcceptLanguageHeader":{"name":"Accept-Language","in":"header","required":false,"description":"Détection automatique de la langue.","schema":{"type":"string"}},"XApiTokenHeader":{"name":"X-Api-Token","in":"header","required":false,"description":"Token développeur alternatif.","schema":{"type":"string"}}},"schemas":{"GuildMeSuccess":{"type":"object","required":["ok","guild_id","votes","lifetime_votes","votes_last_7_days","rank","boosts","reviews","rating"],"properties":{"ok":{"type":"boolean"},"guild_id":{"type":"string"},"votes":{"type":"integer","description":"Nombre de votes de la guilde sur le classement mensuel en cours."},"lifetime_votes":{"type":"integer","description":"Nombre total de votes reçus par la guilde depuis son ajout sur DiscordTop."},"votes_last_7_days":{"type":"integer","description":"Nombre de votes reçus sur les 7 derniers jours."},"rank":{"type":"integer","nullable":true,"description":"Position actuelle de la guilde dans le classement mensuel."},"boosts":{"type":"integer","description":"Nombre de boosts actifs sur la guilde."},"reviews":{"type":"integer","description":"Nombre total d'avis publiés pour la guilde."},"rating":{"type":"number","format":"float","nullable":true,"description":"Note moyenne des avis publiés, arrondie à une décimale. Null si aucun avis n'est disponible."}}},"ErrorResponse":{"type":"object","required":["ok","error","message"],"properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"message":{"type":"string"}}},"RateLimitError":{"type":"object","properties":{"message":{"type":"string"}}},"ServerError":{"type":"object","properties":{"message":{"type":"string"}}}},"responses":{"UnauthorizedApiToken":{"description":"Erreurs liées au token développeur.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"PremiumRequired":{"description":"La guilde associée au token n'a pas accès à cette route.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"RateLimitExceeded":{"description":"Rate limit atteint.","headers":{"Retry-After":{"description":"Nombre de secondes à attendre avant de refaire une requête.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"InternalServerError":{"description":"Erreur interne de l'API.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServerError"}}}}}},"paths":{"/guild/me":{"get":{"tags":["Guild"],"operationId":"getMyGuildStats","summary":"Récupérer les statistiques DiscordTop de sa guilde","description":"Retourne les statistiques DiscordTop de la guilde associée au token développeur.\n\n**Important :**\n- Cette route est réservée aux serveurs Premium.\n- Le token doit être passé en Bearer ou via `X-Api-Token`.\n- La guilde doit être active sur DiscordTop.\n- Les informations retournées sont uniquement des métriques DiscordTop.\n","parameters":[{"$ref":"#/components/parameters/ApiTokenQuery"},{"$ref":"#/components/parameters/LocaleQuery"},{"$ref":"#/components/parameters/XLocaleHeader"},{"$ref":"#/components/parameters/AcceptLanguageHeader"},{"$ref":"#/components/parameters/XApiTokenHeader"}],"responses":{"200":{"description":"Statistiques DiscordTop de la guilde associée au token développeur.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuildMeSuccess"}}}},"401":{"$ref":"#/components/responses/UnauthorizedApiToken"},"403":{"$ref":"#/components/responses/PremiumRequired"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"500":{"$ref":"#/components/responses/InternalServerError"}}}}}}
```