Developer Access

Coryn Club API

Use the Coryn Club API to look up items, monsters, and maps in JSON. It is read-only and only exposes public site data.

Available Endpoints

Endpoint	Use
`/api/v1/items.php`	Read item data, item stats, and public item metadata.
`/api/v1/monsters.php`	Read monster data, map names, and public monster metadata.
`/api/v1/maps.php`	Read map data and basic map counts.

Rules

Read-only only. No account, admin, or write actions are exposed here.
JSON responses only.
Default result limit is 20 and max limit is 100.
Use exact id lookups when possible for the lightest requests.
This is version v1, so later changes can ship without breaking old consumers.

Example Requests

GET /api/v1/items.php?id=8416
GET /api/v1/items.php?name=myco
GET /api/v1/items.php?type=6&limit=20

GET /api/v1/monsters.php?id=3348
GET /api/v1/monsters.php?name=mycodian
GET /api/v1/monsters.php?map_id=653

GET /api/v1/maps.php?id=653
GET /api/v1/maps.php?name=grazen

Response Shape

{
  "success": true,
  "data": [],
  "meta": {
    "version": "v1",
    "total": 1,
    "limit": 20,
    "offset": 0
  }
}

Single-record lookups by id return one object. Search requests return an array.

Field Notes

Item responses include public stats and badge/note metadata when available.
Monster responses include type, mode, map name, and public badge/note metadata.
Map responses stay lightweight by default.

Suggested First Use

https://coryn.club/api/v1/items.php?id=8416
https://coryn.club/api/v1/monsters.php?id=3348
https://coryn.club/api/v1/maps.php?id=653