A Python wrapper for SteamGridDB's API
Project description
python-steamgriddb
A Python API wrapper for SteamGridDB.com
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
Donate address:
BTC: bc1q8ngvcph2mwtlza8w452dxcjc08wgqa0pdnmndz
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.