The base URL of all endpoints is https://api.snaz.in/v2/.

The example JSON responses are not coming from the instance itself and may not have the same data.

All requests automatically allow any origin, so you can use these endpoints in any website.


See Badge Documentation here

GitHub

GET/github/used-by/:user/:repo

Get package information on a GitHub repository.


  // https://api.snaz.in/v2/github/used-by/webpack/webpack

  {
    "ok": true,
    "repo": "webpack/webpack",
    "repos": [
      {
        "forks": {
          "estimate": "0",
          "formatted": "0",
          "value": 0
        },
        "icon": "https://avatars2.githubusercontent.com/u/39944116?s=40&u=6e6f3c43f4538652959320a55dae688653fed220&v=4",
        "repo": "curiousim/player-js",
        "stars": {
          "estimate": "0",
          "formatted": "0",
          "value": 0
        }
      },
      ...
    ],
    "used_by": {
      "estimate": "4.9m",
      "formatted": "4,883,480",
      "value": 4883480
    },
    "used_by_packages": {
      "estimate": "162.4k",
      "formatted": "162,384",
      "value": 162384
    }
  }
        
404: Repo not found

  {
    "error": "Repo not found",
    "ok": false
  }
            

Steam

GET/steam/user-profile/:steamid

Get metadata from a Steam user's profile.

Key Type Description
flag string? The flag of the user's location, can be null
location string? The user's location, can be null
avatar_border_url string? The profile's avatar border, can be null if there is no border
background_url string? The profile's background image, can be null if there is no background
animated_background_url string? The profile's animated background URL, can be null if the background is not animated
badge object? The profile's favorite badge, can be null
badge.meta string? The meta text of the badge, can be null if it is a Steam badge
primary_group object? The user's primary group, can be null
counts object All keys in counts can be null. These keys are: awards, badges, games, groups, reviews, friends, screenshots, workshop_files, guides, artwork, videos
recent_activity object? Recent activity, can be null
recent_activity.games[].achievement_progress object? The achievement progress in said game, can be null if the game does not have achievements
recent_activity.games[].last_played string Either a date (like "Mar 26") or "in-game"
bans.vac and bans.game "none", "one" or "multiple" The amount of bans the user has
bans.days_since_last number? The amount of days since last ban
status.state string Available states: offline, online, in-game
status.game string? The name of the game the user is playing if they are in-game
status.server_ip string? The IP of the server they are playing if their game is joinable

Sidenote: If you want to get the previous aliases of a user, use these endpoints:

200: Public profile

  // https://api.snaz.in/v2/steam/user-profile/76561198063017988

  {
    "animated_background_url": null,
    "avatar": "https://cdn.cloudflare.steamstatic.com/steamcommunity/public/images/items/1263950/ebc5939416c91ebfdcd609339b8326d6fbfb42ca.gif",
    "avatar_border_url": "https://cdn.cloudflare.steamstatic.com/steamcommunity/public/images/items/1263950/77a5bfca9dcc44e2e3aaaabea62249407f9f4ec0.png",
    "background_url": "https://cdn.cloudflare.steamstatic.com/steamcommunity/public/images/items/547960/2e9e83427e6ecffe7bba5b0b07903d6f804d60c3.jpg",
    "badge": {
      "image": "https://steamcdn-a.akamaihd.net/steamcommunity/public/images/items/420530/ec53d0960b014438a73976a1768cabf964f07de6.png",
      "meta": "Level 1 OneShot Badge",
      "name": "Ad Infinitum",
      "url": "https://steamcommunity.com/id/Snazzah/gamecards/420530",
      "xp": {
        "estimate": "100",
        "formatted": "100",
        "value": 100
      }
    },
    "bans": {
      "community": false,
      "days_since_last": null,
      "game": "none",
      "trade": false,
      "vac": "none"
    },
    "can_comment": true,
    "counts": {
      "games": {
        "estimate": "121",
        "formatted": "121",
        "value": 121
      },
      ...
    },
    "created": 1335968164,
    "custom_url": "Snazzah",
    "flag": "us",
    "level": {
      "estimate": "43",
      "formatted": "43",
      "value": 43
    },
    "location": "United States",
    "primary_group": {
      "member_count": {
        "estimate": "18",
        "formatted": "18",
        "value": 18
      },
      "name": "SadLords",
      "url": "https://steamcommunity.com/groups/sadlords"
    },
    "private": false,
    "real_name": "",
    "recent_activity": {
      "games": [
        {
          "achievement_progress": {
            "completed": {
              "estimate": "26",
              "formatted": "26",
              "value": 26
            },
            "total": {
              "estimate": "77",
              "formatted": "77",
              "value": 77
            }
          },
          "banner_image": "https://steamcdn-a.akamaihd.net/steamcommunity/public/images/apps/271590/e447e82f8b0c67f9e001498503c62f2a187bc609.jpg",
          "hours": {
            "estimate": "342",
            "formatted": "342",
            "value": 342
          },
          "last_played": "Mar 23",
          "name": "Grand Theft Auto V",
          "url": "https://steamcommunity.com/app/271590"
        },
        ...
      ],
      "playtime": {
        "estimate": "125.8",
        "formatted": "125.8",
        "value": 125.8
      }
    },
    "status": {
      "state": "online"
    },
    "steamid": {
      "2": "STEAM_0:0:51376130",
      "3": "[U:1:102752260]",
      "32": 102752260,
      "64": "76561198063017988"
    },
    "summary": {
      "raw": "<!-- unparsed HTML here -->",
      "text": "Where the wild ones are.\n https://snazzah.com \n  Steam Item Donation Link \n https://github.com/Snazzah"
    },
    "username": "Snazzah"
  }
            
