Weapons
Every weapon with its rarity, type, secondary stat, series, ascension materials and release version.
252items
7filters
3sort fields
Endpoints
GET
/api/v1/weaponsPaginated listGET
/api/v1/weapons/randomRandom itemGET
/api/v1/weapons/{id or name}Single itemList
Returns a paginated list of weapons 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, rarity. Prefix with - for descending. |
name | Partial match on the name |
rarity | Rarity stars (1-5) or rarity slug, e.g. 5 or 5-star. Comma-separated values allowed. |
weaponType | Weapon type slug. Comma-separated values allowed. |
secondaryStat | Secondary stat slug, e.g. crit-rate. Comma-separated values allowed. |
series | Weapon series, e.g. favonius-series. Comma-separated values allowed. |
material | Item or item group slug used to ascend the weapon, e.g. aerosiderite or slime-concentrate. Comma-separated values allowed. |
releaseVersion | Release version, e.g. 1.3 or luna-i. Comma-separated values allowed. |
{
"count": 252,
"next": "https://genshin-api.replace_me.workers.dev/api/v1/weapons?limit=2&offset=2",
"previous": null,
"results": [
{
"id": 1,
"slug": "dull-blade",
"name": "Dull Blade",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/weapons/dull-blade",
"rarity": {
"id": 1,
"slug": "1-star",
"name": "1-Star",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/rarities/1-star",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/rarities/1-star.webp"
},
"weaponType": {
"id": 1,
"slug": "sword",
"name": "Sword",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/weapon-types/sword",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/weapon-types/sword.webp"
},
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/weapons/dull-blade/icon.webp"
},
{
"id": 2,
"slug": "waster-greatsword",
"name": "Waster Greatsword",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/weapons/waster-greatsword",
"rarity": {
"id": 1,
"slug": "1-star",
"name": "1-Star",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/rarities/1-star",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/rarities/1-star.webp"
},
"weaponType": {
"id": 2,
"slug": "claymore",
"name": "Claymore",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/weapon-types/claymore",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/weapon-types/claymore.webp"
},
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/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
| Field | Type |
|---|---|
id | number |
slug | string |
name | string |
url | string |
rarity | Reference |
weaponType | Reference |
secondaryStat | Reference | null |
series | string[] |
materials | object |
releaseVersion | Reference |
images | object |
{
"id": 133,
"slug": "staff-of-homa",
"name": "Staff of Homa",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/weapons/staff-of-homa",
"rarity": {
"id": 5,
"slug": "5-star",
"name": "5-Star",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/rarities/5-star",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/rarities/5-star.webp"
},
"weaponType": {
"id": 3,
"slug": "polearm",
"name": "Polearm",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/weapon-types/polearm",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/weapon-types/polearm.webp"
},
"secondaryStat": {
"id": 7,
"slug": "crit-dmg",
"name": "CRIT DMG",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/stats/crit-dmg"
},
"series": [],
"materials": {
"ascension": [
{
"id": 114,
"slug": "grain-of-aerosiderite",
"name": "Grain of Aerosiderite",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/items/grain-of-aerosiderite"
},
{
"id": 115,
"slug": "piece-of-aerosiderite",
"name": "Piece of Aerosiderite",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/items/piece-of-aerosiderite"
}
],
"elite": [
{
"id": 25,
"slug": "dead-ley-line-branch",
"name": "Dead Ley Line Branch",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/items/dead-ley-line-branch"
},
{
"id": 26,
"slug": "dead-ley-line-leaves",
"name": "Dead Ley Line Leaves",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/items/dead-ley-line-leaves"
}
],
"common": [
{
"id": 1,
"slug": "slime-condensate",
"name": "Slime Condensate",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/items/slime-condensate"
},
{
"id": 2,
"slug": "slime-secretions",
"name": "Slime Secretions",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/items/slime-secretions"
}
]
},
"releaseVersion": {
"id": 4,
"slug": "1-3",
"name": "1.3",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/versions/1-3"
},
"images": {
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/weapons/staff-of-homa/icon.webp",
"awakenedIcon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/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.