Helldivers Stats

Helldivers Stats API Docs

API URL: https://api.helldiversstats.com

Endpoint: /1.0/getPlayerCount

Description

This endpoint allows you to retrieve the player count of both Helldivers games.

HTTP Method

GET

Parameters

N/A

Request Example:

/1.0/getPlayerCount

Response

{
"helldivers":
	{"Steam":567,"PS5":0,"HDTotalCount":567},
"helldivers2":
	{"Steam":213225,"PS5":0,"HD2TotalCount":213225},
"totalPlayerCount":
	{"Steam":213792,"PS5":0,"allGamesTotalPlayerCount":213792}
}
Status Codes
    200: OK - Request was successful.
    404: Not Found - Resource not found.

Endpoint: /1.0/getHistoricalPlayerCount

Description

This endpoint allows you to retrieve the historical player count of both Helldivers games. Data is stored every 10 minutes.

HTTP Method:

GET

Parameters

    gameName (optional): filter by gamename, leave blank for both.
    startDate (required): filter by start date YYYY-MM-DD. (Can filter by time as well ex: YYYY-MM-DD HH:MM:SS)
    endDate (required): filter by end date YYYY-MM-DD. (Can filter by time as well ex: YYYY-MM-DD HH:MM:SS)
    page (optional): filter by page number.

Request Example

/1.0/getHistoricalPlayerCount?&startDate=2024-01-01&endDate=2024-02-30

Response
{
{
  "historicalPlayerCount": [
	{
	  "id": 1,
	  "gameName": "Helldivers",
	  "steamPlayerCount": 558,
	  "PS5PlayerCount": 0,
	  "totalPlayerCount": 558,
	  "timestamp": "2024-02-24T07:30:00.000Z"
	},
	{
	  "id": 2,
	  "gameName": "Helldivers 2",
	  "steamPlayerCount": 292054,
	  "PS5PlayerCount": 0,
	  "totalPlayerCount": 292054,
	  "timestamp": "2024-02-24T07:30:00.000Z"
	},
	{
	  "id": 3,
	  "gameName": "Helldivers",
	  "steamPlayerCount": 567,
	  "PS5PlayerCount": 0,
	  "totalPlayerCount": 567,
	  "timestamp": "2024-02-24T08:00:00.000Z"
	},
	{
	  "id": 4,
	  "gameName": "Helldivers 2",
	  "steamPlayerCount": 265301,
	  "PS5PlayerCount": 0,
	  "totalPlayerCount": 265301,
	  "timestamp": "2024-02-24T08:00:00.000Z"
	},
	{
	  "id": 5,
	  "gameName": "Helldivers",
	  "steamPlayerCount": 542,
	  "PS5PlayerCount": 0,
	  "totalPlayerCount": 542,
	  "timestamp": "2024-02-24T08:30:00.000Z"
	},
	{
	  "id": 6,
	  "gameName": "Helldivers 2",
	  "steamPlayerCount": 235737,
	  "PS5PlayerCount": 0,
	  "totalPlayerCount": 235737,
	  "timestamp": "2024-02-24T08:30:00.000Z"
	},
	{
	  "id": 7,
	  "gameName": "Helldivers",
	  "steamPlayerCount": 567,
	  "PS5PlayerCount": 0,
	  "totalPlayerCount": 567,
	  "timestamp": "2024-02-24T09:00:00.000Z"
	},
	{
	  "id": 8,
	  "gameName": "Helldivers 2",
	  "steamPlayerCount": 213225,
	  "PS5PlayerCount": 0,
	  "totalPlayerCount": 213225,
	  "timestamp": "2024-02-24T09:00:00.000Z"
	}
  ],
  "totalResults": 8,
  "totalPages": 1,
  "currentPage": 1
}
}
Status Codes
    200: OK - Request was successful.
    400: Bad Request - Invalid parameters.
    404: Not Found - User not found.

Endpoint: /1.0/getListOfFactions

Description

This endpoint allows you to retrieve the list of factions for Helldivers 2.

HTTP Method

GET

Parameters

N/A

Request Example:

/1.0/getListOfFactions

Response

[
  {
    "id": 1,
    "warID": 801,
    "factionID": 1,
    "factionName": "Humans"
  },
  {
    "id": 2,
    "warID": 801,
    "factionID": 2,
    "factionName": "Terminids"
  },
  {
    "id": 3,
    "warID": 801,
    "factionID": 3,
    "factionName": "Automaton"
  }
]
Status Codes
    200: OK - Request was successful.
    404: Not Found - Resource not found.

Endpoint: /1.0/getListOfPlanets

Description

This endpoint allows you to retrieve the list of planets for Helldivers 2.

HTTP Method

GET

Parameters

N/A

Request Example:

/1.0/getListOfPlanets

Response

[
  {
    "id": 1,
    "warID": 801,
    "planetID": 0,
    "planetName": "Super Earth"
  },
  {
    "id": 2,
    "warID": 801,
    "planetID": 1,
    "planetName": "Klen Dahth II"
  },
  {
    "id": 3,
    "warID": 801,
    "planetID": 2,
    "planetName": "Pathfinder V"
  },
  {
    "id": 4,
    "warID": 801,
    "planetID": 3,
    "planetName": "Widow's Harbor"
  }
  ...
]
Status Codes
    200: OK - Request was successful.
    404: Not Found - Resource not found.

Endpoint: /1.0/getListOfSectors

Description

This endpoint allows you to retrieve the list of planets for Helldivers 2.

HTTP Method

GET

Parameters

N/A

Request Example:

/1.0/getListOfSectors

Response

[
  {
    "id": 1,
    "warID": 801,
    "sectorID": 0,
    "sectorName": "Sol"
  },
  {
    "id": 2,
    "warID": 801,
    "sectorID": 1,
    "sectorName": "Altus"
  },
  {
    "id": 3,
    "warID": 801,
    "sectorID": 2,
    "sectorName": "Barnard"
  },
  {
    "id": 4,
    "warID": 801,
    "sectorID": 3,
    "sectorName": "Cancri"
  },
  {
    "id": 5,
    "warID": 801,
    "sectorID": 4,
    "sectorName": "Gothmar"
  },
  {
    "id": 6,
    "warID": 801,
    "sectorID": 5,
    "sectorName": "Cantolus"
  }
]
Status Codes
    200: OK - Request was successful.
    404: Not Found - Resource not found.

Endpoint: /1.0/getWarInfo/:warID?:planetID

Description

This endpoint allows you to retrieve the list of planets for Helldivers 2.

HTTP Method

GET

Parameters

    :warID (optional): filter by war id.
    :planetID (optional): filter by index id/planet id.

Request Example:

/1.0/getWarInfo

Response

[
  {
    "indexID": 0,
    "planetName": "Super Earth",
    "sectorID": 0,
    "sectorName": "Sol",
    "settingsHash": 897386910,
    "position_x": 0,
    "position_y": 0,
    "waypoints": "[1]",
    "sector": 0,
    "maxHealth": 1000000,
    "disabled": 0,
    "initialOwner": 1
  },
  {
    "indexID": 1,
    "planetName": "Klen Dahth II",
    "sectorID": 1,
    "sectorName": "Altus",
    "settingsHash": 2147483647,
    "position_x": 0.0537304,
    "position_y": 0.105655,
    "waypoints": "[2]",
    "sector": 1,
    "maxHealth": 1000000,
    "disabled": 0,
    "initialOwner": 1
  }
  ...
]
Status Codes
    200: OK - Request was successful.
    404: Not Found - Resource not found.