API Documentation

Integrate blosm's powerful Discord username checking and sniping capabilities into your own applications.

Authentication

All API requests require an API key. You can get your API key from your blosm dashboard.

Authorization Header:

Authorization: Bearer YOUR_API_KEY

Check Username Availability

Endpoint

POST

https://api.blosm.lol/v1/check

Request Body

{
  "username": "example",
  "platform": "discord"
}

Response

{
  "username": "example",
  "available": true,
  "platform": "discord",
  "status": "available"
}

Bulk Check Usernames

Endpoint

POST

https://api.blosm.lol/v1/check/bulk

Request Body

{
  "usernames": ["user1", "user2", "user3"],
  "platform": "discord"
}

Error Handling

The API uses standard HTTP status codes to indicate success or failure.

  • 200 OK: Success
  • 400 Bad Request: Invalid parameters
  • 401 Unauthorized: Missing or invalid API key
  • 429 Too Many Requests: Rate limit exceeded
  • 500 Internal Server Error: Server issue

Get Your API Key

Log in to your blosm dashboard to access your API key

Go to Dashboard