genshin APIgenshin.gg ↗
Access Genshin Impact character data from genshin.gg: full roster, talents, constellations, recommended builds, team comps, and ascension materials.
What is the genshin API?
The genshin.gg API provides access to Genshin Impact character data across 2 endpoints, covering the full playable roster and deep per-character detail. get_character_list returns every character's name, slug, rarity, and icon URL. get_character_details expands a single character into talents, passives, recommended team compositions, ascension materials, weapon icon, element, and assigned role — giving you everything needed to build or validate team planning tools.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/ec3d99ab-edbd-4ff8-a665-fb6e7b28eb52/get_character_list' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace genshin-gg-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""
Genshin Impact Character API (Genshin.gg)
Get your API key from: https://parse.bot/settings
"""
from parse_apis.genshin_impact_character_api_genshin_gg import GenshinGG, CharacterSummary
genshin = GenshinGG(api_key="YOUR_API_KEY")
# List all characters
for char in genshin.charactersummaries.list():
print(char.name, char.rarity, char.icon_url)
# Get full details for a character by constructing from slug
albedo = genshin.charactersummary("albedo").details()
print(albedo.name, albedo.element, albedo.weapon_type, albedo.role)
# Explore recommended weapons
for weapon in albedo.recommended_weapons:
print(weapon.rank, weapon.name, weapon.icon_url)
# Check artifact sets
for artifact in albedo.recommended_artifacts:
for art_set in artifact.sets:
print(art_set.name, art_set.count)
# Browse talents
for talent in albedo.talents:
print(talent.title, talent.name)
# Fetch directly via characters collection
hutao = genshin.characters.get(slug="hutao")
print(hutao.name, hutao.element, hutao.rarity)
for team in hutao.best_teams:
print(team.name)
for member in team.members:
print(member.name, member.icon_url)
Retrieve the complete roster of playable Genshin Impact characters with basic metadata. Returns name, slug, star rarity, and icon URL for every character. No filtering or pagination — the full list is returned in one call. Use a character's slug to fetch their full build details via get_character_details.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer total count of characters",
"characters": "array of character summary objects each containing name, slug, rarity, and icon_url"
},
"sample": {
"data": {
"total": 120,
"characters": [
{
"name": "Albedo",
"slug": "albedo",
"rarity": 5,
"icon_url": "https://sunderarmor.com/GENSHIN/Characters/1/Albedo.png"
},
{
"name": "Alhaitham",
"slug": "alhaitham",
"rarity": 5,
"icon_url": "https://sunderarmor.com/GENSHIN/Characters/1/Alhaitham.png"
}
]
},
"status": "success"
}
}About the genshin API
Character Roster
get_character_list takes no parameters and returns the complete roster of playable Genshin Impact characters. Each entry in the characters array includes name, slug, rarity (4 or 5 stars), and icon_url. The total field gives the integer count of characters currently indexed. Use the slug values from this endpoint as input to get_character_details.
Per-Character Detail
get_character_details accepts a single required parameter — slug — and returns a structured object with over a dozen fields. Core identity fields include element (e.g. Geo, Pyro, Cryo), rarity, and role (e.g. Main DPS, Sub DPS, Support). Combat mechanics are covered by the talents array (each entry has title, name, description, and icon_url) and the passives array in the same shape.
Team Composition and Build Data
The best_teams field is an array of team composition objects, each with a name and a members list, reflecting the recommended party setups curated on genshin.gg. The weapon_icon field links to the character's weapon-type icon image, and image_url provides the full character portrait. Ascension costs and materials are also returned, making the endpoint useful for resource-planning features.
Slugs as the Linking Key
The two endpoints are designed to work together: call get_character_list first to retrieve all valid slugs, then pass any slug (e.g. albedo, hu-tao) to get_character_details. There are no additional filter parameters on either endpoint — the list endpoint always returns all characters, and the detail endpoint always returns the full data object for the given slug.
The genshin API is a managed, monitored endpoint for genshin.gg — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when genshin.gg changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official genshin.gg API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a team composition planner that populates role and element data from
get_character_details - Create a character tier list ranked by rarity and role using
get_character_listplus detail lookups - Display talent and passive descriptions in a game companion or wiki app
- Generate ascension material checklists per character for resource tracking tools
- Populate a searchable character database with element, role, and icon_url fields
- Recommend team compositions by matching
best_teamsmember slugs to roster data - Show weapon-type icons alongside character cards using the
weapon_iconURL field
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does genshin.gg have an official developer API?+
What does `get_character_details` return beyond basic stats?+
talents and passives arrays (each with title, name, description, and icon_url), a best_teams array of recommended team compositions with member lists, ascension costs and materials, weapon_icon, image_url, element, role, and rarity. It does not return raw stat tables (e.g. ATK by level) or constellation data in the current endpoint spec.Are constellation details included in the API response?+
get_character_details response.Does the API cover unreleased or beta characters?+
get_character_list results. You can fork the API on Parse and revise it to add a separate endpoint that tracks beta or upcoming character pages if they become publicly available on the site.Can I filter the character list by element or rarity?+
get_character_list returns all characters in a single response with no filter parameters. Filtering by element or rarity must be done client-side using the rarity integer field returned per character. You can fork this API on Parse and revise it to expose server-side filter parameters if needed.