HearthstoneJSON is a Hearthstone data service provided by the HearthSim project. Its core function is to automatically convert game files into UTF-8 JSON and publish them by build and locale. Its API endpoint is api.hearthstonejson.com/v1/, and /v1/latest/ returns a 302 redirect to the latest version. It is more of a foundational data layer for Hearthstone community developers than a general-purpose developer platform.
Functionally, it provides both the full cards.json dataset and cards.collectible.json for collectible cards only. Fields include id, dbfId, name, text, class, cost, attack, health, rarity, mechanics, playRequirements, entourage, and more. Its image API is also fairly complete, covering original PNGs, 256/512 JPG or WebP images, deck thumbnails/tiles, and multilingual pre-rendered card images. The API is not tied to any language or framework, so any project that can consume JSON and image URLs can integrate with it. The documentation also links to the python-hearthstone enums and the Sunwell Canvas rendering library.
No paid plans are shown in the main documentation. The image API is described as free to use with no explicit limits, but users are asked not to hotlink images directly on high-traffic websites and are advised to rehost them instead. Commercial use requires contacting HearthSim. Payment methods, enterprise support, SLA, rate-limiting policies, and authentication mechanisms are not specified.
Its strengths are a stable and clear data structure, sensible versioning and localization, and sufficient examples and field explanations. It is well suited for quickly building card databases, deck tools, reference sites, and analytics applications. The image resources cover art, tiles, and renders, reducing the need to parse Unity assets manually. The downsides are that its scope is very narrow and mainly serves the Hearthstone ecosystem; some fields have historically been renamed or deprecated, so callers need to monitor the changelog; and high-traffic image usage requires self-hosted caching or mirroring.
It is suitable for Hearthstone community sites, data analysts, bots, and developers building deck construction tools. It is not a good fit for teams that need a general-purpose game database, a strong SLA, or commercial contract guarantees. The main documentation does not provide information on access from mainland China, so domain availability, network stability, and commercial payment options are unknown. If access is unstable, users can consider self-hosting an hs-data mirror, caching images, or evaluating alternatives such as Blizzard’s official Hearthstone API.
⚠ This review is compiled from public sources and does not constitute a purchase recommendation. Verify all facts on the vendor's official site. Verify on hearthstonejson.com official site.
hearthstonejson.com is an Unknown Dev Tools provider. TG4G tracks its product information, an overall rating of 7.0/10, and a China-accessibility score of China direct-connect friendly. Click "Visit Official Site" to reach hearthstonejson.com directly.