200: Private profile

  {
    "avatar": "https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/xx/xxx_full.jpg",
    "ok": true,
    "private": true,
    "steamid": {
      "2": "STEAM_0:0:51376130",
      "3": "[U:1:102752260]",
      "32": 102752260,
      "64": "76561198063017988"
    },
    "bans": {
      "community": false,
      "days_since_last": null,
      "game": "none",
      "trade": false,
      "vac": "none"
    },
    "username": "Private Person"
  }
            
200: Profile with bans

  {
    ...
    "bans": {
      "community": false,
      "days_since_last": {
        "estimate": "54",
        "formatted": "54",
        "value": 54
      },
      "game": "none",
      "trade": false,
      "vac": "multiple"
    },
    ...
    "username": "Banned Account"
  }
            
200: Profile with In-Game status

  {
    ...
    "status": {
      "game": "Garry's Mod",
      "server_ip": "127.0.0.1:27015",
      "state": "in-game"
    },
    ...
    "username": "In-Game Account"
  }
            
404: Profile not found

  {
    "error": "Profile not found",
    "ok": false
  }
            

NameMC

GET/namemc/profile/:uuid-or-name

Note: This endpoint no longer works and will soon be removed.

Get metadata from a NameMC user's profile.

Key Type Description
custom_font string? The header font that was set by the user, can be null
emoji object? The header emoji that was set by the user, can be null
location object? The location that was set by the user, can be null
rank string? The NameMC rank of the user, can be null. Available ranks: "Emerald", "Moderator", "Manager", "Owner"
optifine_cape object? The user's OptiFine cape, can be null
username_history[].timestamp string? The timestamp that the user set the username at, can be null if that name was the accounts original username
friends[].emoji object? The friend's emoji, can be undefined
friends[].rank string? The friend's rank, can be undefined

Sidenote: NameMC provides lower detail API endpoints:

200: Success (SnazzahGuy)

  // https://api.snaz.in/v2/namemc/profile/ccdd2f6efd96445f98bb7c971bf639a2

  {
    "accounts": [
      {
        "content": "Snazzah#0371",
        "icon": "https://static.namemc.com/i/service/discord.svg",
        "title": "Discord"
      },
      {
        "icon": "https://static.namemc.com/i/service/github.svg",
        "title": "GitHub",
        "url": "https://github.com/Snazzah"
      },
      ...
    ],
    "capes": [],
    "claimed": true,
    "commands": {
      "1.12-": "/give @p minecraft:skull 1 3 {SkullOwner:\"SnazzahGuy\"}",
      "1.13+": "/give @s minecraft:player_head{SkullOwner:\"SnazzahGuy\"}"
    },
    "custom_font": null,
    "emoji": null,
    "favorite_servers": [],
    "friends": [],
    "location": {
      "emoji": "πŸ‡ΊπŸ‡Έ",
      "emoji_svg": "https://static.namemc.com/i/emoji/twitter/1f1fa-1f1f8.svg",
      "name": "United States"
    },
    "ok": true,
    "optifine_cape": null,
    "rank": null,
    "skins": [
      {
        "hash": "5e3036b42ea66af7",
        "icon": "https://render.namemc.com/skin/2d/face.png?skin=5e3036b42ea66af7&overlay&scale=2",
        "raw": "https://texture.namemc.com/5e/30/5e3036b42ea66af7.png"
      },
      ...
    ],
    "url": "https://mine.ly/SnazzahGuy.1",
    "username": "SnazzahGuy",
    "username_history": [
      {
        "order": "3",
        "timestamp": "2019-04-01T05:14:53.000Z",
        "username": "SnazzahGuy"
      },
      {
        "order": "2",
        "timestamp": "2015-12-23T02:42:35.000Z",
        "username": "SnazzahMC"
      },
      {
        "order": "1",
        "timestamp": null,
        "username": "SnazzyPine25"
      }
    ],
    "uuid": {
      "clean": "ccdd2f6efd96445f98bb7c971bf639a2",
      "dashed": "ccdd2f6e-fd96-445f-98bb-7c971bf639a2"
    },
    "views_per_month": {
      "estimate": "1",
      "formatted": "1",
      "value": 1
    }
  }
            
