Users

Watch out!

Data provided from this route may be inaccurate!

This is because bots moved to a team will remain on a users account irrespective of ownership.

Fetch a users bots

See which bots are owned by which users.

Authorization

authorization<token>

In: header

Path Parameters

idRequiredstring

Response Body

Default Response

botsRequiredarray<object>

export interface Response {
  bots: {
    id: string;
    owners: string[];
    deleted: boolean;
    name: string;
    avatar: string;
    short_desc: string;
    lib: string;
    prefix: string;
    website: string;
    approved_at: string;
    monthly_votes: number;
    server_count: number;
    total_votes: number;
    monthly_votes_rank: number;
    server_count_rank: number;
    total_votes_rank: number;
    timestamp: string;
    unix_timestamp: string;
  }[];
}

curl -X GET "https://api.topstats.gg/discord/users/string/bots" \
  -H "authorization: <token>"

{
  "bots": [
    {
      "owners": [
        "205680187394752512"
      ],
      "deleted": false,
      "name": "Shiro",
      "avatar": "https://cdn.discordapp.com/avatars/1026525568344264724/cd70e62e41f691f1c05c8455d8c31e23.png",
      "short_desc": "Shiro provides modlogs, moderation, and music features that match the featuresets of popular bots such as Chip, Hydra, Rythm and Groovy!",
      "lib": "discord.js",
      "prefix": "s! (Customizable)",
      "website": "https://shirobot.org",
      "approved_at": "2018-09-22T11:25:10.962Z",
      "monthly_votes": 3,
      "server_count": 17762,
      "total_votes": 61387,
      "monthly_votes_rank": 7556,
      "server_count_rank": 501,
      "total_votes_rank": 282,
      "timestamp": "2024-10-28T18:00:00.000Z",
      "unix_timestamp": "1730138400000",
      "$id": "461521980492087297"
    },
    {
      "owners": [
        "321714991050784770",
        "205680187394752512",
        "116930717241311236"
      ],
      "deleted": false,
      "name": "DBL Statistics",
      "avatar": "https://cdn.discordapp.com/avatars/1026525568344264724/cd70e62e41f691f1c05c8455d8c31e23.png",
      "short_desc": "Get statistics of every bot listed on top.gg",
      "lib": "",
      "prefix": "dbl-",
      "website": "https://dblstatistics.com/",
      "approved_at": "2020-08-02T12:39:32.440Z",
      "monthly_votes": 4,
      "server_count": 80,
      "total_votes": 251,
      "monthly_votes_rank": 5846,
      "server_count_rank": 6296,
      "total_votes_rank": 4796,
      "timestamp": "2024-10-28T18:00:00.000Z",
      "unix_timestamp": "1730138400000",
      "$id": "583807014896140293"
    }
  ]
}