Skip to content

Steam Stats API

Retrieves Steam User Stats using Steam Web API

logger = logging.getLogger(__name__) module-attribute

REQUEST_TIMEOUT = (25, 30) module-attribute

MAX_RETRIES = 5 module-attribute

PLAYER_SUMMARIES = 'https://api.steampowered.com/ISteamUser/GetPlayerSummaries/v0002/' module-attribute

RECENTLY_PLAYED_GAMES = 'https://api.steampowered.com/IPlayerService/GetRecentlyPlayedGames/v0001/' module-attribute

get_player_summaries()

Get Player Summaries from Steam for basic profile info for a list of 64-bit Steam IDs

Source code in api/steam_stats.py 
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
def get_player_summaries():
    """Get Player Summaries from Steam for basic profile info for a list of 64-bit Steam IDs"""
    creds = get_steam_credentials()
    steam_id = creds["steam_id"]
    api_key = creds["api_key"]

    url = f"{PLAYER_SUMMARIES}?key={api_key}&steamids={steam_id}"
    for _ in range(MAX_RETRIES):
        try:
            response = requests.get(url, timeout=REQUEST_TIMEOUT)
            if response.status_code == 429:
                retry_after = int(response.headers.get("Retry-After", 2))
                logger.warning("Rate limited. Sleeping for %s seconds", retry_after)
                time.sleep(retry_after)
                continue
            response.raise_for_status()
            return response.json()
        except requests.exceptions.HTTPError as err:
            logger.error("HTTP error: %s", err)
            return None
        except requests.exceptions.RequestException as err:
            logger.error("Request error: %s", err)
            return None
    logger.error("Max retries reached. Failed to fetch player summaries")
    return None

get_recently_played_games()

Fetch a list of games a player has played in the last two weeks

Source code in api/steam_stats.py 
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
def get_recently_played_games():
    """Fetch a list of games a player has played in the last two weeks"""
    creds = get_steam_credentials()
    steam_id = creds["steam_id"]
    api_key = creds["api_key"]

    url = f"{RECENTLY_PLAYED_GAMES}?key={api_key}&steamid={steam_id}&format=json"
    try:
        response = requests.get(url, timeout=REQUEST_TIMEOUT)
        response.raise_for_status()
        data = response.json()
        if data["response"].get("total_count", 0) == 0:
            return None
        return data
    except requests.exceptions.HTTPError as err:
        logger.error("HTTP error occurred: %s", err)
        return None
    except requests.exceptions.RequestException as err:
        logger.error("An error occurred: %s", err)
        return None

Source Code

View the complete source code for this module on GitHub: api/steam_stats.py