Skip to content

sok.apis.games.rawg_api

RAWG API implementation.

API Documentation: https://rawg.io/apidocs Note: Free API with rate limits (requires API key for higher limits).

RAWGApi

class RAWGApi(api_key: str = '')

Bases: BaseAPI

RAWG Video Games Database API implementation.

Provides access to 500,000+ games with detailed information including platforms, genres, developers, and user ratings.

Initialize RAWG API.

Parameters

NameTypeDefaultDescription
api_keystr''RAWG API key (optional for basic usage).
Source

supported_content_typesproperty

List[ContentType]

Return supported content types.

supported_media_typesproperty

List[MediaType]

Return supported media types.

get_detailsasync

async def get_details(
item_id: str,
content_type: ContentType,
**kwargs,
) -> Dict[str, Any]:

Get detailed game information from RAWG.

Parameters

NameTypeDescription
item_idstrRAWG game ID.
content_typeContentTypeContent type (only GAME supported).
**kwargsAdditional parameters.

Returns

  • Dict[str, Any]Dictionary with game metadata.
Source
async def get_related_items(
item_id: str,
content_type: ContentType,
**kwargs,
) -> List[Dict[str, Any]]:

RAWG does not support related items retrieval.

Parameters

NameTypeDescription
item_idstr
content_typeContentType
Source
async def search(
query: str,
content_type: ContentType,
**kwargs,
) -> Dict[str, Any]:

Search for games on RAWG.

Parameters

NameTypeDescription
querystrSearch query string.
content_typeContentTypeContent type (only GAME supported).
**kwargsAdditional parameters including 'max_results'.

Returns

  • Dict[str, Any]Dictionary with 'results' list of matching games.
Source

Functions

clean_title

def clean_title(
name: Optional[str],
platforms: Iterable[Optional[str]] = (),
released: Optional[str] = None,
) -> Optional[str]:

Remove a console name or the release year at the end of a RAWG title.

Only a short console name, one of the game's own platforms or its release year is removed, so a real subtitle in parentheses is kept.

Parameters

NameTypeDefaultDescription
nameOptional[str]The title as RAWG gives it.
platformsIterable[Optional[str]]()Platform names of the game.
releasedOptional[str]NoneRelease date of the game, as "YYYY-MM-DD".

Returns

  • Optional[str]The title without them: "Pokemon: Emerald Version (GBA)" gives
  • Optional[str]"Pokemon: Emerald Version", and "DOOM (2016)" released in 2016
  • Optional[str]gives "DOOM".
Source

Attributes

NameValue
PLATFORM_TAGSset('3ds dc ds gb gba gbc gc gcn genesis gg md n64 nds nes ngc pc ps ps1 ps2 ps3 ps4 ps5 psp psv psx saturn sms snes switch vita wii wiiu x360 xb1 xbox'.split()) | {'wii u', 'xbox 360', 'xbox one'}
Built with Kiln