Guilds

Get server list

Host: api.3rdeye.top Path: /api/v1/server Method: GET

Example Response

Content-Type: application/json

[
  {
    "lastUpdate": "2025-09-08T20:30:18.500Z",
    "id": "01234567890123456",
    "name": "A public server",
    "icon": "https://cdn.discordapp.com/icons/...",
    "ownerID": "01234567890123456",
    "members": 100
  }
]

Types (TypeScript)

type ServerList = {
  id: string;
  name: string;
  icon: string;
  ownerID: string;
  members: number;
}[];

Get server infomation by id

Host: api.3rdeye.top Path: /api/v1/server/:id Method: GET

Example Response

Content-Type: application/json

{
  "lastUpdate": "2025-09-08T20:30:18.500Z",
  "serverID": "01234567890123456",
  "serverName": "A public server",
  "memberCount": 100,
  "ownerID": "01234567890123456",
  "icon": "https://cdn.discordapp.com/icons/...",
  "history": [
    {
      "at": "2025-09-09T23:30:18.535Z",
      "eventType": "ServerNameUpdate",
      "serverName": "A big server"
    },
    {
      "at": "2025-09-09T23:30:18.535Z",
      "eventType": "ServerIconUpdate",
      "icon": "string",
      "comment": "Icon changed suddenly"
    },
    {
      "at": "2025-09-09T23:30:18.535Z",
      "eventType": "OwnerChange",
      "ownerID": "01234567890123456"
    },
    {
      "at": "2025-09-09T23:30:18.535Z",
      "eventType": "MemberCount",
      "memberCount": 120
    }
  ]
}

Types (TypeScript)

type EventT =
  | "FirstSeen"
  | "OwnerChange"
  | "MemberCount"
  | "ServerNameUpdate"
  | "ServerIconUpdate";

type ServerInfo = {
  lastUpdate: Date;
  serverID: string;
  serverName: string;
  memberCount: number;
  ownerID: string;
  icon: string;
  history: {
    at: Date;
    eventType: EventT;
    serverName?: string;
    memberCount?: number;
    ownerID?: string;
    icon?: string;
    comment?: string;
  }[];
};