nekodbJoin the Discord

API reference

Everything is a plain GET on https://nekodb.space with no key. Images are SVG and never cached, so they are fresh on every view; JSON allows any origin.

Discord

The NekoDB bot watches members of the NekoDB Discord server. Join it once and your presence is available below. The JSON follows Lanyard's field names, so Lanyard clients work with a different base URL.

GET/api/v1/users/:id

Live presence: status per device, activities with image URLs, Spotify. 404 user_not_monitored if the account is not on the server.

{
  "success": true,
  "data": {
    "discord_user": {
      "id": "1162826529768755283",
      "username": "meow.devv",
      "global_name": "秒码农",
      "display_name": "MeowDev",
      "avatar_url": "https://cdn.discordapp.com/avatars/…png?size=256",
      "avatar_decoration_url": null,
      "banner_url": "https://cdn.discordapp.com/banners/…png?size=600",
      "public_flags": 64
    },
    "discord_status": "online",
    "active_on_discord_desktop": true,
    "active_on_discord_mobile": false,
    "active_on_discord_web": false,
    "listening_to_spotify": true,
    "spotify": {
      "track_id": "6kVQzgU4lJUMaXmxEHe5pk",
      "song": "…",
      "artist": "…",
      "album": "…",
      "album_art_url": "https://i.scdn.co/image/…",
      "timestamps": { "start": 1793000000000, "end": 1793000196000 }
    },
    "activities": [ … ]
  }
}

GET/card/:id.svg

Discord card: avatar, status, custom status, game or app, Spotify track.

GET/spotify/:id.svg

Spotify card: cover, track, artist, album and progress, or a quiet card when nothing plays.

ParameterValuesDefault
themedark, lightdark
hidecomma list of status, activity, spotify, decoration (card only)none
bghex colour without #GitHub canvas

GitHub languages

GET/github/:login/languages.svg

Bytes of code per language summed over the user's public repositories, forks left out. Refreshed every six hours. languages.json returns the numbers.

ParameterValuesDefault
themedark, lightdark
count1 to 16; the rest becomes Other8
excludecomma list of language namesnone
title0 hides the title1

View counters

GET/counter/:name.svg

Adds one view and draws the total. Names are 1 to 64 of A–Z a–z 0–9 . _ @ : -. Repeat views from one address within five seconds count once. Moe-Counter links work too: /@name?theme=…&padding=….

GET/counter/:name.json

The current value, without counting a view.

ParameterValuesDefault
themeany name from /api/v1/themesrule34
lengthminimum digits, 1 to 167
scale0.2 to 31
pixelated0 smooths the digits1
inc0 shows the value without countingcounts

GET/api/v1/themes

Theme names and digit sizes.

GET/api/v1/status

Whether the Discord gateway is connected and how many accounts are watched.