# Genshin Impact API
> Genshin Impact game data as an API — every playable character, weapon, artifact set and more from miHoYo's open-world RPG. Look up a character by name (e.g. Albedo → Geo vision, Sword user, 5-star, with title, nation, constellation, birthday, skill and passive talents, and constellations) or pull the full 90+ roster, browse weapons (e.g. Skyward Blade → 5-star Sword) and artifact sets (e.g. Archaic Petra with its 2- and 4-piece bonuses), and list reference categories — elements, nations, bosses, domains, materials, consumables and enemies. Backed by the open genshin.dev dataset. Ideal for team-building and tier-list tools, damage calculators, wikis, Discord bots and any Genshin companion app.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/genshin-api/..."
```

## Pricing
- **Free** (Free) — 10,500 calls/Mo, 2 req/s
- **Starter** ($3/Mo) — 155,000 calls/Mo, 8 req/s
- **Pro** ($10/Mo) — 720,000 calls/Mo, 20 req/s
- **Mega** ($31/Mo) — 2,900,000 calls/Mo, 50 req/s

## Endpoints

### Genshin

#### `GET /v1/artifact` — An artifact set by name, or the full list

**Parameters:**
- `name` (query, optional, string) — Artifact slug, e.g. archaic-petra Example: `archaic-petra`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/genshin-api/v1/artifact?name=archaic-petra"
```

**Response:**
```json
{
    "data": {
        "artifact": {
            "id": "archaic-petra",
            "name": "Archaic Petra",
            "max_rarity": 5,
            "2-piece_bonus": "Gain a 15% Geo DMG Bonus.",
            "4-piece_bonus": "Upon obtaining an Elemental Shard created through a Crystallize Reaction, all party members gain a 35% DMG Bonus for that particular element for 10s. Only one form of Elemental DMG Bonus can be gained in this manner at any one time."
        }
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:32.038Z",
        "request_id": "bb1ce8a5-a503-474a-87f1-cad9a0ba0c12"
    },
    "status": "ok",
    "message": "Artifact retrieved",
    "success": true
}
```

#### `GET /v1/character` — A character by name, or the full roster

**Parameters:**
- `name` (query, optional, string) — Character slug, e.g. albedo or hu-tao (omit for the roster) Example: `albedo`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/genshin-api/v1/character?name=albedo"
```

**Response:**
```json
{
    "data": {
        "character": {
            "name": "Albedo",
            "title": "Kreideprinz",
            "gender": "Male",
            "nation": "Mondstadt",
            "rarity": 5,
            "vision": "Geo",
            "weapon": "Sword",
            "outfits": [],
            "release": "2020-12-23",
            "birthday": "0000-09-13",
            "affiliation": "Knights of Favonius",
            "description": "A genius known as the Kreideprinz, he is the Chief Alchemist and Captain of the Investigation Team of the Knights of Favonius.",
            "constellation": "Princeps Cretaceus",
            "skill_talents": [
                "Favonius Bladework - Weiss",
                "Abiogenesis: Solar Isotoma",
                "Rite of Progeniture: Tectonic Tide"
            ],
            "constellations": [
                "Flower of Eden",
                "Opening of Phanerozoic",
                "Grace of Helios",
                "Descent of Divinity",
                "Tide of Hadaen",
                "Dust of Purification"
            ],
            "passive_talents": [
                "Calcite Might",
                "Homuncular Nature",
                "Flash of Genius"
            ]
        }
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:32.176Z",
        "request_id": "1faf47cc-0eb2-45c8-8655-889925c96c0f"
    },
    "status": "ok",
    "message": "Character retrieved",
    "success": true
}
```

#### `GET /v1/list` — List or detail any resource type

**Parameters:**
- `type` (query, required, string) — elements | nations | boss | domains | materials | consumables | enemies | weapons | artifacts | characters Example: `elements`
- `name` (query, optional, string) — Optional slug for a single item

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/genshin-api/v1/list?type=elements"
```

**Response:**
```json
{
    "data": {
        "type": "elements",
        "count": 7,
        "results": [
            "anemo",
            "cryo",
            "dendro",
            "electro",
            "geo",
            "hydro",
            "pyro"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:32.265Z",
        "request_id": "067adae1-c691-4566-8eb7-a68eaa3fda3f"
    },
    "status": "ok",
    "message": "Resources listed",
    "success": true
}
```

#### `GET /v1/weapon` — A weapon by name, or the full list

**Parameters:**
- `name` (query, optional, string) — Weapon slug, e.g. skyward-blade Example: `skyward-blade`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/genshin-api/v1/weapon?name=skyward-blade"
```

**Response:**
```json
{
    "data": {
        "weapon": {
            "id": "skyward-blade",
            "name": "Skyward Blade",
            "type": "Sword",
            "rarity": 5,
            "subStat": "Energy Recharge",
            "location": "Gacha",
            "baseAttack": 44,
            "passiveDesc": "CRIT Rate increased by 4%. Gains Skypiercing Might upon using an Elemental Burst:\nIncreases Movement SPD by 10%, increases ATK SPD by 10%, and increases the DMG of Normal and Charged Attack hits by 20% for 12s.",
            "passiveName": "Sky-Piercing Fang",
            "ascensionMaterial": "boreal"
        }
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:32.359Z",
        "request_id": "9c3d52ea-c232-4a1e-8011-3335d8b0aaf6"
    },
    "status": "ok",
    "message": "Weapon retrieved",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Resource types & usage notes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/genshin-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Genshin Impact game data. /v1/character = a character by name (e.g. name=albedo) with vision, weapon, rarity, talents and constellations — or the full roster; /v1/weapon = a weapon (e.g. name=skyward-blade); /v1/artifact = an artifact set (e.g. name=archaic-petra); /v1/list = list/detail any resource type (type=elements|nations|boss|domains|materials|consumables|enemies, optional name=). Slugs are lowercase-hyphenated.",
        "types": [
            "artifacts",
            "boss",
            "characters",
            "consumables",
            "domains",
            "elements",
            "enemies",
            "materials",
            "nations",
            "weapons"
        ],
        "source": "genshin.dev (genshin.jmp.blue)",
        "endpoints": [
            "/v1/character",
            "/v1/weapon",
            "/v1/artifact",
            "/v1/list",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:32.432Z",
        "request_id": "c22e7260-342e-4392-a05a-4f88d7d34496"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/genshin-api
OpenAPI spec: https://www.oanor.com/api/genshin-api/openapi.json