Player Search

This endpoint returns all the data we have for the player directly from the database, without any pre-applied formatting. This can be useful for easily finding the userId of usernames or Emoticon/Nameplate names.

To search for a Player, simply send an HTTP GET request to the URL below, where <username> is the intended player.

https://clarioncorp.net/api/search/<username>

Rate Limit: 250 players per hour (If you need more, let us know, we can make exceptions 🙂)

Currently, Player Lookup via playerId is unsupported, but we plan to support it in the future.

Optional Parameters

This endpoint supports parameters like Teams!

Simply add ?teams=true to the end of your URL to grab the team data for that player. Team Data in specific does not pull anything from Odyssey, so our rate limits are at 2000/hr. Go crazy. 💚

Example Output

An example of the output is listed below:

{
  "id": "6333a58673a37dc7cb11a7a7",
  "username": "blals",
  "emoticonId": "EmoticonData_Colin",
  "nameplateId": "NameplateData_EraC",
  "titleId": "TitleData_Abandoned",
  "playerStatus": "Offline",
  "ratings": [
    {
      "wins": 0,
      "losses": 0,
      "rank": 10001,
      "rating": 0,
      "games": 0,
      "masteryLevel": 164,
      "createdAt": "2025-01-14T20:37:33.519Z"
    },
    {
      "wins": 0,
      "losses": 0,
      "rank": 10001,
      "rating": 0,
      "games": 0,
      "masteryLevel": 0,
      "createdAt": "2025-01-14T00:26:33.800Z"
    },
    {
      "wins": 0,
      "losses": 0,
      "rank": 10001,
      "rating": 0,
      "games": 0,
      "masteryLevel": 164,
      "createdAt": "2025-01-13T22:51:45.339Z"
    },
    {
      "wins": 0,
      "losses": 0,
      "rank": 10001,
      "rating": 0,
      "games": 0,
      "masteryLevel": 0,
      "createdAt": "2025-01-13T19:48:24.286Z"
    }
  ],
  "tags": [
    "verified"
  ],
  "characterRatings": [
    {
      "character": "CD_ManipulatingMastermind",
      "assists": 0,
      "knockouts": 0,
      "wins": 0,
      "losses": 0,
      "mvp": 0,
      "role": "Goalie",
      "saves": 0,
      "scores": 0,
      "gamemode": "RankedInitial",
      "games": 0,
      "createdAt": "2025-01-13T17:05:13.854Z"
    },
    {
      "character": "CD_ChaoticRocketeer",
      "assists": 0,
      "knockouts": 0,
      "wins": 0,
      "losses": 0,
      "mvp": 0,
      "role": "Goalie",
      "saves": 0,
      "scores": 0,
      "gamemode": "RankedInitial",
      "games": 0,
      "createdAt": "2025-01-13T17:05:13.854Z"
    }
  ],
  "characterMastery": {
    "characterMasteries": [
      {
        "characterAssetName": "CD_AngelicSupport",
        "currentTier": 2,
        "currentTierXp": 5646,
        "totalXp": 10146,
        "xpToNextTier": 6000
      },
      {
        "characterAssetName": "CD_ChaoticRocketeer",
        "currentTier": 4,
        "currentTierXp": 3411,
        "totalXp": 23911,
        "xpToNextTier": 20000
      }
    ]
  },
  "mastery": {
    "currentLevel": 164,
    "currentLevelXp": 780,
    "totalXp": 3280780,
    "xpToNextLevel": 20000
  },
  "region": "Global",
  "createdAt": "2024-09-03T03:23:22.102Z",
  "updatedAt": "2025-01-14T20:37:33.523Z"
}