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 listGET
/api/v1/constellations/randomRandom itemGET
/api/v1/constellations/{id or name}Single itemList
Returns a paginated list of constellations 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 |
character | Character slug, e.g. hu-tao. Comma-separated values allowed. |
element | Element slug, e.g. pyro. Comma-separated values allowed. |
region | Region slug of the character. Comma-separated values allowed. |
releaseVersion | Release version, e.g. 1.3 or luna-i. Comma-separated values allowed. |
{
"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
| Field | Type |
|---|---|
id | number |
slug | string |
name | string |
url | string |
meaning | string |
character | Reference |
element | Reference |
releaseVersion | Reference |
image | string | null |
levels | object[] |
{
"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.