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 20 Aug 2026

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 20 Aug 2026, 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

Parameter	Type	Required	Description
`characters`	path	Optional	List character slugs, or /characters/<name> for one. `characters`
`weapons`	path	Optional	Weapon data. `weapons`
`artifacts`	path	Optional	Artifact set data. `artifacts`
`elements`	path	Optional	The seven elements. `elements`
`<name>/<asset>`	path	Optional	Character 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.

Alternatives to Genshin Impact API

If Genshin Impact API does not fit, these game & anime apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.

API	What it does	Auth	CORS	Last verified
PokéAPI	Free Pokémon API with no key: stats, types, abilities, moves, evolutions and sprites for 1,000+ species. The most popular API for learning REST. Tested example.	No key	Yes	19 Aug 2026
Rick and Morty API	Free Rick and Morty API with no key: 800+ characters, episodes and locations with images, filtering and pagination. REST and GraphQL. Tested example.	No key	Yes	19 Aug 2026
Jikan (MyAnimeList)	Free unofficial MyAnimeList API with no key: anime and manga data, scores, characters, staff and seasonal listings. Tested curl example and live JSON.	No key	Yes	19 Aug 2026
Deck of Cards	Free playing card API with no key: shuffle decks, draw cards, manage piles and get card images. Stateful deck ids. Tested curl example and live JSON.	No key	Yes	19 Aug 2026
GraphQL Pokémon (Favware)	Free GraphQL Pokémon API with no key. Ask for exactly the fields you need — stats, types, abilities, learnsets, sprites — in a single query. Tested POST example included.	No key	Yes	21 Aug 2026
Guild Wars 2 API	The official Guild Wars 2 API: items, recipes, world bosses, WvW matches and trading post prices, all key-free for public data. Tested curl example and live response.	No key	Yes	21 Aug 2026

All Game & Anime APIs

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