Resource

Rarities

Star ratings from 1 to 5. Each rarity lists the characters and weapons that have it.

5items
1filters
2sort fields

Endpoints

GET/api/v1/raritiesPaginated list
GET/api/v1/rarities/randomRandom item
GET/api/v1/rarities/{id or name}Single item

List

Returns a paginated list of rarities 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/rarities?limit=2
{
  "count": 5,
  "next": "https://genshin-api.replace_me.workers.dev/api/v1/rarities?limit=2&offset=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "slug": "1-star",
      "name": "1-Star",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/rarities/1-star",
      "stars": 1,
      "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/rarities/1-star.webp"
    },
    {
      "id": 2,
      "slug": "2-star",
      "name": "2-Star",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/rarities/2-star",
      "stars": 2,
      "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/rarities/2-star.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
starsnumber
imagesobject
charactersReference[]
weaponsReference[]
GET /api/v1/rarities/5-star
{
  "id": 5,
  "slug": "5-star",
  "name": "5-Star",
  "url": "https://genshin-api.replace_me.workers.dev/api/v1/rarities/5-star",
  "stars": 5,
  "images": {
    "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/rarities/5-star.webp"
  },
  "characters": [
    {
      "id": 1,
      "slug": "aether",
      "name": "Aether",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/characters/aether",
      "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/characters/aether/icon.webp"
    },
    {
      "id": 2,
      "slug": "lumine",
      "name": "Lumine",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/characters/lumine",
      "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/characters/lumine/icon.webp"
    }
  ],
  "weapons": [
    {
      "id": 117,
      "slug": "summit-shaper",
      "name": "Summit Shaper",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/weapons/summit-shaper",
      "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/weapons/summit-shaper/icon.webp"
    },
    {
      "id": 118,
      "slug": "skyward-blade",
      "name": "Skyward Blade",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/weapons/skyward-blade",
      "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/weapons/skyward-blade/icon.webp"
    }
  ]
}

Random

Returns one random item with the same shape as the single item endpoint. Accepts name.

Try it

GETgenshin-api.REPLACE_ME.workers.dev