Read-only REST API

The archives of Teyvat,
one request away

A free API with 2,267 entries of Genshin Impact data: characters, weapons, elements, regions and more. JSON in, adventure out.

GET https://genshin-api-develop.REPLACE_ME.workers.dev/api/v1/characters?name=hu-tao
{
  "id": 31,
  "slug": "hu-tao",
  "name": "Hu Tao",
  "url": "https://genshin-api-develop.replace_me.workers.dev/api/v1/characters/hu-tao",
  "rarity": {
    "id": 5,
    "slug": "5-star",
    "name": "5-Star",
    "url": "https://genshin-api-develop.replace_me.workers.dev/api/v1/rarities/5-star",
    "icon": "https://cdn.genshin-api.com/rarities/5-star.webp"
  },
  "element": {
    "id": 6,
    "slug": "pyro",
    "name": "Pyro",
    "url": "https://genshin-api-develop.replace_me.workers.dev/api/v1/elements/pyro",
    "icon": "https://cdn.genshin-api.com/elements/pyro.svg"
  },
  "weaponType": {
    "id": 3,
    "slug": "polearm",
    "name": "Polearm",
    "url": "https://genshin-api-develop.replace_me.workers.dev/api/v1/weapon-types/polearm",
    "icon": "https://cdn.genshin-api.com/weapon-types/polearm.webp"
  },
  "region": {
    "id": 2,
    "slug": "liyue",
    "name": "Liyue",
    "url": "https://genshin-api-develop.replace_me.workers.dev/api/v1/regions/liyue",
    "icon": "https://cdn.genshin-api.com/regions/liyue.webp"
  },
  "gender": "female",
  "icon": "https://cdn.genshin-api.com/characters/hu-tao/icon.png"
}
Why this API

Built for travelers

Free & Open

No sign-up: generate a free API key in the docs and start querying.

Filter Everything

Combine filters like element, rarity or region on every list endpoint.

Random Draws

Every resource has a /random endpoint that respects your filters.

Id or Name

Look up any item by its numeric id or its name, in any casing.

Resources

What lies within

Artifact Sets

64

Artifact sets with the rarities they drop in, their release version and their pieces.

/api/v1/artifact-sets

Artifact Types

5

The five artifact slots with their possible main stats and sub stats. Each type lists the artifact sets that have a piece for it.

/api/v1/artifact-types

Artifacts

301

Individual artifact pieces with their set, slot, description and lore. Rarities come from their set.

/api/v1/artifacts

Characters

124

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

/api/v1/characters

Constellations

136

Character constellations with their meaning, release version and six levels. Each constellation links to its character; travelers have one per element.

/api/v1/constellations

Domain Types

6

Domain types such as Domains of Blessing, Forgery or Mastery, Trounce Domains, One-Time Domains and Quest Domains. Each type lists its domains.

/api/v1/domain-types

Domains

192

Challenge, trounce, one-time and quest domains with their type, location, recommended elements, difficulty tiers, rewards, bosses and release version. Domains of Forgery and Mastery list the material each level gives and the days it is open.

/api/v1/domains

Elements

8

The elemental types of Teyvat. Each element lists the characters that wield it and the enemies that deal its damage.

/api/v1/elements

Enemies

369

Common enemies, elites and bosses with their type, family, group, region, damage elements, resistances, drops, release version and archive description.

/api/v1/enemies

Enemy Families

8

Top-level enemy families such as Hilichurls, The Abyss or Automatons. Each family lists its groups and all its enemies.

/api/v1/enemy-families

Enemy Groups

55

Enemy groups inside a family, such as Samachurls or Abyss Mages. Each group lists its family and its enemies.

/api/v1/enemy-groups

Enemy Types

4

Enemy classifications: common enemies, elites, normal bosses and weekly bosses. Each type lists its enemies.

/api/v1/enemy-types

Item Groups

122

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.

/api/v1/item-groups

Item Types

6

Item types as shown in the in-game inventory, such as Character Ascension Materials or Local Specialties. Each type lists its groups and items.

/api/v1/item-types

Items

509

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.

/api/v1/items

Rarities

5

Star ratings from 1 to 5. Each rarity lists the characters and weapons that have it.

/api/v1/rarities

Regions

9

The nations and lands of Teyvat. Each region lists its characters, local specialties, bosses and domains.

/api/v1/regions

Stats

33

Character attributes such as HP, CRIT Rate or Elemental Mastery. Each stat lists the characters that gain it on ascension, the weapons that have it as secondary stat and the artifact types where it can roll.

/api/v1/stats

Versions

54

Game versions with their update title and release date. Each version lists the characters, weapons, constellations, artifact sets, enemies, items and domains released in it.

/api/v1/versions

Weapon Types

5

The weapon classes available to characters. Each type lists its characters and weapons.

/api/v1/weapon-types

Weapons

252

Every weapon with its rarity, type, secondary stat, series, ascension materials and release version.

/api/v1/weapons

Ready to set out?

Start with the introduction and make your first request in seconds.

Read the Docs