Artifact Sets
Artifact sets with the rarities they drop in, their release version and their pieces.
64items
4filters
3sort fields
Endpoints
GET
/api/v1/artifact-setsPaginated listGET
/api/v1/artifact-sets/randomRandom itemGET
/api/v1/artifact-sets/{id or name}Single itemList
Returns a paginated list of artifact sets 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, maxRarity. Prefix with - for descending. |
name | Partial match on the name |
rarity | Rarity the set is available in, e.g. 5 or 5-star. Matches any of the set rarities. Comma-separated values allowed. |
type | Artifact type slug the set has a piece for, e.g. circlet-of-logos. Comma-separated values allowed. |
releaseVersion | Release version, e.g. 5.0 or luna-i. Comma-separated values allowed. |
{
"count": 64,
"next": "https://cdn.genshin-api.com/api/v1/artifact-sets?limit=2&offset=2",
"previous": null,
"results": [
{
"id": 1,
"slug": "initiate",
"name": "Initiate",
"url": "https://cdn.genshin-api.com/api/v1/artifact-sets/initiate",
"rarities": [
{
"id": 1,
"slug": "1-star",
"name": "1-Star",
"url": "https://cdn.genshin-api.com/api/v1/rarities/1-star",
"icon": "https://cdn.genshin-api.com/rarities/1-star.webp"
}
],
"pieces": 2,
"icon": null
},
{
"id": 2,
"slug": "adventurer",
"name": "Adventurer",
"url": "https://cdn.genshin-api.com/api/v1/artifact-sets/adventurer",
"rarities": [
{
"id": 1,
"slug": "1-star",
"name": "1-Star",
"url": "https://cdn.genshin-api.com/api/v1/rarities/1-star",
"icon": "https://cdn.genshin-api.com/rarities/1-star.webp"
},
{
"id": 2,
"slug": "2-star",
"name": "2-Star",
"url": "https://cdn.genshin-api.com/api/v1/rarities/2-star",
"icon": "https://cdn.genshin-api.com/rarities/2-star.webp"
}
],
"pieces": 5,
"icon": null
}
]
}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 |
rarities | Reference[] |
releaseVersion | Reference |
pieces | Reference[] |
images | object |
obtainedFrom | Reference[] |
droppedBy | Reference[] |
{
"id": 30,
"slug": "crimson-witch-of-flames",
"name": "Crimson Witch of Flames",
"url": "https://cdn.genshin-api.com/api/v1/artifact-sets/crimson-witch-of-flames",
"rarities": [
{
"id": 4,
"slug": "4-star",
"name": "4-Star",
"url": "https://cdn.genshin-api.com/api/v1/rarities/4-star",
"icon": "https://cdn.genshin-api.com/rarities/4-star.webp"
},
{
"id": 5,
"slug": "5-star",
"name": "5-Star",
"url": "https://cdn.genshin-api.com/api/v1/rarities/5-star",
"icon": "https://cdn.genshin-api.com/rarities/5-star.webp"
}
],
"releaseVersion": {
"id": 1,
"slug": "1-0",
"name": "1.0",
"url": "https://cdn.genshin-api.com/api/v1/versions/1-0"
},
"pieces": [
{
"id": 127,
"slug": "witchs-flower-of-blaze",
"name": "Witch's Flower of Blaze",
"url": "https://cdn.genshin-api.com/api/v1/artifacts/witchs-flower-of-blaze",
"type": {
"id": 1,
"slug": "flower-of-life",
"name": "Flower of Life",
"url": "https://cdn.genshin-api.com/api/v1/artifact-types/flower-of-life"
}
},
{
"id": 128,
"slug": "witchs-ever-burning-plume",
"name": "Witch's Ever-Burning Plume",
"url": "https://cdn.genshin-api.com/api/v1/artifacts/witchs-ever-burning-plume",
"type": {
"id": 2,
"slug": "plume-of-death",
"name": "Plume of Death",
"url": "https://cdn.genshin-api.com/api/v1/artifact-types/plume-of-death"
}
}
],
"images": {},
"obtainedFrom": [
{
"id": 3,
"slug": "hidden-palace-of-zhou-formula",
"name": "Hidden Palace of Zhou Formula",
"url": "https://cdn.genshin-api.com/api/v1/domains/hidden-palace-of-zhou-formula"
}
],
"droppedBy": []
}Random
Returns one random item with the same shape as the single item endpoint. Accepts name and every list filter.