Skip to main content

A package that helps extract Steam store and community market data as pandas DataFrame for better readabilty and usability.

Project description

PyPI License: MIT Repo Size GitHub follow

steamcrawl

This is still a work in progress. Some functionality are available but not quite fully tested. The final version will be release as v1.0.0.

A package that helps extract Steam store and community market data as pandas DataFrame for better readability and usability. The package mainly makes queries to different Steam API, clean and extract the important variables from the JSON object result and return a pandas Dataframe.

With the Steam request limit, you can make 200 requests every 5 minutes. If you exceed the limit, Steam can give you a cooldown of (possibly) a few 1,2 minutes to 6 hours (depending on the API). Please make an appropriate number of requests at a given time. It is recommended to close any Steam web and application to limit the requests you are sending.

Installation and setup

The following libraries are used in the package. Thus, the requirement of their installation must be met:

  • pandas==1.5.1
  • requests==2.29.0
  • selenium-wire==5.1.0

You can download the package from PyPI using pip:

pip install steamcrawl

Before starting, you need to obtain the value of the cookie steamLoginSecure. This can be done by opening DevTools (Ctrl + Shift + I) on steamcommunity.com, Application (on the task bar), Cookies:

The package requires this value to be passed in order to return the data using the information related to you (for example currency). Please be aware that it is absolutely safe to put your steamLoginSecure into the program. The package does not attempt to record/send to another source any of your information; even with your steamLoginSecure value, there is nothing valuable another user can extract (for e.g make trades, credit card info, etc.) because Steam does not allow any important decisions being made throughout the API.

Documentation

The documentation is available at the GitHub Wiki.

Example

Initialize the Request class with your steamLoginSecure as string:

from steamcrawl import Request
import pandas as pd

request = Request('your steamLoginSecure here')

Get your market trade history:

data_frame = request.get_market_history(count = 10)
data_frame.to_csv('example.csv')

The obtained result is (this is only part of the result):

example1

Get buy/sell orders of an item:

data_frame = get_buysell_orders(item_name = "USP-S | Printstream (Field-Tested)", appid="730")
# appid 730 indicates Counter-Strike: Global Offensive game. 
# Obtain the appid for a game using get_all_appid().
data_frame.to_csv('example.csv')

The obtained result is (this is again only part of the result).

example2ources/example2.png)

A small note is, please do not be alerted by the popping up browser for this request, this is only the behavior of the seleniumwire package used for this function.

Contributions:

This project is created and managed by only one user Hungreeee. Therefore, errors are entirely possible to occur anywhere in the program. If you found any bug you would like to report, please open a new Issue.

If you would like to suggest changes to current features or new features implementation, please also open a new Issue and I will check it out as soon as I can.

Legal

This project is in no way affiliated with, authorized, maintained, sponsored or endorsed by Valve or any of its affiliates or subsidiaries. This is an independent and unofficial project created by Hungreeee. Use it at your own risk.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

steamcrawl-0.1.9.tar.gz (10.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

steamcrawl-0.1.9-py3-none-any.whl (8.8 kB view details)

Uploaded Python 3

File details

Details for the file steamcrawl-0.1.9.tar.gz.

File metadata

  • Download URL: steamcrawl-0.1.9.tar.gz
  • Upload date:
  • Size: 10.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.4

File hashes

Hashes for steamcrawl-0.1.9.tar.gz
Algorithm Hash digest
SHA256 e4c767de3d729ed0e85534eea3c85778434f759298046d2c2621d41e10e7480e
MD5 9d291a593ade6c4e592920440676c68d
BLAKE2b-256 a66456c4dc03b237589fe7c8312f166982171be65258bad3c47435565a8ad077

See more details on using hashes here.

File details

Details for the file steamcrawl-0.1.9-py3-none-any.whl.

File metadata

  • Download URL: steamcrawl-0.1.9-py3-none-any.whl
  • Upload date:
  • Size: 8.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.4

File hashes

Hashes for steamcrawl-0.1.9-py3-none-any.whl
Algorithm Hash digest
SHA256 b5cb616c5e594c68b55a6d54afdd63dc4e14e4b456665294280de7a55eed3f76
MD5 370771e140138096ec44c3a4a779dcda
BLAKE2b-256 b98b23c280b623488c30516bad9babd2df3524b672ddbe1a70f5f61ef235ba8e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page