Game stat API
With Talo, you can track game stats on a per-player basis. For example, you could track the number of secrets discovered by a player or the amount of puzzles they've solved. Talo allows you to easily create and increment these kind of stats.
Learn more about game stats here.
Endpoints
Get all game stats
GET https://api.trytalo.com/v1/game-statsHeaders
None available
Route params
None available
Query keys
None available
Sample response
{ ... }
Get the current values of all the player's stats
GET https://api.trytalo.com/v1/game-stats/player-statsHeaders
| Key | Required | Description |
|---|---|---|
x-talo-alias | ✅ Yes |
Route params
None available
Query keys
None available
Sample response
{ ... }
Get an individual game stat
GET https://api.trytalo.com/v1/game-stats/:internalNameHeaders
None available
Route params
| Key | Required | Description |
|---|---|---|
internalName | ✅ Yes | The internal name of the stat |
Query keys
None available
Sample response
{ ... }
Get the current value of a player's stat
GET https://api.trytalo.com/v1/game-stats/:internalName/player-statHeaders
| Key | Required | Description |
|---|---|---|
x-talo-alias | ✅ Yes |
Route params
| Key | Required | Description |
|---|---|---|
internalName | ✅ Yes | The internal name of the stat |
Query keys
None available
Sample response
{ ... }
Get a history of changes to a player stat
GET https://api.trytalo.com/v1/game-stats/:internalName/historyHeaders
| Key | Required | Description |
|---|---|---|
x-talo-player | ✅ Yes | The ID of the player |
Route params
| Key | Required | Description |
|---|---|---|
internalName | ✅ Yes | The internal name of the stat |
Query keys
| Key | Required | Description |
|---|---|---|
endDate | ❌ No | A UTC Date (YYYY-MM-DD), DateTime (ISO 8601) or millisecond timestamp |
page | ❌ No | The current pagination index (starting at 0) |
startDate | ❌ No | A UTC Date (YYYY-MM-DD), DateTime (ISO 8601) or millisecond timestamp |
Sample response
{ ... }
Sample request with filtering
{ ... }
Get a history of changes to a global stat
GET https://api.trytalo.com/v1/game-stats/:internalName/global-historyHeaders
None available
Route params
| Key | Required | Description |
|---|---|---|
internalName | ✅ Yes | The internal name of the stat |
Query keys
| Key | Required | Description |
|---|---|---|
endDate | ❌ No | A UTC Date (YYYY-MM-DD), DateTime (ISO 8601) or millisecond timestamp |
page | ❌ No | The current pagination index (starting at 0) |
playerId | ❌ No | A player ID to use when filtering snapshots |
startDate | ❌ No | A UTC Date (YYYY-MM-DD), DateTime (ISO 8601) or millisecond timestamp |
Sample response
{ ... }
Sample request with filtering
{ ... }
Update a stat value
PUT https://api.trytalo.com/v1/game-stats/:internalNameSample request
{ ... }
Sample response
{ ... }