{"openapi":"3.1.0","info":{"title":"Genshin Impact API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/genshin-api","description":"oanor gateway"}],"tags":[{"name":"Genshin"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/artifact":{"get":{"operationId":"get_v1_artifact","tags":["Genshin"],"summary":"An artifact set by name, or the full list","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Artifact slug, e.g. archaic-petra","schema":{"type":"string"},"example":"archaic-petra"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/character":{"get":{"operationId":"get_v1_character","tags":["Genshin"],"summary":"A character by name, or the full roster","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Character slug, e.g. albedo or hu-tao (omit for the roster)","schema":{"type":"string"},"example":"albedo"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/list":{"get":{"operationId":"get_v1_list","tags":["Genshin"],"summary":"List or detail any resource type","description":"","parameters":[{"name":"type","in":"query","required":true,"description":"elements | nations | boss | domains | materials | consumables | enemies | weapons | artifacts | characters","schema":{"type":"string"},"example":"elements"},{"name":"name","in":"query","required":false,"description":"Optional slug for a single item","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/weapon":{"get":{"operationId":"get_v1_weapon","tags":["Genshin"],"summary":"A weapon by name, or the full list","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Weapon slug, e.g. skyward-blade","schema":{"type":"string"},"example":"skyward-blade"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Resource types & usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":10500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":310,"monthly_call_quota":155000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":990,"monthly_call_quota":720000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3060,"monthly_call_quota":2900000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/genshin-api"}