BYTETOOLS

Genshin Impact API

Free Genshin Impact API with no key: characters, weapons, artifacts, elements and domains with official artwork and stat data. Tested curl example.

No API key requiredHTTPSFree tier

Endpoint tested and returned HTTP 200 on 2026-08-20

What is the Genshin Impact API?

The Genshin Impact API (genshin.jmp.blue) is a free, key-free community API providing game data — characters with elements and constellations, weapons, artifact sets, domains and materials — along with official artwork.

This community API covers Genshin's character roster, weapons and artifact sets with the stat and lore data players need for build guides and team planners.

The listing endpoints return bare arrays of slug names rather than full objects, which is unusual. You fetch the list, then request each character individually — an N+1 pattern that is worth caching aggressively since the data is static between game updates.

Quick facts

Base URL
https://genshin.jmp.blue
Authentication
No API key required.
Rate limit
No published hard limit; fair use expected.
Pricing
Free and open source.
CORS
Not enabled — call it from your server
Official docs
Read the docs

How to use the Genshin Impact API

Every request below was executed against the live API on 2026-08-20, and the response shown is the real body it returned — not an illustration.

1. List Genshin Impact characters

GET https://genshin.jmp.blue/characters

curl
curl 'https://genshin.jmp.blue/characters'
JavaScript (fetch)
const res = await fetch("https://genshin.jmp.blue/characters");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);
Python (requests)
import requests

res = requests.get("https://genshin.jmp.blue/characters", timeout=20)
res.raise_for_status()
print(res.json())
Response — HTTP 200
[
  "albedo",
  "alhaitham",
  "aloy",
  "amber",
  "arataki-itto",
  "arlecchino",
  "ayaka",
  "ayato",
  "baizhu",
  "barbara",
  "beidou",
  "bennett",
  "candace",
  "charlotte",
  "chevreuse",
  "chiori",
  "chongyun",
  "clorinde",
  "collei",
  "cyno",
  "dehya",
  "diluc",
  "diona",
  "dori",
  "emilie",
  "eula",
  "faruzan",
  "fischl",
  "freminet",
  "furina",
  "gaming",
  "ganyu",
  "gorou",
  "hu-tao",
  "jean",
  "kachina",
  "kaeya",
  "kaveh",
  "kazuha",
  "keqing",
  "kinich",
  "kirara",
  "klee",
  "kokomi",
  "kuki-shinobu",
  "layla",
  "lisa",
  "lynette",
  "lyney",
  "mika",
  "mona",
  "mualani",
  "nahida",
  "navia",
  "neuvillette",
  "nilou",
  "ningguang",
  "noelle",
  "qiqi",
  "raiden",
  "razor",
  "rosaria",
  "sara",
  "sayu",
  "sethos",
  "shenhe",
  "shikanoin-heizou",
  "sigewinne",
  "sucrose",
  "tartaglia",
  "thoma",
  "tighnari",
  "traveler-anemo",
  "traveler-dendro",
  "traveler-electro",
  "traveler-geo",
  "traveler-hydro",
  "venti",
  "wanderer",
  "wriothesley",
  "xiangling",
  "xianyun",
  "xiao",
  "xingqiu",
  "xinyan",
  "yae-miko",
  "yanfei",
  "yaoyao",
  "yelan",
  "yoimiya",
  "yun-jin",
  "zhongli"
]

Parameters

ParameterTypeRequiredDescription
characterspathOptionalList character slugs, or /characters/<name> for one. characters
weaponspathOptionalWeapon data. weapons
artifactspathOptionalArtifact set data. artifacts
elementspathOptionalThe seven elements. elements
<name>/<asset>pathOptionalCharacter artwork such as icon, portrait or card. amber/card

Response fields

(list)array
Bare array of slug names on listing endpoints.
namestring
Character display name.
visionstring
Element — Pyro, Hydro, Anemo and so on.
weaponstring
Weapon type the character uses.
rarityinteger
Star rating, 4 or 5.
constellationstring
Constellation name.
skillTalents / passiveTalentsarray
Abilities with descriptions.

What you can build with the Genshin Impact API

  • Build a character reference or team planner
  • Create build guides with official artwork
  • Filter characters by element or weapon type
  • Power a Genshin community site or Discord bot

Common errors and how to fix them

List returns strings, not objects

Listing endpoints give slugs only.

Fix: Fetch each character individually by slug — cache the results, as the data only changes with game updates.

404 on a character

Slugs are lowercase and hyphenated.

Fix: Use raiden-shogun rather than a display name.

Artwork endpoints return images

Asset paths serve binary images, not JSON.

Fix: Use them directly as image sources rather than parsing.

Genshin Impact API — frequently asked questions

Is the Genshin Impact API free?

Yes, completely free and open source with no API key. It is community-built and not affiliated with HoYoverse.

Why does the character list return only names?

Listing endpoints return slugs, and you fetch each character individually for full data. Cache aggressively — the data only changes when the game updates.

Does it include artwork?

Yes, each character has icon, portrait, card and gacha splash images served directly as binary images from asset paths.

Is it official?

No, it is a community project. HoYoverse holds the underlying rights to the game data and artwork, so check their terms before commercial use.

Tools that pair with this API

JSON Formatter

Format, beautify and minify JSON online with 2-space, 4-space or tab indentation. Sort keys alphabetically and catch syntax errors instantly — free and private.

Image Cropper

Crop images online to an exact rectangle with pixel-precise x, y, width and height inputs or aspect-ratio presets. Free, private and browser-based.

Genshin Impact API is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 2026-08-20; always check the official documentation before relying on this API in production, as terms and limits can change.