Important Note

Recently there has been an update to the Steam site, which is where this script scrapes its information from. This update has made it so you cannot access other profile's games / achievements without logging in. This means the script WILL NOT be able to scrape game data, playtime or achievement progress for now. I may update the script in the future to fix this issue, however I understand most people wouldn't be okay with logging into their account through a random Python script on the internet; so I will try to find a workaround.

As of the 7th of August 2023, the script can still scrape: Awards, General Info, Friends, Badges and groups. As soon as I figure out a workaround to these issues, I will update the script.

Thanks for your understanding, and I hope the script can still be a useful tool to you.

steam-detective

A Python script that allows you to get information on a profile, saved in JSON format.

What it does

It started with me wanting to create a script that would get all of my game titles and time played from Steam to put in a database, I then realised Steam offers no way to do this; so I created this script to do it for me. As you can see the script has evolved past that now, so what happened? Honestly, I just got into it and wanted to keep going.

Now we have the script that is here on GitHub.

Okay so what does it actually do?

The script allows you to give a Steam ID for any profile, it then scrapes public information and dumps all of that stuff as a JSON file for easy parsing.

It gathers:

1. General information, an overview of the profile.
2. A list of every game, their title and the hours they have played for.
3. The total ammount of time they have spent playing games on Steam, with your choice of minutes, hours, days or years.
4. All of the users friends, their Steam IDs, Profile URLs and current Steam alias.
5. A full list of their awards, the ones they have given and recieved.
6. Every badge the user has collected, plus the total amount of experience gained from the badges.
7. All groups they are a member of, the groups total member count, link to the group, the name of the group and if it is public.
8. Shows if the user has a VAC or game ban on their account, and if they do how long it has been; with your choice of minutes, hours, days or years.
9. Gets a list of all unlocked achievements on their account, plus an overview of the total amount of achievements they've unlocked.

Now it must be said that this isn't a magical tool. If the user has chosen not to show any of this information, the script will not bypass that to get information.

How to use it

Using the script is incredibly easy, but before you use it you need to do:

pip install requests_html

which is the web scraping module the script uses. Once that is done you can do:

python steam-detective.py [profiles_custom_steam_id] or python steam-detective.py --nocustom [profiles_steam_id]

For example python steam-detective.py eroticgaben would use the Custom Steam ID to show information about Gabe Newell's Steam Account.

but python steam-detective.py --nocustom 76561198085278322 would use the Non-Custom Steam ID, which also shows information about Gabe Newell's Steam Account.

Note: For the second option you MUST use the '--nocustom' flag or it won't work.

alternatively you can run the script without any arguments, python steam-detective.py if you want to use the menus.

Forking

If you want to fork my project, please go ahead. If you feel like you can add stuff, or even build on top of this to make something cool; please feel free to. You do not have to credit me, but can if you want to.