API reference

List stats

The stat names /items?stat= takes, each as a percentage or a flat amount (the same name can be both), with how many items have it, the most common first.

Authorization

AuthorizationOptional

Works without a key. Send one to use its own limit: Authorization: Bearer iwk_… or X-API-Key: iwk_…. See Authentication.

Counted: 60 calls a minute per address without a key.

Response

200 OK: The stats, and how many.

The example answer is beside it, from the catalogue as it is now.

Errors

401bad_keyAn API key was sent that is unknown or revoked. Leave it out to use the free limit.
429rate_limitedMore calls in a minute than the limit (60 per address without a key, or the key's own). Wait for Retry-After seconds.
503unavailableThe catalogue could not be loaded. Rare; try again in a minute.

Notes

Then ask for the items

/items?stat=Crit Damage&sort=stat gives every item with Crit Damage, the highest roll first.

GEThttps://isleswiki.net/api/v1/stats

curl "https://isleswiki.net/api/v1/stats"

200OKapplication/json

{
  "version": "v3877",
  "count": 79,
  "data": [
    {
      "stat": "Base Defense",
      "percent": false,
      "items": 110
    },
    {
      "stat": "Crit Damage",
      "percent": true,
      "items": 52
    },
    {
      "stat": "Crit Chance",
      "percent": true,
      "items": 48
    },
    {
      "stat": "Max Health",
      "percent": false,
      "items": 47
    },
    "… 75 more"
  ]
}

Authorization#

Response#

Errors#

Notes#

Authorization

Response

Errors

Notes