Pular para o conteúdo principal

Obter Informações do Bot

Este endpoint retorna todas as informações públicas e detalhadas de um bot específico cadastrado no BotGate.

Endpoint

GET/api/v1/bots/:botIdNão

URL Completa: https://botgate-api-987684559046.us-central1.run.app/api/v1/bots/:botId

Pública

Este endpoint não requer chave de API (Bearer Token), pois retorna apenas informações públicas que já estão disponíveis no site.

Parâmetros de URL

ParâmetroTipoDescrição
botIdStringO ID do bot no Discord.

Resposta de Sucesso (Completa)

{
"success": true,
"data": {
"id": "1234567890123456789",
"name": "BotTeste",
"avatar": "cd14054607269a5862eade995a0d8ba3",
"discriminator": "8563",
"shortDescription": "Uma breve descrição do meu bot!",
"longDescription": "Descrição detalhadamente do meu bot, com todas as funcionalidades dele e como ele funciona na prática, dentro do Discord!",
"tagline": "Uma breve descrição do meu bot!",
"prefix": "/",
"inviteUrl": "https://discord.com/oauth2/authorize?client_id=1234567890123456789&scope=bot&permissions=8",
"supportServer": "https://www.discord.gg/botteste",
"website": "https://bot-teste-.com/",
"github": "https://github.com/dono-teste/bot-teste",
"social": {
"twitter": "https://www.x.com/botteste",
"instagram": "https://www.instagram.com/bot_teste",
"youtube": "https://www.youtube.com/@botteste"
},
"verified": false,
"premium": false,
"certified": false,
"status": "approved",
"stats": {
"servers": 4,
"users": "273",
"shards": 1,
"rating": 0,
"reviews": 0,
"lastStatsUpdate": "2026-01-24T04:17:06.000Z"
},
"owner": {
"id": "1234567890123456789",
"username": "donoteste",
"avatar": "a_52d7e9c6b5ab20c6f729f51362f571bb",
"discriminator": "0"
},
"categories": [ ... ],
"features": [ ... ],
"languages": [ ... ],
"tags": [ ... ],
"commands": [ ... ],
"createdAt": "2026-01-24T03:13:57.000Z",
"updatedAt": "2026-01-24T07:19:25.000Z",
"approvedAt": "2026-01-24T03:22:49.000Z",
"lastBump": null
}
}

Casos de Uso

  1. Páginas de Status: Mostrar as estatísticas reais do seu bot no seu próprio site.
  2. Dashboards Externos: Integrar informações do BotGate em ferramentas de terceiros.
  3. Validação: Verificar se o bot já foi aprovado e quais badges ele possui na plataforma.
Pacote NPM

Você pode obter essas informações programaticamente através do método reporter.getBotInfo().