Resource

Weapons

Every weapon with its rarity, type, secondary stat, series, ascension materials and release version.

252items
7filters
3sort fields

Endpoints

GET/api/v1/weaponsPaginated list
GET/api/v1/weapons/randomRandom item
GET/api/v1/weapons/{id or name}Single item

List

Returns a paginated list of weapons in summary form.

Query parameters

ParameterDescription
limitItems per page (1-100, default 20)
offsetItems to skip (default 0)
sortOne of id, name, rarity. Prefix with - for descending.
namePartial match on the name
rarityRarity stars (1-5) or rarity slug, e.g. 5 or 5-star. Comma-separated values allowed.
weaponTypeWeapon type slug. Comma-separated values allowed.
secondaryStatSecondary stat slug, e.g. crit-rate. Comma-separated values allowed.
seriesWeapon series, e.g. favonius-series. Comma-separated values allowed.
materialItem or item group slug used to ascend the weapon, e.g. aerosiderite or slime-concentrate. Comma-separated values allowed.
releaseVersionRelease version, e.g. 1.3 or luna-i. Comma-separated values allowed.
GET /api/v1/weapons?limit=2
{
  "count": 252,
  "next": "https://cdn.genshin-api.com/api/v1/weapons?limit=2&offset=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "slug": "dull-blade",
      "name": "Dull Blade",
      "url": "https://cdn.genshin-api.com/api/v1/weapons/dull-blade",
      "rarity": {
        "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"
      },
      "weaponType": {
        "id": 1,
        "slug": "sword",
        "name": "Sword",
        "url": "https://cdn.genshin-api.com/api/v1/weapon-types/sword",
        "icon": "https://cdn.genshin-api.com/weapon-types/sword.webp"
      },
      "icon": "https://cdn.genshin-api.com/weapons/dull-blade/icon.webp"
    },
    {
      "id": 2,
      "slug": "waster-greatsword",
      "name": "Waster Greatsword",
      "url": "https://cdn.genshin-api.com/api/v1/weapons/waster-greatsword",
      "rarity": {
        "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"
      },
      "weaponType": {
        "id": 2,
        "slug": "claymore",
        "name": "Claymore",
        "url": "https://cdn.genshin-api.com/api/v1/weapon-types/claymore",
        "icon": "https://cdn.genshin-api.com/weapon-types/claymore.webp"
      },
      "icon": "https://cdn.genshin-api.com/weapons/waster-greatsword/icon.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
rarityReference
weaponTypeReference
secondaryStatReference | null
seriesstring[]
materialsobject
releaseVersionReference
imagesobject
GET /api/v1/weapons/staff-of-homa
{
  "id": 133,
  "slug": "staff-of-homa",
  "name": "Staff of Homa",
  "url": "https://cdn.genshin-api.com/api/v1/weapons/staff-of-homa",
  "rarity": {
    "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"
  },
  "weaponType": {
    "id": 3,
    "slug": "polearm",
    "name": "Polearm",
    "url": "https://cdn.genshin-api.com/api/v1/weapon-types/polearm",
    "icon": "https://cdn.genshin-api.com/weapon-types/polearm.webp"
  },
  "secondaryStat": {
    "id": 7,
    "slug": "crit-dmg",
    "name": "CRIT DMG",
    "url": "https://cdn.genshin-api.com/api/v1/stats/crit-dmg"
  },
  "series": [],
  "materials": {
    "ascension": [
      {
        "id": 114,
        "slug": "grain-of-aerosiderite",
        "name": "Grain of Aerosiderite",
        "url": "https://cdn.genshin-api.com/api/v1/items/grain-of-aerosiderite"
      },
      {
        "id": 115,
        "slug": "piece-of-aerosiderite",
        "name": "Piece of Aerosiderite",
        "url": "https://cdn.genshin-api.com/api/v1/items/piece-of-aerosiderite"
      }
    ],
    "elite": [
      {
        "id": 25,
        "slug": "dead-ley-line-branch",
        "name": "Dead Ley Line Branch",
        "url": "https://cdn.genshin-api.com/api/v1/items/dead-ley-line-branch"
      },
      {
        "id": 26,
        "slug": "dead-ley-line-leaves",
        "name": "Dead Ley Line Leaves",
        "url": "https://cdn.genshin-api.com/api/v1/items/dead-ley-line-leaves"
      }
    ],
    "common": [
      {
        "id": 1,
        "slug": "slime-condensate",
        "name": "Slime Condensate",
        "url": "https://cdn.genshin-api.com/api/v1/items/slime-condensate"
      },
      {
        "id": 2,
        "slug": "slime-secretions",
        "name": "Slime Secretions",
        "url": "https://cdn.genshin-api.com/api/v1/items/slime-secretions"
      }
    ]
  },
  "releaseVersion": {
    "id": 4,
    "slug": "1-3",
    "name": "1.3",
    "url": "https://cdn.genshin-api.com/api/v1/versions/1-3"
  },
  "images": {
    "icon": "https://cdn.genshin-api.com/weapons/staff-of-homa/icon.webp",
    "awakenedIcon": "https://cdn.genshin-api.com/weapons/staff-of-homa/awakened-icon.webp"
  }
}

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