A community driven API for Helldivers 2

★ 299⑂ 36👁 9⑃ 87● 77▤ 21
C#MITCreated 2024-02-27helldivers-2.github.io/api/
下载:Fix dispatch newsfeed paginationFix-4.7.1 ↓4.7.12026-09-09
+0
日增长
299
stars
36
forks
9
watchers
87
prs
77
issues
21
releases

README

helldivers-2/api

The helldivers-2/api project is a community API around the popular video game
Helldivers 2 by ArrowHead studios.
It provides (most) information you can also find in-game in a neat JSON format so you can build awesome applications
(see Community below).

Important to note is that this is not an officially endorsed API and is in no way affiliated with ArrowHead studios,
but rather a community driven effort to provide the information of Helldivers 2 to it's community.

 Getting started
The API does not require authentication (unless you'd like higher rate limits than the default, see rate limits),
so all you need to do is call it's publicly available endpoints.

We provide an OpenAPI specification of the community API as well as
a SwaggerUI (which visualizes the OpenAPI document). We also provide an
OpenAPI of the official ArrowHead studio's API we use
internally, however we strongly encourage you to use the /raw endpoints of the community wrapper instead of accessing
the ArrowHead API directly, as it puts additional load on their servers (besides, we have shinier endpoints, I swear!).

The root URL of the API is available here: https://api.helldivers2.dev
 [!WARNING]
 The root domain of the API recently changed, it's recommended you use the domain above to avoid problems in the future

We ask that you send along a X-Super-Client header with the name of your application / domain
(e.g. X-Super-Client: api.helldivers2.dev) and optionally a X-Super-Contact with some form of contact if your site
does not link to any form of contact information we can find. We use this information in case we need to notify our users
of important changes to the API that may cause disruption of service or when additional restrictions would be imposed
on your app (to prevent abuse, unintentional or otherwise).

 [!IMPORTANT]
 While adding X-Super-Client and X-Super-Contact is currently not required, the X-Super-Client header will
 be made obligatory in the future, causing clients who don't send it to fail. For more information see 94

 Rate limits
Currently the rate limit is set at 5 requests/10 seconds.
This limit will probably be increased in the future, and is used during the transition to our new version.

To avoid hitting rate limits in your clients check the following headers in your response:
- X-Ratelimit-Limit contains the total amount of requests you can make in the given timeframe
- X-RateLimit-Remaining how many requests you can still make in the current window
- Retry-After only added to 429 requests, the amount of seconds to wait before making a new request

 Contributing
make sure to check out our contribution guidelines for more detailed information on how to
help us contributing!

 Community
Check out some awesome projects made by our community!
- sebsebmc/helldivers-history
  Dashboard and graphs made by git scraping the community made API 
- stonemercy/galactic-wide-web
  The Galactic Wide Web - a discord bot
- helldivers-2/api-wrapper
 

Top issues

Discussions

Latest release

Fix dispatch newsfeed pagination v4.7.1 2026-09-09
What's Changed
 fix: page through ArrowHead newsfeed instead of a fixed 1024-entry window by @dealloc in https://github.com/helldivers-2/api/pull/172


Full Changelog: https://github.com/helldivers-2/api/compare/v4.7.0...v4.7.1

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON