API reference
Search
Names that match: the exact name first, then names that start with the text, then the rest. Use it to find a key.
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.
Request
Query parameters
qstringRequired- The text to look for: at least 2 characters.
limitintegerOptionalDefault:20- How many to return, 1 to 100.
Response
200 OK: The matches, best first.
{
"version": "v790",
"count": 2,
"data": [
{
"type": "source",
"key": "info:boar level 1",
"name": "Boar",
"kind": "mob",
"url": "https://isleswiki.net/source/info%3Aboar%20level%201"
},
{
"type": "item",
"key": "model:isles:mob_drops/boar_fang",
"name": "Boar Fang",
"kind": "materials",
"url": "https://isleswiki.net/item/model%3Aisles%3Amob_drops%2Fboar_fang"
}
]
}Errors
- 400
bad_requestq is shorter than 2 characters, or limit is out of range. - 401
bad_keyAn API key was sent that is unknown or revoked. Leave it out to use the free limit. - 429
rate_limitedMore calls in a minute than the limit (60 per address without a key, or the key's own). Wait for Retry-After seconds. - 503
unavailableThe catalogue could not be loaded. Rare; try again in a minute.