YellowDiscordLookup

YellowDiscordLookup is a simple Node.js package that allows you to easily fetch Discord user, guild, and application information by their IDs.
No authentication or bot token is required.

Features

• Fetch Discord user info by user ID (tag, badges, avatar, banner, etc)
• Fetch Discord application (bot) info by application ID
• Fetch Discord guild (server) info by guild ID
• Promise-based, works with async/await

Installation

npm install yellowdiscordlookup

Example Usage

const { getUser, getApplication, getGuild } = require('yellowdiscordlookup');
(async () => {
  try {
    const user = await getUser('474286651896627210');
    console.log('User:', user);
  } catch (err) {
    console.error('Erreur getUser:', err);
  }

  try {
    const app = await getApplication('1326033704774275213');
    console.log('Application:', app);
  } catch (err) {
    console.error('Erreur getApplication:', err);
  }

  try {
    const guild = await getGuild('1369539576430854215');
    console.log('Guild:', guild);
  } catch (err) {
    console.error('Erreur getGuild:', err);
  }
})();

Example output:

User: {
  id: '474286651896627210',
  created_at: '2018-08-01T18:45:49.632Z',
  username: 'yellowonthebeat',
  avatar: { id: '3c7a363c496190c70fd4de77cc2755ca', link: 'https://cdn.discordapp.com/avatars/474286651896627210/3c7a363c496190c70fd4de77cc2755ca', is_animated: false },
  badges: ['HOUSE_BRAVERY', 'ACTIVE_DEVELOPER'],
  // ...
}
Application: {
  id: '1326033704774275213',
  name: 'toolkit by yellow',
  icon: 'https://cdn.discordapp.com/avatars/1326033704774275213/d2c7732f066ef5805a08b8993425e69d',
  description: 'toolkit',
  // ...
}
Guild: {
  id: '1369539576430854215',
  name: 'Yellow Eboy 💛 | Guildtag #RealEboyGuildTag',
  instant_invite: null,
  presence_count: 183
}

API

getUser(userId)

• userId (string): The Discord user's ID.
• Returns: Promise<Object> — user data.

getApplication(appId)

• appId (string): The Discord application/bot's ID.
• Returns: Promise<Object> — application data.

getGuild(guildId)

• guildId (string): The Discord guild/server's ID.
• Returns: Promise<Object> — guild data.

Returned Objects

Returned objects match Discord's data structure, for example:

User

{
  "id": "474286651896627210",
  "created_at": "2018-08-01T18:45:49.632Z",
  "username": "yellowonthebeat",
  "avatar": {
    "id": "3c7a363c496190c70fd4de77cc2755ca",
    "link": "https://cdn.discordapp.com/avatars/474286651896627210/3c7a363c496190c70fd4de77cc2755ca",
    "is_animated": false
  },
  "badges": ["HOUSE_BRAVERY", "ACTIVE_DEVELOPER"]
  // ...
}

Application

{
  "id": "1326033704774275213",
  "name": "toolkit by yellow",
  "icon": "https://cdn.discordapp.com/avatars/1326033704774275213/d2c7732f066ef5805a08b8993425e69d",
  "description": "toolkit"
  // ...
}

Guild

{
  "id": "1369539576430854215",
  "name": "Yellow Eboy 💛 | Guildtag #RealEboyGuildTag",
  "instant_invite": null,
  "presence_count": 183
}

Error Handling

If the provided ID is invalid or an error occurs, the function will throw an error.
Use try/catch to handle errors gracefully.

License

MIT