Resource

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 list
GET/api/v1/regions/randomRandom item
GET/api/v1/regions/{id or name}Single item

List

Returns a paginated list of regions in summary form.

Query parameters

ParameterDescription
limitItems per page (1-100, default 20)
offsetItems to skip (default 0)
sortOne of id, name. Prefix with - for descending.
namePartial match on the name
GET /api/v1/regions?limit=2
{
  "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

FieldType
idnumber
slugstring
namestring
urlstring
imagesobject
charactersReference[]
localSpecialtiesReference[]
enemiesReference[]
domainsReference[]
GET /api/v1/regions/liyue
{
  "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.

Try it

GETgenshin-api.REPLACE_ME.workers.dev