200: Success (CoderTim)

  // https://api.snaz.in/v2/namemc/profile/403e6cb7a6ca440a80417fb1e579b5a5

  {
    "accounts": [
      {
        "icon": "https://static.namemc.com/i/service/twitch.svg",
        "title": "Twitch",
        "url": "https://twitch.tv/CoderTim"
      },
      {
        "icon": "https://static.namemc.com/i/service/twitter.svg",
        "title": "Twitter",
        "url": "https://twitter.com/CoderTimZ"
      }
    ],
    "capes": [
      {
        "hash": "ebc798c3f7eca2a3",
        "name": "MineCon 2012",
        "raw": "https://texture.namemc.com/eb/c7/ebc798c3f7eca2a3.png",
        "url": "https://namemc.com/cape/ebc798c3f7eca2a3"
      }
    ],
    "claimed": true,
    "commands": {
      "1.12-": "/give @p minecraft:skull 1 3 {SkullOwner:\"CoderTim\"}",
      "1.13+": "/give @s minecraft:player_head{SkullOwner:\"CoderTim\"}"
    },
    "custom_font": "Merienda",
    "emoji": {
      "raw": "πŸ‘‘",
      "svg": "https://static.namemc.com/i/emoji/twitter/1f451.svg"
    },
    "favorite_servers": [
      {
        "domain": "blockmania.com",
        "icon": "https://texture.namemc.com/5c/2e/5c2e24059ba5e364.png",
        "name": "BlockMania",
        "url": "https://namemc.com/server/blockmania.com"
      }
    ],
    "friends": [
      {
        "emoji": {
          "raw": "🌌",
          "svg": "https://static.namemc.com/i/emoji/twitter/1f30c.svg"
        },
        "name": "000000000000000D",
        "rank": "Emerald",
        "url": "https://namemc.com/profile/000000000000000D.2"
      }
      ...
    ],
    "location": {
      "emoji": "πŸ‡ΊπŸ‡Έ",
      "emoji_svg": "https://static.namemc.com/i/emoji/twitter/1f1fa-1f1f8.svg",
      "name": "United States"
    },
    "ok": true,
    "optifine_cape": {
      "hash": "d6f9c483bf0457e7",
      "raw": "https://texture.namemc.com/d6/f9/d6f9c483bf0457e7.png"
    },
    "rank": "Owner",
    "skins": [
      {
        "hash": "410f42851119897e",
        "icon": "https://render.namemc.com/skin/2d/face.png?skin=410f42851119897e&overlay&scale=2",
        "raw": "https://texture.namemc.com/41/0f/410f42851119897e.png"
      },
      ...
    ],
    "url": "https://mine.ly/CoderTim.1",
    "username": "CoderTim",
    "username_history": [
      {
        "order": "1",
        "timestamp": null,
        "username": "CoderTim"
      }
    ],
    "uuid": {
      "clean": "403e6cb7a6ca440a80417fb1e579b5a5",
      "dashed": "403e6cb7-a6ca-440a-8041-7fb1e579b5a5"
    },
    "views_per_month": {
      "estimate": "13.7k",
      "formatted": "13,740",
      "value": 13740
    }
  }
            
404: User not found

  {
    "error": "User not found",
    "ok": false
  }
            

bots.gg

GET/bots-gg/widget/:bot-id

Create a widget from a bot in bots.gg.

Options Image
?style=1
?style=2

Legacy Endpoints

The base URL of all legacy endpoints is https://api.snaz.in/v1/ as well as their original endpoint URLs.

All requests automatically allow any origin, so you can use these endpoints in any website.

Line Sticker

GET/line-sticker/:id
Redirects to a cors-anywhere link to the PNG image of the sticker.
GET/line-sticker/:id/512.png
Since I won't bother resizing images on this service, this also redirects to the endpoint above.
GET/line-sticker/:id/redirect
Redirects to the link to the PNG image of the sticker without cors-anywhere.
GET/telegram
Lists all telegram sets loaded.

  // https://api.snaz.in/api/v1/telegram

  [
    {
      "count": 36,
      "created": 1502006429002,
      "files": [
        "794326550395748354.webp",
        ...
      ],
      "last_updated": 1502006429002,
      "name": "Zac_The_Pug",
      "official": true,
      "title": "Zac The Pug"
    },
    ...
  ]
        
GET/telegram/:id
Gives information on a loaded telegram set.

  // https://api.snaz.in/api/v1/telegram/Zac_The_Pug

  {
    "count": 36,
    "created": 1502006429002,
    "files": [
      "794326550395748354.webp",
      ...
    ],
    "last_updated": 1502006429002,
    "name": "Zac_The_Pug",
    "official": true,
    "title": "Zac The Pug"
  }
        
GET/telegram/:id/:file
Sends the WEBP file of a set's sticker.