Resource

Item Groups

Groups of items that are the same material in different rarities, such as Hilichurl Materials or Agnidus Agate. Each group lists its items, the enemies that drop them and, for domain materials, the domain and level that rewards them.

122items
4filters
2sort fields

Endpoints

GET/api/v1/item-groupsPaginated list
GET/api/v1/item-groups/randomRandom item
GET/api/v1/item-groups/{id or name}Single item

List

Returns a paginated list of item groups in summary form.

Query parameters

ParameterDescription
limitItems per page (1-100, default 20)
offsetItems to skip (default 0)
sortOne of id, name. Prefix with - for descending.
namePartial match on the name
typeItem type slug. Comma-separated values allowed.
sourcegeneral-enemy-drops | elite-enemy-drops | normal-boss-drops | weekly-boss-drops | boss-drops | domains-of-mastery | domains-of-forgery | gathering. Comma-separated values allowed.
domainDomain slug. Comma-separated values allowed.
GET /api/v1/item-groups?limit=2
{
  "count": 122,
  "next": "https://cdn.genshin-api.com/api/v1/item-groups?limit=2&offset=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "slug": "slime-materials",
      "name": "Slime Materials",
      "url": "https://cdn.genshin-api.com/api/v1/item-groups/slime-materials",
      "type": {
        "id": 1,
        "slug": "character-and-weapon-enhancement-materials",
        "name": "Character and Weapon Enhancement Materials",
        "url": "https://cdn.genshin-api.com/api/v1/item-types/character-and-weapon-enhancement-materials"
      },
      "source": "general-enemy-drops",
      "icon": null
    },
    {
      "id": 2,
      "slug": "hilichurl-materials",
      "name": "Hilichurl Materials",
      "url": "https://cdn.genshin-api.com/api/v1/item-groups/hilichurl-materials",
      "type": {
        "id": 1,
        "slug": "character-and-weapon-enhancement-materials",
        "name": "Character and Weapon Enhancement Materials",
        "url": "https://cdn.genshin-api.com/api/v1/item-types/character-and-weapon-enhancement-materials"
      },
      "source": "general-enemy-drops",
      "icon": null
    }
  ]
}

Single item

Returns the full details of one item, by numeric id or by name. Arrays in the example below are shortened.

Fields

FieldType
idnumber
slugstring
namestring
urlstring
typeReference
sourcestring
domainReference | null
domainLevelstring | null
imagesobject
itemsReference[]
droppedByReference[]
GET /api/v1/item-groups/hilichurl-materials
{
  "id": 2,
  "slug": "hilichurl-materials",
  "name": "Hilichurl Materials",
  "url": "https://cdn.genshin-api.com/api/v1/item-groups/hilichurl-materials",
  "type": {
    "id": 1,
    "slug": "character-and-weapon-enhancement-materials",
    "name": "Character and Weapon Enhancement Materials",
    "url": "https://cdn.genshin-api.com/api/v1/item-types/character-and-weapon-enhancement-materials"
  },
  "source": "general-enemy-drops",
  "domain": null,
  "domainLevel": null,
  "images": {},
  "items": [
    {
      "id": 4,
      "slug": "damaged-mask",
      "name": "Damaged Mask",
      "url": "https://cdn.genshin-api.com/api/v1/items/damaged-mask"
    },
    {
      "id": 5,
      "slug": "stained-mask",
      "name": "Stained Mask",
      "url": "https://cdn.genshin-api.com/api/v1/items/stained-mask"
    }
  ],
  "droppedBy": [
    {
      "id": 16,
      "slug": "anemo-samachurl",
      "name": "Anemo Samachurl",
      "url": "https://cdn.genshin-api.com/api/v1/enemies/anemo-samachurl"
    },
    {
      "id": 17,
      "slug": "cryo-hilichurl-shooter",
      "name": "Cryo Hilichurl Shooter",
      "url": "https://cdn.genshin-api.com/api/v1/enemies/cryo-hilichurl-shooter"
    }
  ]
}

Random

Returns one random item with the same shape as the single item endpoint. Accepts name and every list filter.

Try it

GETcdn.genshin-api.com