Skip to main content

python-steamgriddb

A Python API wrapper for SteamGridDB.com

PyPI APM

Installation

pip install python-steamgriddb

Getting Started

Get your API key:

You can generate an API key on your user preferences page.

Initialize the SteamGridDB using your API key to connect with API

from steamgrid import SteamGridDB

sgdb = SteamGridDB('AuthKey')

Search for a game:

# Search for Witcher game
result = sgdb.search_game('Witcher')

Get a game object without searching:

# Get a game using a Game ID
game = sgdb.get_game_by_gameid(1234)

# Get a game using Steam App ID
game = sgdb.get_game_by_steam_appid(567890)

# Returning the game as JSONObject
game.to_json()

Do something with a game object:

# Return the game name
game_name = game.name

# Return the game release date as datetime
game_release_date = game.release_date

Get Assets:

from steamgrid import StyleType, PlatformType, MimeType, ImageType

# Get grids list without filter
grids = sgdb.get_grids_by_gameid([1234])

# Get grids list by filter (Multiple filters are allowed)
grids = sgdb.get_grids_by_gameid(game_ids=[1234], styles=[StyleType.Alternate], mimes=[MimeType.PNG], types=[ImageType.Static], is_nsfw=True)

# Get list grids using platform
grids = sgdb.get_grids_by_platform(game_ids=[1234], platform=PlatformType.origin)

Do something with a grid object:

# Return object of grid's author
grid_author = grid.author

# Return grid's score
grid_score = grid.score

Some grid object methods:

# Return true if grid be nsfw
grid_is_nsfw = grid.is_nsfw()

# Returning the grid as JSONObject
grid.to_json()

Delete a grid

# Delete a grid with its object
grid.delete()

# Delete a grid with its ID
sgdb.delete_grid([230227])

Star History

Star History Chart

Donate address:

BTC: bc1q8ngvcph2mwtlza8w452dxcjc08wgqa0pdnmndz

Metadata

Release files for python-steamgriddb 1.0.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-steamgriddb 1.0.5
File Size Uploaded Provenance Actions
python-steamgriddb-1.0.5.tar.gz 8.4 kB Without provenance Details for python-steamgriddb-1.0.5.tar.gz

Release files / python-steamgriddb-1.0.5.tar.gz

Download URL python-steamgriddb-1.0.5.tar.gz
Size 8.4 kB
Tags Source
SHA-256 checksum
How to use checksums
036db7bb09865da73b40b68cf04fb9675cd18b4908275092d91f37bf16245069
BLAKE2b-256 checksum
How to use checksums
d690a84d927799ca177d4f7a111f99fee0a3f19da63e42c3b325c9c1bfe3bba0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.12

Security for python-steamgriddb 1.0.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page