Characters
Playable characters with their element, weapon, region, birthday, materials and constellations.
124items
11filters
4sort fields
Endpoints
GET
/api/v1/charactersPaginated listGET
/api/v1/characters/randomRandom itemGET
/api/v1/characters/{id or name}Single itemList
Returns a paginated list of characters 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, releaseDate. Prefix with - for descending. |
name | Partial match on the name |
rarity | Rarity stars (4-5) or rarity slug, e.g. 5 or 5-star. Comma-separated values allowed. |
element | Element slug. Comma-separated values allowed. |
weaponType | Weapon type slug. Comma-separated values allowed. |
region | Region slug. Comma-separated values allowed. |
gender | male | female. Comma-separated values allowed. |
bodyType | short | medium | tall. Comma-separated values allowed. |
releaseVersion | Release version, e.g. 4.2 or luna-i. Comma-separated values allowed. |
localSpecialty | Local specialty slug, e.g. silk-flower. Comma-separated values allowed. |
ascensionStat | Ascension stat slug, e.g. crit-dmg. Comma-separated values allowed. |
material | Item or item group slug used to ascend the character or level up talents, e.g. juvenile-jade or diligence-books. Comma-separated values allowed. |
{
"count": 124,
"next": "https://cdn.genshin-api.com/api/v1/characters?limit=2&offset=2",
"previous": null,
"results": [
{
"id": 1,
"slug": "aether",
"name": "Aether",
"url": "https://cdn.genshin-api.com/api/v1/characters/aether",
"rarity": {
"id": 5,
"slug": "5-star",
"name": "5-Star",
"url": "https://cdn.genshin-api.com/api/v1/rarities/5-star",
"icon": "https://cdn.genshin-api.com/rarities/5-star.webp"
},
"element": null,
"weaponType": {
"id": 1,
"slug": "sword",
"name": "Sword",
"url": "https://cdn.genshin-api.com/api/v1/weapon-types/sword",
"icon": "https://cdn.genshin-api.com/weapon-types/sword.webp"
},
"region": {
"id": 8,
"slug": "another-world",
"name": "Another World",
"url": "https://cdn.genshin-api.com/api/v1/regions/another-world",
"icon": "https://cdn.genshin-api.com/regions/another-world.webp"
},
"gender": "male",
"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",
"rarity": {
"id": 5,
"slug": "5-star",
"name": "5-Star",
"url": "https://cdn.genshin-api.com/api/v1/rarities/5-star",
"icon": "https://cdn.genshin-api.com/rarities/5-star.webp"
},
"element": null,
"weaponType": {
"id": 1,
"slug": "sword",
"name": "Sword",
"url": "https://cdn.genshin-api.com/api/v1/weapon-types/sword",
"icon": "https://cdn.genshin-api.com/weapon-types/sword.webp"
},
"region": {
"id": 8,
"slug": "another-world",
"name": "Another World",
"url": "https://cdn.genshin-api.com/api/v1/regions/another-world",
"icon": "https://cdn.genshin-api.com/regions/another-world.webp"
},
"gender": "female",
"icon": "https://cdn.genshin-api.com/characters/lumine/icon.webp"
}
]
}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 |
rarity | Reference |
element | Reference | null |
weaponType | Reference |
region | Reference | null |
gender | string |
bodyType | string |
birthday | string | null |
releaseDate | string |
releaseVersion | Reference |
ascensionStat | Reference |
materials | object |
constellations | Reference[] |
images | object |
{
"id": 31,
"slug": "hu-tao",
"name": "Hu Tao",
"url": "https://cdn.genshin-api.com/api/v1/characters/hu-tao",
"rarity": {
"id": 5,
"slug": "5-star",
"name": "5-Star",
"url": "https://cdn.genshin-api.com/api/v1/rarities/5-star",
"icon": "https://cdn.genshin-api.com/rarities/5-star.webp"
},
"element": {
"id": 6,
"slug": "pyro",
"name": "Pyro",
"url": "https://cdn.genshin-api.com/api/v1/elements/pyro",
"icon": "https://cdn.genshin-api.com/elements/pyro.svg"
},
"weaponType": {
"id": 3,
"slug": "polearm",
"name": "Polearm",
"url": "https://cdn.genshin-api.com/api/v1/weapon-types/polearm",
"icon": "https://cdn.genshin-api.com/weapon-types/polearm.webp"
},
"region": {
"id": 2,
"slug": "liyue",
"name": "Liyue",
"url": "https://cdn.genshin-api.com/api/v1/regions/liyue",
"icon": "https://cdn.genshin-api.com/regions/liyue.webp"
},
"gender": "female",
"bodyType": "medium",
"birthday": "07-15",
"releaseDate": "2021-03-02",
"releaseVersion": {
"id": 4,
"slug": "1-3",
"name": "1.3",
"url": "https://cdn.genshin-api.com/api/v1/versions/1-3"
},
"ascensionStat": {
"id": 7,
"slug": "crit-dmg",
"name": "CRIT DMG",
"url": "https://cdn.genshin-api.com/api/v1/stats/crit-dmg"
},
"materials": {
"boss": {
"id": 137,
"slug": "juvenile-jade",
"name": "Juvenile Jade",
"url": "https://cdn.genshin-api.com/api/v1/items/juvenile-jade"
},
"weeklyBoss": {
"id": 135,
"slug": "shard-of-a-foul-legacy",
"name": "Shard of a Foul Legacy",
"url": "https://cdn.genshin-api.com/api/v1/items/shard-of-a-foul-legacy"
},
"localSpecialty": {
"id": 125,
"slug": "silk-flower",
"name": "Silk Flower",
"url": "https://cdn.genshin-api.com/api/v1/items/silk-flower",
"icon": "https://cdn.genshin-api.com/local-specialties/silk-flower.webp"
},
"talent": [
{
"id": 88,
"slug": "teachings-of-diligence",
"name": "Teachings of Diligence",
"url": "https://cdn.genshin-api.com/api/v1/items/teachings-of-diligence"
},
{
"id": 89,
"slug": "guide-to-diligence",
"name": "Guide to Diligence",
"url": "https://cdn.genshin-api.com/api/v1/items/guide-to-diligence"
}
],
"common": [
{
"id": 19,
"slug": "whopperflower-nectar",
"name": "Whopperflower Nectar",
"url": "https://cdn.genshin-api.com/api/v1/items/whopperflower-nectar"
},
{
"id": 20,
"slug": "shimmering-nectar",
"name": "Shimmering Nectar",
"url": "https://cdn.genshin-api.com/api/v1/items/shimmering-nectar"
}
]
},
"constellations": [
{
"id": 33,
"slug": "papilio-charontis",
"name": "Papilio Charontis",
"url": "https://cdn.genshin-api.com/api/v1/constellations/papilio-charontis",
"meaning": "Butterfly of Charon",
"releaseVersion": {
"id": 4,
"slug": "1-3",
"name": "1.3",
"url": "https://cdn.genshin-api.com/api/v1/versions/1-3"
},
"image": "https://cdn.genshin-api.com/characters/hu-tao/constellations/papilio-charontis/image.webp",
"levels": [
{
"level": 1,
"name": "Crimson Bouquet",
"description": "While in a Paramita Papilio state activated by Guide to Afterlife, Hu Tao's Charged Attacks do not consume Stamina.",
"icon": "https://cdn.genshin-api.com/characters/hu-tao/constellations/papilio-charontis/c1.svg"
},
{
"level": 2,
"name": "Ominous Rainfall",
"description": "Increases the Blood Blossom DMG by an amount equal to 10% of Hu Tao's Max HP at the time the effect is applied. Additionally, Spirit Soother will also apply the Blood Blossom effect.",
"icon": "https://cdn.genshin-api.com/characters/hu-tao/constellations/papilio-charontis/c2.svg"
}
]
}
],
"images": {
"icon": "https://cdn.genshin-api.com/characters/hu-tao/icon.png",
"card": "https://cdn.genshin-api.com/characters/hu-tao/card.webp",
"inGame": "https://cdn.genshin-api.com/characters/hu-tao/in-game.webp",
"wish": "https://cdn.genshin-api.com/characters/hu-tao/wish.webp",
"multiWish": "https://cdn.genshin-api.com/characters/hu-tao/multi-wish.webp",
"partyIcon": "https://cdn.genshin-api.com/characters/hu-tao/party-icon.webp"
}
}Random
Returns one random item with the same shape as the single item endpoint. Accepts name and every list filter.