hoyolab.com APIhoyolab.com ↗
Access HoYoLAB character wikis, player profiles, and community posts for Genshin Impact, Honkai: Star Rail, and Zenless Zone Zero via a single REST API.
curl -X GET 'https://api.parse.bot/scraper/25bc7081-3f3a-46af-af7f-8569f84d11da/get_user_profile?uid=%3Cuid%3E' \ -H 'X-API-Key: $PARSE_API_KEY'
Get the public HoYoLAB profile of a user by their UID. Returns user info including nickname, avatar, achievements, and community settings.
| Param | Type | Description |
|---|---|---|
| uidrequired | string | HoYoLAB User ID (numeric string, e.g. '1015537'). |
{
"type": "object",
"fields": {
"data": "object containing user_info with nickname, uid, avatar_url, achieve stats, and community_info",
"message": "status message string",
"retcode": "integer indicating success (0) or error"
},
"sample": {
"data": {
"data": {
"user_info": {
"uid": "1015537",
"achieve": {
"like_num": "23743978",
"post_num": "4329",
"followed_cnt": "4774049"
},
"nickname": "Genshin Impact Official",
"introduce": "Grand Master of Genshin Impact Forum",
"avatar_url": "https://fastcdn.hoyoverse.com/static-resource-v2/2024/04/10/71a62b9a993534f3db7896fc6f725ff8_4436020059642725994.webp"
}
},
"message": "OK",
"retcode": 0
},
"status": "success"
}
}About the hoyolab.com API
This API exposes 5 endpoints covering HoYoLAB's character wiki, user profiles, and community feed across three games: Genshin Impact, Honkai: Star Rail, and Zenless Zone Zero. get_wiki_character_detail returns structured module data including ascension materials, talent info, and gallery assets. get_community_posts surfaces live post feeds with engagement stats and images, while get_user_profile retrieves any public player profile by numeric UID.
Character Wiki Data
get_wiki_character_list accepts a game slug (genshin, hsr, or zzz) plus optional page_num and page_size parameters and returns a paginated array of character entries. Each entry includes entry_page_id, name, icon_url, and filter_values covering element, weapon type, rarity, and region. The total field in the response tells you the full count so you can page through the complete roster.
get_wiki_character_detail takes a character_id (the entry_page_id from the list endpoint) and returns the full wiki page for that character. The modules array contains structured sections for attributes, ascension materials, talent descriptions, and gallery images. The filter_values field on the detail response mirrors the list endpoint, making it straightforward to cross-reference.
Community Posts and Search
get_community_posts accepts a gids integer (2 for Genshin Impact, 6 for Honkai: Star Rail, 8 for Zenless Zone Zero) and a type flag controlling whether you receive Hot (1), New (2), or Official (3) posts. Each post object in the response list contains a post block with title and body metadata, a user block, a stat block with view and like counts, topics, and an image_list. Pagination uses a cursor pattern: pass the last_id value from one response as the input to the next call.
search_posts lets you query posts by keyword within a specific game's forum. Results use a different pagination key — next_offset rather than last_id — so check is_last to know when you've exhausted the result set. get_user_profile accepts any public HoYoLAB uid and returns user_info containing nickname, avatar_url, achievement stats, and community settings.
- Build a character comparison tool using ascension materials and filter values from
get_wiki_character_detail - Aggregate community sentiment around new game patches by searching posts with relevant keywords via
search_posts - Display a player's public profile card including nickname and achievement stats using
get_user_profile - Monitor official announcements for Genshin Impact by polling
get_community_postswithtype=3 - Populate a game database with character rosters, icons, and rarity data from
get_wiki_character_listfor all three supported games - Track trending community discussions in Honkai: Star Rail by fetching Hot posts (
type=1) withgids=6 - Build a talent reference sheet by extracting the
modulesarray fromget_wiki_character_detail
| 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 HoYoLAB have an official developer API?+
How does pagination work across the different endpoints?+
get_wiki_character_list uses numeric page_num and page_size parameters. get_community_posts uses a cursor: take the last_id from the previous response and pass it as the last_id input on the next call. search_posts uses a separate next_offset integer field from the response — not last_id — for its pagination cursor. Check is_last on both post endpoints to detect the final page.Does `get_wiki_character_detail` return skill damage multipliers or stat scaling tables?+
modules array as structured sections reflecting the HoYoWiki page, which includes talent descriptions and ascension material lists. Numeric damage multiplier tables depend on how HoYoWiki structures that content per character and are not guaranteed as a distinct parsed field. You can fork this API on Parse and revise it to extract or reshape specific module sections if the default structure doesn't match your needs.Is in-game data like spiral abyss records or real-time stamina available?+
What does `retcode` indicate in responses?+
retcode integer alongside a message string. A retcode of 0 means the request succeeded. Non-zero values indicate an error condition — for example, an invalid UID passed to get_user_profile or an unrecognized character_id passed to get_wiki_character_detail. Always check retcode before consuming the data object.