injuri.ng
API›Getting started›API overview
getting started

API overview

Build bots, widgets and integrations on injuri.ng.

The injuri.ng API is a JSON REST API. Every endpoint lives under one base URL, needs an API key, and returns the same response shape.

Base URL
https://injuri.ng/api/v1

Response format

Success responses wrap the result in data. Lists may add a meta object with paging info. Errors always use error.code (stable, machine-readable) and error.message (human-readable).

Success
{
  "data": {
    "username": "september"
  },
  "meta": {
    "next_cursor": null
  }
}
Error
{
  "error": {
    "code": "not_found",
    "message": "No public profile with that name."
  }
}

Quick start

  1. 1
    Create a key

    Open Dashboard → Developer and press Create key. Tick Write access only if you need to change data or upload images.

  2. 2
    Store it safely

    Put it in an environment variable such as INJURING_KEY. Never commit it or ship it in client-side code.

  3. 3
    Make a request

    Send it in the Authorization header.

Example request
curl "https://injuri.ng/api/v1/users/september" \
  -H "Authorization: Bearer $INJURING_KEY"

Endpoints

MethodPathPurpose
GET/users/{handle}Public profile
GET/users/{handle}/linksLinks
GET/users/{handle}/badgesBadges
GET/users/{handle}/widgetsWidgets
GET/users/{handle}/commentsComments (paged)
GET/users/{handle}/statsView analytics
GET/uid/{uid}Lookup by UID
GET/searchSearch profiles
GET/check/{username}Username availability
GET/leaderboardRankings
GET/badgesBadge catalog
GET/statsSite totals
GET/users/{handle}/postsSocial posts
GET/users/{handle}/followersFollowers
GET/users/{handle}/followingFollowing
GET/meYour account
PATCH/me/profileEdit your profile
GET/me/keyThis key's details
GET/me/analyticsYour analytics
GET/me/notificationsYour notifications
GET/me/linksYour links
POST/me/linksAdd a link
PATCH/me/links/{id}Edit a link
DELETE/me/links/{id}Remove a link
POST/me/postsPost to Social
DELETE/me/posts/{id}Delete a post

still stuck? try troubleshooting or open a ticket in our discord, we reply fast.