Regions
The nations and lands of Teyvat. Each region lists its characters, local specialties, bosses and domains.
9items
1filters
2sort fields
Endpoints
GET
/api/v1/regionsPaginated listGET
/api/v1/regions/randomRandom itemGET
/api/v1/regions/{id or name}Single itemList
Returns a paginated list of regions in summary form.
Query parameters
| Parameter | Description |
|---|---|
limit | Items per page (1-100, default 20) |
offset | Items to skip (default 0) |
sort | One of id, name. Prefix with - for descending. |
name | Partial match on the name |
{
"count": 9,
"next": "https://genshin-api.replace_me.workers.dev/api/v1/regions?limit=2&offset=2",
"previous": null,
"results": [
{
"id": 1,
"slug": "mondstadt",
"name": "Mondstadt",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/regions/mondstadt",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/regions/mondstadt.webp"
},
{
"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"
}
]
}Single item
Returns the full details of one item, by numeric id or by name. Arrays in the example below are shortened.
Fields
| Field | Type |
|---|---|
id | number |
slug | string |
name | string |
url | string |
images | object |
characters | Reference[] |
localSpecialties | Reference[] |
enemies | Reference[] |
domains | Reference[] |
{
"id": 2,
"slug": "liyue",
"name": "Liyue",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/regions/liyue",
"images": {
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/regions/liyue.webp"
},
"characters": [
{
"id": 8,
"slug": "xiangling",
"name": "Xiangling",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/characters/xiangling",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/characters/xiangling/icon.png"
},
{
"id": 10,
"slug": "qiqi",
"name": "Qiqi",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/characters/qiqi",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/characters/qiqi/icon.png"
}
],
"localSpecialties": [
{
"id": 123,
"slug": "jueyun-chili",
"name": "Jueyun Chili",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/items/jueyun-chili",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/local-specialties/jueyun-chili.webp"
},
{
"id": 124,
"slug": "noctilucous-jade",
"name": "Noctilucous Jade",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/items/noctilucous-jade",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/local-specialties/noctilucous-jade.webp"
}
],
"enemies": [
{
"id": 66,
"slug": "geo-hypostasis",
"name": "Geo Hypostasis",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/enemies/geo-hypostasis"
},
{
"id": 67,
"slug": "rhodeia-of-loch",
"name": "Rhodeia of Loch",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/enemies/rhodeia-of-loch"
}
],
"domains": [
{
"id": 1,
"slug": "clear-pool-and-mountain-cavern",
"name": "Clear Pool and Mountain Cavern",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/domains/clear-pool-and-mountain-cavern"
},
{
"id": 2,
"slug": "domain-of-guyun",
"name": "Domain of Guyun",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/domains/domain-of-guyun"
}
]
}Random
Returns one random item with the same shape as the single item endpoint. Accepts name.