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 listGET
/api/v1/items/randomRandom itemGET
/api/v1/items/{id or name}Single itemList
Returns a paginated list of items in summary form.
Query parameters
| Parameter | Description |
|---|---|
limit | Items per page (1-100, default 20) |
offset | Items to skip (default 0) |
sort | One of id, name, rarity. Prefix with - for descending. |
name | Partial match on the name |
type | Item type slug. Comma-separated values allowed. |
source | general-enemy-drops | elite-enemy-drops | normal-boss-drops | weekly-boss-drops | boss-drops | domains-of-mastery | domains-of-forgery | gathering. Comma-separated values allowed. |
group | Item group slug, e.g. hilichurl-materials. Comma-separated values allowed. |
region | Region slug, for local specialties. Comma-separated values allowed. |
rarity | Rarity stars (1-5) or rarity slug, e.g. 4 or 4-star. Comma-separated values allowed. |
releaseVersion | Release version, e.g. 5.0 or luna-i. Comma-separated values allowed. |
days | Day of the week the item can be farmed: monday | tuesday | wednesday | thursday | friday | saturday | sunday. Comma-separated values allowed. |
{
"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
| Field | Type |
|---|---|
id | number |
slug | string |
name | string |
url | string |
type | Reference |
source | string |
group | Reference | null |
region | Reference | null |
rarity | Reference | null |
description | string |
releaseVersion | Reference |
days | string[] |
images | object |
droppedBy | Reference[] |
obtainedFrom | Reference[] |
usedBy | object |
{
"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.