genshin.gg APIgenshin.gg ↗
Access Genshin Impact character data from genshin.gg: full roster, talents, constellations, recommended builds, team comps, and ascension materials.
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'
Get the list of all playable characters with basic information including name, slug, rarity, and icon URL. Returns all characters available on genshin.gg.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer total count of characters",
"characters": "array of character objects each containing name, slug, rarity, and icon_url"
},
"sample": {
"data": {
"total": 118,
"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.gg 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.
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.
- 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 | 250 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.