Resource

Characters

Playable characters with their element, weapon, region, birthday, materials and constellations.

124items
11filters
4sort fields

Endpoints

GET/api/v1/charactersPaginated list
GET/api/v1/characters/randomRandom item
GET/api/v1/characters/{id or name}Single item

List

Returns a paginated list of characters in summary form.

Query parameters

ParameterDescription
limitItems per page (1-100, default 20)
offsetItems to skip (default 0)
sortOne of id, name, rarity, releaseDate. Prefix with - for descending.
namePartial match on the name
rarityRarity stars (4-5) or rarity slug, e.g. 5 or 5-star. Comma-separated values allowed.
elementElement slug. Comma-separated values allowed.
weaponTypeWeapon type slug. Comma-separated values allowed.
regionRegion slug. Comma-separated values allowed.
gendermale | female. Comma-separated values allowed.
bodyTypeshort | medium | tall. Comma-separated values allowed.
releaseVersionRelease version, e.g. 4.2 or luna-i. Comma-separated values allowed.
localSpecialtyLocal specialty slug, e.g. silk-flower. Comma-separated values allowed.
ascensionStatAscension stat slug, e.g. crit-dmg. Comma-separated values allowed.
materialItem or item group slug used to ascend the character or level up talents, e.g. juvenile-jade or diligence-books. Comma-separated values allowed.
GET /api/v1/characters?limit=2
{
  "count": 124,
  "next": "https://genshin-api.replace_me.workers.dev/api/v1/characters?limit=2&offset=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "slug": "aether",
      "name": "Aether",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/characters/aether",
      "rarity": {
        "id": 5,
        "slug": "5-star",
        "name": "5-Star",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/rarities/5-star",
        "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/rarities/5-star.webp"
      },
      "element": null,
      "weaponType": {
        "id": 1,
        "slug": "sword",
        "name": "Sword",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/weapon-types/sword",
        "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/weapon-types/sword.webp"
      },
      "region": {
        "id": 8,
        "slug": "another-world",
        "name": "Another World",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/regions/another-world",
        "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/regions/another-world.webp"
      },
      "gender": "male",
      "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/characters/aether/icon.webp"
    },
    {
      "id": 2,
      "slug": "lumine",
      "name": "Lumine",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/characters/lumine",
      "rarity": {
        "id": 5,
        "slug": "5-star",
        "name": "5-Star",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/rarities/5-star",
        "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/rarities/5-star.webp"
      },
      "element": null,
      "weaponType": {
        "id": 1,
        "slug": "sword",
        "name": "Sword",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/weapon-types/sword",
        "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/weapon-types/sword.webp"
      },
      "region": {
        "id": 8,
        "slug": "another-world",
        "name": "Another World",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/regions/another-world",
        "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/regions/another-world.webp"
      },
      "gender": "female",
      "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/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

FieldType
idnumber
slugstring
namestring
urlstring
rarityReference
elementReference | null
weaponTypeReference
regionReference | null
genderstring
bodyTypestring
birthdaystring | null
releaseDatestring
releaseVersionReference
ascensionStatReference
materialsobject
constellationsReference[]
imagesobject
GET /api/v1/characters/hu-tao
{
  "id": 31,
  "slug": "hu-tao",
  "name": "Hu Tao",
  "url": "https://genshin-api.replace_me.workers.dev/api/v1/characters/hu-tao",
  "rarity": {
    "id": 5,
    "slug": "5-star",
    "name": "5-Star",
    "url": "https://genshin-api.replace_me.workers.dev/api/v1/rarities/5-star",
    "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/rarities/5-star.webp"
  },
  "element": {
    "id": 6,
    "slug": "pyro",
    "name": "Pyro",
    "url": "https://genshin-api.replace_me.workers.dev/api/v1/elements/pyro",
    "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/elements/pyro.svg"
  },
  "weaponType": {
    "id": 3,
    "slug": "polearm",
    "name": "Polearm",
    "url": "https://genshin-api.replace_me.workers.dev/api/v1/weapon-types/polearm",
    "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/weapon-types/polearm.webp"
  },
  "region": {
    "id": 2,
    "slug": "liyue",
    "name": "Liyue",
    "url": "https://genshin-api.replace_me.workers.dev/api/v1/regions/liyue",
    "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/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://genshin-api.replace_me.workers.dev/api/v1/versions/1-3"
  },
  "ascensionStat": {
    "id": 7,
    "slug": "crit-dmg",
    "name": "CRIT DMG",
    "url": "https://genshin-api.replace_me.workers.dev/api/v1/stats/crit-dmg"
  },
  "materials": {
    "boss": {
      "id": 137,
      "slug": "juvenile-jade",
      "name": "Juvenile Jade",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/items/juvenile-jade"
    },
    "weeklyBoss": {
      "id": 135,
      "slug": "shard-of-a-foul-legacy",
      "name": "Shard of a Foul Legacy",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/items/shard-of-a-foul-legacy"
    },
    "localSpecialty": {
      "id": 125,
      "slug": "silk-flower",
      "name": "Silk Flower",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/items/silk-flower",
      "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/local-specialties/silk-flower.webp"
    },
    "talent": [
      {
        "id": 88,
        "slug": "teachings-of-diligence",
        "name": "Teachings of Diligence",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/items/teachings-of-diligence"
      },
      {
        "id": 89,
        "slug": "guide-to-diligence",
        "name": "Guide to Diligence",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/items/guide-to-diligence"
      }
    ],
    "common": [
      {
        "id": 19,
        "slug": "whopperflower-nectar",
        "name": "Whopperflower Nectar",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/items/whopperflower-nectar"
      },
      {
        "id": 20,
        "slug": "shimmering-nectar",
        "name": "Shimmering Nectar",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/items/shimmering-nectar"
      }
    ]
  },
  "constellations": [
    {
      "id": 33,
      "slug": "papilio-charontis",
      "name": "Papilio Charontis",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/constellations/papilio-charontis",
      "meaning": "Butterfly of Charon",
      "releaseVersion": {
        "id": 4,
        "slug": "1-3",
        "name": "1.3",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/versions/1-3"
      },
      "image": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/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://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/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://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/characters/hu-tao/constellations/papilio-charontis/c2.svg"
        }
      ]
    }
  ],
  "images": {
    "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/characters/hu-tao/icon.png",
    "card": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/characters/hu-tao/card.webp",
    "inGame": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/characters/hu-tao/in-game.webp",
    "wish": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/characters/hu-tao/wish.webp",
    "multiWish": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/characters/hu-tao/multi-wish.webp",
    "partyIcon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/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.

Try it

GETgenshin-api.REPLACE_ME.workers.dev