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
| Name | Type | Default | Description |
|---|---|---|---|
api_key | str | '' | RAWG API key (optional for basic usage). |
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
| Name | Type | Description |
|---|---|---|
item_id | str | RAWG game ID. |
content_type | ContentType | Content type (only GAME supported). |
**kwargs | Additional parameters. |
Returns
Dict[str, Any]Dictionary with game metadata.
get_related_itemsasync
async def get_related_items( item_id: str, content_type: ContentType, **kwargs,) -> List[Dict[str, Any]]:RAWG does not support related items retrieval.
Parameters
| Name | Type | Description |
|---|---|---|
item_id | str | |
content_type | ContentType |
searchasync
async def search( query: str, content_type: ContentType, **kwargs,) -> Dict[str, Any]:Search for games on RAWG.
Parameters
| Name | Type | Description |
|---|---|---|
query | str | Search query string. |
content_type | ContentType | Content type (only GAME supported). |
**kwargs | Additional parameters including 'max_results'. |
Returns
Dict[str, Any]Dictionary with 'results' list of matching games.
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
| Name | Type | Default | Description |
|---|---|---|---|
name | Optional[str] | The title as RAWG gives it. | |
platforms | Iterable[Optional[str]] | () | Platform names of the game. |
released | Optional[str] | None | Release date of the game, as "YYYY-MM-DD". |
Returns
Optional[str]The title without them: "Pokemon: Emerald Version (GBA)" givesOptional[str]"Pokemon: Emerald Version", and "DOOM (2016)" released in 2016Optional[str]gives "DOOM".
Attributes
| Name | Value |
|---|---|
PLATFORM_TAGS | set('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'} |