# Gaming Stats API

Version: 3.8.3

## Providers

Aggregate: /aggregate - canonical games, safely deduplicated playtime, and concurrent now-playing sessions assembled from cached providers.
Valorant: /custom/valorant - cached Riot-player stats. /valorant remains a compatibility alias.
PSN: /psn - cached played history, trophy summary, presence and game trophies. Requires operator configuration.
Steam: /steam - cached profile, API-visible library and catalog facts, recent playtime, badges/XP, achievements, rarity, title stats and current players. Requires operator configuration.
Epic: /epic - cached claimed PC base games, catalog artwork and Epic-reported playtime. Requires an owner connection.
Playnite: /playnite - cached local/launcher library, artwork, tracked playtime, and expiring now-playing presence from the Windows extension.

## Documentation

[Aggregate guide](/aggregate/docs)
[Aggregate machine-readable guide](/aggregate/llms.txt)
[Valorant guide](/custom/valorant/docs)
[Valorant machine-readable guide](/custom/valorant/llms.txt)
[PSN guide](/psn/docs)
[PSN machine-readable guide](/psn/llms.txt)
[Steam guide](/steam/docs)
[Steam machine-readable guide](/steam/llms.txt)
[Epic guide](/epic/docs)
[Epic machine-readable guide](/epic/llms.txt)
[Playnite guide](/playnite/docs)
[Playnite machine-readable guide](/playnite/llms.txt)
[Aggregate implementation guide](https://github.com/AniketRaj314/gaming-stats-api/blob/main/docs/aggregate.md)
[Frontend aggregate handoff](https://github.com/AniketRaj314/gaming-stats-api/blob/main/docs/frontend-aggregate-handoff.md)
[Provider data coverage policy](https://github.com/AniketRaj314/gaming-stats-api/blob/main/docs/data-coverage.md)
[PSN setup and recovery](https://github.com/AniketRaj314/gaming-stats-api/blob/main/docs/psn.md)
[Steam setup and operations](https://github.com/AniketRaj314/gaming-stats-api/blob/main/docs/steam.md)
[Epic setup and operations](https://github.com/AniketRaj314/gaming-stats-api/blob/main/docs/epic.md)
[Playnite setup](https://github.com/AniketRaj314/gaming-stats-api/blob/main/docs/playnite.md)

## Access

GET /health is public and reports the running release. Documentation is public. Aggregate, Valorant, PSN, Steam, Epic, and Playnite data require X-API-Key from a server-side consumer. The Playnite Windows extension has a separate upload-only key. Requests serve stored snapshots; refresh jobs run independently. See each provider guide for schemas and availability.