Search item database | Wynncraft

curl -X POST https://api.wynncraft.com/v3/item/search \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "controller": {
    "count": 3,
    "current_count": 1,
    "pages": 3,
    "prev": 1,
    "current": 2,
    "next": 3
  },
  "results": [
    {
      "displayName": "Idol",
      "internalName": "Idol",
      "type": "weapon",
      "subType": "spear",
      "icon": {
        "value": {
          "id": "minecraft:potion",
          "name": "spear.water3",
          "customModelData": {
            "rangeDispatch": [
              3024
            ]
          }
        },
        "format": "attribute"
      },
      "emblem": "diamond_5",
      "tier": "mythic",
      "attackSpeed": "normal",
      "averageDps": 533,
      "restriction": "none",
      "dropRestriction": "normal",
      "elements": [
        "water"
      ],
      "requirements": {
        "level": 95,
        "classRequirement": "warrior",
        "intelligence": 120
      },
      "majorIds": {
        "Tidal Drift": "<span class='font-ascii' style='color:#AAAAAA'>Flying Kick will instead send you forwards. This effect is limited to once per Charge cast.</span>"
      },
      "powderSlots": 3,
      "lore": "<span class='font-ascii' style='color:#AAAAAA'>Intricate carvings and images, almost like that of a totem pole, cover the shaft of this marvelous trident, dredged up from the Seavale Reef. Foreign magics heighten the senses of its user in battle, but also instills a longing for the ocean. Many have succumbed to this urge and drowned themselves.</span>",
      "identifications": {
        "manaRegen": {
          "min": 3,
          "raw": 10,
          "max": 13
        },
        "reflection": {
          "min": 9,
          "raw": 30,
          "max": 39
        },
        "waterDefence": {
          "min": 5,
          "raw": 15,
          "max": 20
        },
        "rawIntelligence": 26,
        "rawSpellDamage": {
          "min": 79,
          "raw": 264,
          "max": 343
        },
        "raw2ndSpellCost": {
          "min": -15,
          "raw": -50,
          "max": -65
        }
      },
      "base": {
        "baseWaterDamage": {
          "min": 220,
          "raw": 220,
          "max": 300
        }
      }
    }
  ]
}

This endpoint is cached for 1 hour in the SHARED cache source. See Caching.

This endpoint belongs to the ITEMS rate-limit bucket. See Throttling and Rate Limits.

Filters can be empty and do not always need to be present in the payload. To understand the endpoint better, try the official Wynncraft item guide while monitoring the network tab in your browser devtools.

fullResult bypasses pagination and returns the results object for all objects at once.

This endpoint uses the generic pagination response format.

<Note> This endpoint is cached for <Badge intent="error" minimal>1 hour</Badge> in the <Badge intent="success" minimal>SHARED</Badge> cache source. See [Caching](/welcome#caching). <Indent></Indent> This endpoint belongs to the <Badge intent="warning" minimal>ITEMS</Badge> rate-limit bucket. See [Throttling and Rate Limits](/welcome#throttling-and-rate-limits). </Note> Filters can be empty and do not always need to be present in the payload. To understand the endpoint better, try the official Wynncraft item guide while monitoring the network tab in your browser devtools. <Info> `fullResult` bypasses pagination and returns the `results` object for all objects at once. </Info> This endpoint uses the generic pagination response format.

Query parameters

pageintegerOptional>=1

fullResultenumOptional

Presence-based flag that expands responses. Send it without a value as ?fullResult. Using ?fullResult=true or ?fullResult=false is not accepted.

Allowed values:

Request

This endpoint expects an object.

querystring or nullOptional

typeenum or list of enumsOptional

tierenum or list of enumsOptional

attackSpeedenum or list of enumsOptional

levelRangeinteger or list of integersOptional

professionsenum or list of enumsOptional

identificationsenum or list of enumsOptional

majorIdsenum or list of enumsOptional

Response

Paginated search results.

controllerobject

resultslist of objects

Errors

400

Bad Request Error

404

Not Found Error

Enum values in these docs are based on the item metadata available on April 23, 2026. New item content can add or change values over time.