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/v1Response 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
- 1Create a key
Open Dashboard → Developer and press Create key. Tick Write access only if you need to change data or upload images.
- 2Store it safely
Put it in an environment variable such as
INJURING_KEY. Never commit it or ship it in client-side code. - 3Make a request
Send it in the
Authorizationheader.
Example request
curl "https://injuri.ng/api/v1/users/september" \
-H "Authorization: Bearer $INJURING_KEY"Endpoints
| Method | Path | Purpose |
|---|---|---|
| GET | /users/{handle} | Public profile |
| GET | /users/{handle}/links | Links |
| GET | /users/{handle}/badges | Badges |
| GET | /users/{handle}/widgets | Widgets |
| GET | /users/{handle}/comments | Comments (paged) |
| GET | /users/{handle}/stats | View analytics |
| GET | /uid/{uid} | Lookup by UID |
| GET | /search | Search profiles |
| GET | /check/{username} | Username availability |
| GET | /leaderboard | Rankings |
| GET | /badges | Badge catalog |
| GET | /stats | Site totals |
| GET | /users/{handle}/posts | Social posts |
| GET | /users/{handle}/followers | Followers |
| GET | /users/{handle}/following | Following |
| GET | /me | Your account |
| PATCH | /me/profile | Edit your profile |
| GET | /me/key | This key's details |
| GET | /me/analytics | Your analytics |
| GET | /me/notifications | Your notifications |
| GET | /me/links | Your links |
| POST | /me/links | Add a link |
| PATCH | /me/links/{id} | Edit a link |
| DELETE | /me/links/{id} | Remove a link |
| POST | /me/posts | Post to Social |
| DELETE | /me/posts/{id} | Delete a post |
still stuck? try troubleshooting or open a ticket in our discord, we reply fast.
