Resource

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

List

Returns a paginated list of artifact sets in summary form.

Query parameters

ParameterDescription
limitItems per page (1-100, default 20)
offsetItems to skip (default 0)
sortOne of id, name, maxRarity. Prefix with - for descending.
namePartial match on the name
rarityRarity the set is available in, e.g. 5 or 5-star. Matches any of the set rarities. Comma-separated values allowed.
typeArtifact type slug the set has a piece for, e.g. circlet-of-logos. Comma-separated values allowed.
releaseVersionRelease version, e.g. 5.0 or luna-i. Comma-separated values allowed.
GET /api/v1/artifact-sets?limit=2
{
  "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

FieldType
idnumber
slugstring
namestring
urlstring
raritiesReference[]
releaseVersionReference
piecesReference[]
imagesobject
obtainedFromReference[]
droppedByReference[]
GET /api/v1/artifact-sets/crimson-witch-of-flames
{
  "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.

Try it

GETcdn.genshin-api.com