Resource

Items

Materials such as enemy drops, ascension gems, talent books, weapon ascension materials and local specialties, with their type, source, group, region, rarity, description, release version and farming days. Each item lists the enemies that drop it, the domains that reward it and the characters and weapons that use it.

509items
8filters
3sort fields

Endpoints

GET/api/v1/itemsPaginated list
GET/api/v1/items/randomRandom item
GET/api/v1/items/{id or name}Single item

List

Returns a paginated list of items in summary form.

Query parameters

ParameterDescription
limitItems per page (1-100, default 20)
offsetItems to skip (default 0)
sortOne of id, name, rarity. 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.
groupItem group slug, e.g. hilichurl-materials. Comma-separated values allowed.
regionRegion slug, for local specialties. Comma-separated values allowed.
rarityRarity stars (1-5) or rarity slug, e.g. 4 or 4-star. Comma-separated values allowed.
releaseVersionRelease version, e.g. 5.0 or luna-i. Comma-separated values allowed.
daysDay of the week the item can be farmed: monday | tuesday | wednesday | thursday | friday | saturday | sunday. Comma-separated values allowed.
GET /api/v1/items?limit=2
{
  "count": 509,
  "next": "https://cdn.genshin-api.com/api/v1/items?limit=2&offset=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "slug": "slime-condensate",
      "name": "Slime Condensate",
      "url": "https://cdn.genshin-api.com/api/v1/items/slime-condensate",
      "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",
      "rarity": {
        "id": 1,
        "slug": "1-star",
        "name": "1-Star",
        "url": "https://cdn.genshin-api.com/api/v1/rarities/1-star",
        "icon": "https://cdn.genshin-api.com/rarities/1-star.webp"
      },
      "icon": null
    },
    {
      "id": 2,
      "slug": "slime-secretions",
      "name": "Slime Secretions",
      "url": "https://cdn.genshin-api.com/api/v1/items/slime-secretions",
      "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",
      "rarity": {
        "id": 2,
        "slug": "2-star",
        "name": "2-Star",
        "url": "https://cdn.genshin-api.com/api/v1/rarities/2-star",
        "icon": "https://cdn.genshin-api.com/rarities/2-star.webp"
      },
      "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
groupReference | null
regionReference | null
rarityReference | null
descriptionstring
releaseVersionReference
daysstring[]
imagesobject
droppedByReference[]
obtainedFromReference[]
usedByobject
GET /api/v1/items/damaged-mask
{
  "id": 4,
  "slug": "damaged-mask",
  "name": "Damaged Mask",
  "url": "https://cdn.genshin-api.com/api/v1/items/damaged-mask",
  "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",
  "group": {
    "id": 2,
    "slug": "hilichurl-materials",
    "name": "Hilichurl Materials",
    "url": "https://cdn.genshin-api.com/api/v1/item-groups/hilichurl-materials"
  },
  "region": null,
  "rarity": {
    "id": 1,
    "slug": "1-star",
    "name": "1-Star",
    "url": "https://cdn.genshin-api.com/api/v1/rarities/1-star",
    "icon": "https://cdn.genshin-api.com/rarities/1-star.webp"
  },
  "description": "A broken bone mask that once belonged to some hilichurl.\nNow more broken than complete, it can no longer perform its primary function.",
  "releaseVersion": {
    "id": 1,
    "slug": "1-0",
    "name": "1.0",
    "url": "https://cdn.genshin-api.com/api/v1/versions/1-0"
  },
  "days": [],
  "images": {},
  "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"
    }
  ],
  "obtainedFrom": [],
  "usedBy": {
    "characters": [
      {
        "id": 1,
        "slug": "aether",
        "name": "Aether",
        "url": "https://cdn.genshin-api.com/api/v1/characters/aether",
        "icon": "https://cdn.genshin-api.com/characters/aether/icon.webp"
      },
      {
        "id": 2,
        "slug": "lumine",
        "name": "Lumine",
        "url": "https://cdn.genshin-api.com/api/v1/characters/lumine",
        "icon": "https://cdn.genshin-api.com/characters/lumine/icon.webp"
      }
    ],
    "weapons": [
      {
        "id": 4,
        "slug": "apprentices-notes",
        "name": "Apprentice's Notes",
        "url": "https://cdn.genshin-api.com/api/v1/weapons/apprentices-notes",
        "icon": "https://cdn.genshin-api.com/weapons/apprentices-note/icon.webp"
      },
      {
        "id": 9,
        "slug": "pocket-grimoire",
        "name": "Pocket Grimoire",
        "url": "https://cdn.genshin-api.com/api/v1/weapons/pocket-grimoire",
        "icon": "https://cdn.genshin-api.com/weapons/pocket-grimoire/icon.webp"
      }
    ]
  }
}

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