Resource

Constellations

Character constellations with their meaning, release version and six levels. Each constellation links to its character; travelers have one per element.

136items
5filters
2sort fields

Endpoints

GET/api/v1/constellationsPaginated list
GET/api/v1/constellations/randomRandom item
GET/api/v1/constellations/{id or name}Single item

List

Returns a paginated list of constellations 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
characterCharacter slug, e.g. hu-tao. Comma-separated values allowed.
elementElement slug, e.g. pyro. Comma-separated values allowed.
regionRegion slug of the character. Comma-separated values allowed.
releaseVersionRelease version, e.g. 1.3 or luna-i. Comma-separated values allowed.
GET /api/v1/constellations?limit=2
{
  "count": 136,
  "next": "https://cdn.genshin-api.com/api/v1/constellations?limit=2&offset=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "slug": "viator-anemo",
      "name": "Viator (Anemo)",
      "url": "https://cdn.genshin-api.com/api/v1/constellations/viator-anemo",
      "character": {
        "id": 1,
        "slug": "aether",
        "name": "Aether",
        "url": "https://cdn.genshin-api.com/api/v1/characters/aether",
        "icon": "https://cdn.genshin-api.com/characters/aether/icon.webp"
      },
      "element": {
        "id": 1,
        "slug": "anemo",
        "name": "Anemo",
        "url": "https://cdn.genshin-api.com/api/v1/elements/anemo",
        "icon": "https://cdn.genshin-api.com/elements/anemo.svg"
      },
      "image": "https://cdn.genshin-api.com/characters/aether/constellations/viator-anemo/image.webp"
    },
    {
      "id": 2,
      "slug": "viator-geo",
      "name": "Viator (Geo)",
      "url": "https://cdn.genshin-api.com/api/v1/constellations/viator-geo",
      "character": {
        "id": 1,
        "slug": "aether",
        "name": "Aether",
        "url": "https://cdn.genshin-api.com/api/v1/characters/aether",
        "icon": "https://cdn.genshin-api.com/characters/aether/icon.webp"
      },
      "element": {
        "id": 2,
        "slug": "geo",
        "name": "Geo",
        "url": "https://cdn.genshin-api.com/api/v1/elements/geo",
        "icon": "https://cdn.genshin-api.com/elements/geo.svg"
      },
      "image": "https://cdn.genshin-api.com/characters/aether/constellations/viator-geo/image.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
meaningstring
characterReference
elementReference
releaseVersionReference
imagestring | null
levelsobject[]
GET /api/v1/constellations/papilio-charontis
{
  "id": 33,
  "slug": "papilio-charontis",
  "name": "Papilio Charontis",
  "url": "https://cdn.genshin-api.com/api/v1/constellations/papilio-charontis",
  "meaning": "Butterfly of Charon",
  "character": {
    "id": 31,
    "slug": "hu-tao",
    "name": "Hu Tao",
    "url": "https://cdn.genshin-api.com/api/v1/characters/hu-tao",
    "icon": "https://cdn.genshin-api.com/characters/hu-tao/icon.png"
  },
  "element": {
    "id": 6,
    "slug": "pyro",
    "name": "Pyro",
    "url": "https://cdn.genshin-api.com/api/v1/elements/pyro",
    "icon": "https://cdn.genshin-api.com/elements/pyro.svg"
  },
  "releaseVersion": {
    "id": 4,
    "slug": "1-3",
    "name": "1.3",
    "url": "https://cdn.genshin-api.com/api/v1/versions/1-3"
  },
  "image": "https://cdn.genshin-api.com/characters/hu-tao/constellations/papilio-charontis/image.webp",
  "levels": [
    {
      "level": 1,
      "name": "Crimson Bouquet",
      "description": "While in a Paramita Papilio state activated by Guide to Afterlife, Hu Tao's Charged Attacks do not consume Stamina.",
      "icon": "https://cdn.genshin-api.com/characters/hu-tao/constellations/papilio-charontis/c1.svg"
    },
    {
      "level": 2,
      "name": "Ominous Rainfall",
      "description": "Increases the Blood Blossom DMG by an amount equal to 10% of Hu Tao's Max HP at the time the effect is applied. Additionally, Spirit Soother will also apply the Blood Blossom effect.",
      "icon": "https://cdn.genshin-api.com/characters/hu-tao/constellations/papilio-charontis/c2.svg"
    }
  ]
}

Random

Returns one random item with the same shape as the single item endpoint. Accepts name and every list filter.

Try it

GETcdn.genshin-api.com