python-steamgriddb 1.0.3

A Python wrapper for SteamGridDB's API

python-steamgriddb

A Python API wrapper for SteamGridDB.com

Installation

pip istall 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

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

Some grid object methods:

# Do some interactions (upvote, downvote, like)
grid.upvote()
grid.downvote()
grid.like()

# Returning the grid as JSONObject
grid.to_json()

Upload a grid:

from steamgrid import StyleType

# Upload an image to the website as Grid with Alternate style
sgdb.upload_grid(game_id=1234, image_path='path/of/image.png', style=StyleType.Alternate)

Delete a grid

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

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

Donate address:

BTC: bc1q8ngvcph2mwtlza8w452dxcjc08wgqa0pdnmndz