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.
| Parameter | Values | Default |
|---|---|---|
theme | dark, light | dark |
hide | comma list of status, activity, spotify, decoration (card only) | none |
bg | hex 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.
| Parameter | Values | Default |
|---|---|---|
theme | dark, light | dark |
count | 1 to 16; the rest becomes Other | 8 |
exclude | comma list of language names | none |
title | 0 hides the title | 1 |
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.
| Parameter | Values | Default |
|---|---|---|
theme | any name from /api/v1/themes | rule34 |
length | minimum digits, 1 to 16 | 7 |
scale | 0.2 to 3 | 1 |
pixelated | 0 smooths the digits | 1 |
inc | 0 shows the value without counting | counts |
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.