Welcome to GSHIMPACT APIs, travelers!
You and I are both travelers from another world. That our paths have crossed here is no accident, but the will of fate.
Fischl - Prinzessin der Verurteilung
Introduction
The Genshin-API is a REST API based on the open-world online game Genshin Impact. This API contains data for all playable characters of Genshin Impact. Its also providing media data, voices lines of each characters. More data will be available soon.
Playground
Enter the endpoint your want to test here and see.
Root URL
https://gsi.fly.dev/
The root endpoint provide information on all available endpoints and resources within the API. These resources are all reachable by GET requests sent over HTTPS.
Characters
/characters
Returning a list of characters information. By default, first 10 characters will be sent, sort by ID (ascending).
Query parameters:
| Name | Required | Value |
|---|---|---|
| page | optional | 1, 2, 3, ... |
| limit | optional | 1, 2, 3, ... |
/characters/:id
Get information of a character by ID.
Path parameters:
| Name | Required | Value |
|---|---|---|
| id | required | 1, 2, 3, ... |
/characters/search
Search characters, returning a list of matched characters.
Query parameters:
| Name | Required | Value |
|---|---|---|
| name | optional | Amber, Klee,... |
| region | optional | Liyue, Inazuma,... |
| vision | optional | Geo, Hydro,... |
| rarity | optional | 4_start, 5_start |
| weapon | optional | Sword, Bow,... |
| model_type | optional | Medium female, Tall male,... |
/characters/:id/media
Return a list of media links that are related to a characters.
Path parameters:
| Name | Required | Value |
|---|---|---|
| id | required | 1, 2, 3, ... |
/characters/:id/voices
Return a list of media links that are related to a characters.
Path parameters:
| Name | Required | Value |
|---|---|---|
| id | required | 1, 2, 3, ... |
Banners
/banners
Return a list of banners (event wishes).
Query parameters:
| Name | Required | Value |
|---|---|---|
| page | optional | 1, 2, 3, ... |
| limit | optional | 1, 2, 3, ... |
/banners/:id
Return a banner by its id.
Path parameters:
| Name | Required | Value |
|---|---|---|
| id | required | 1, 2, 3, ... |
/banners/current
Return current banners.
Voices
/voices
Return a list of voice-lines in game.
Query parameters:
| Name | Required | Value |
|---|---|---|
| page | optional | 1, 2, 3, ... |
Sample Response: