/rawg

🎮 Async API wrapper for RAWG.io

Primary LanguagePython

rawg

PyPI

API wrapper for RAWG.io

This Python package is generated by the OpenAPI Generator project.

Latest update: November 2022

Installation & Usage

pip install

Install via PyPI:

pip install rawg

Getting Started

Example

import asyncio

import rawg


async def requests():
    async with rawg.ApiClient(rawg.Configuration(api_key={'key': 'YOUR_API_KEY'})) as api_client:
        # Create an instance of the API class
        api = rawg.GamesApi(api_client)

        # Making requests
        coros = [api.games_read(id=name) for name in ['grand-theft-auto-v', 'minecraft']]

        # Waiting for requests
        for coro in asyncio.as_completed(coros):
            game: rawg.GameSingle = await coro
            print('——————————————————————————————————————————————')
            print('        Name |', game.name)
            print('    Released |', game.released)
            print('      Rating |', game.rating)
            print('Achievements |', game.achievements_count)
            print('     Website |', game.website)
            print('  Metacritic |', game.metacritic)
            print('——————————————————————————————————————————————')
            print()


if __name__ == '__main__':
    asyncio.get_event_loop().run_until_complete(requests())

Output

——————————————————————————————————————————————
        Name | Grand Theft Auto V
    Released | 2013-09-17
      Rating | 4.47
Achievements | 539
     Website | http://www.rockstargames.com/V/
  Metacritic | 91
——————————————————————————————————————————————
        Name | Minecraft
    Released | 2009-05-10
      Rating | 4.42
Achievements | 744
     Website | https://classic.minecraft.net/
  Metacritic | 83
——————————————————————————————————————————————

API Docs and API Key

Link: https://rawg.io/apidocs

Another libraries

R: rabiibouhestine/Rawg

Python: laundmo/rawgpy

Node.js: orels1/rawger

Contact

Generated README below

The largest open video games database.

Why build on RAWG

  • More than 350,000 games for 50 platforms including mobiles.
  • Rich metadata: tags, genres, developers, publishers, individual creators, official websites, release dates, Metacritic ratings.
  • Where to buy: links to digital distribution services
  • Similar games based on visual similarity.
  • Player activity data: Steam average playtime and RAWG player counts and ratings.
  • Actively developing and constantly getting better by user contribution and our algorithms.

Terms of Use

  • Free for personal use as long as you attribute RAWG as the source of the data and/or images and add an active hyperlink from every page where the data of RAWG is used.
  • Free for commercial use for startups and hobby projects with not more than 100,000 monthly active users or 500,000 page views per month. If your project is larger than that, email us at api@rawg.io for commercial terms.
  • No cloning. It would not be cool if you used our API to launch a clone of RAWG. We know it is not always easy to say what is a duplicate and what isn't. Drop us a line at api@rawg.io if you are in doubt, and we will talk it through.
  • You must include an API key with every request. The key can be obtained at https://rawg.io/apidocs. If you don’t provide it, we may ban your requests.

Read more.

This Python package is automatically generated by the OpenAPI Generator project:

  • API version: v1.0
  • Package version: 1.2.0
  • Build package: org.openapitools.codegen.languages.PythonLegacyClientCodegen

Requirements.

Python 2.7 and 3.4+

Installation & Usage

pip install

If the python package is hosted on a repository, you can install directly using:

pip install git+https://github.com/uburuntu/rawg.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/uburuntu/rawg.git)

Then import the package:

import rawg

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import rawg

Getting Started

Please follow the installation procedure and then run the following:

from __future__ import print_function

import time
import rawg
from rawg.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://api.rawg.io/api
# See configuration.py for a list of all supported configuration parameters.
configuration = rawg.Configuration(
    host = "https://api.rawg.io/api"
)



# Enter a context with an instance of the API client
with rawg.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = rawg.CreatorRolesApi(api_client)
    page = 56 # int | A page number within the paginated result set. (optional)
page_size = 56 # int | Number of results to return per page. (optional)

    try:
        # Get a list of creator positions (jobs).
        api_response = api_instance.creator_roles_list(page=page, page_size=page_size)
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling CreatorRolesApi->creator_roles_list: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://api.rawg.io/api

Class Method HTTP request Description
CreatorRolesApi creator_roles_list GET /creator-roles Get a list of creator positions (jobs).
CreatorsApi creators_list GET /creators Get a list of game creators.
CreatorsApi creators_read GET /creators/{id} Get details of the creator.
DevelopersApi developers_list GET /developers Get a list of game developers.
DevelopersApi developers_read GET /developers/{id} Get details of the developer.
GamesApi games_achievements_read GET /games/{id}/achievements Get a list of game achievements.
GamesApi games_additions_list GET /games/{game_pk}/additions Get a list of DLC's for the game, GOTY and other editions, companion apps, etc.
GamesApi games_development_team_list GET /games/{game_pk}/development-team Get a list of individual creators that were part of the development team.
GamesApi games_game_series_list GET /games/{game_pk}/game-series Get a list of games that are part of the same series.
GamesApi games_list GET /games Get a list of games.
GamesApi games_movies_read GET /games/{id}/movies Get a list of game trailers.
GamesApi games_parent_games_list GET /games/{game_pk}/parent-games Get a list of parent games for DLC's and editions.
GamesApi games_read GET /games/{id} Get details of the game.
GamesApi games_reddit_read GET /games/{id}/reddit Get a list of most recent posts from the game's subreddit.
GamesApi games_screenshots_list GET /games/{game_pk}/screenshots Get screenshots for the game.
GamesApi games_stores_list GET /games/{game_pk}/stores Get links to the stores that sell the game.
GamesApi games_suggested_read GET /games/{id}/suggested Get a list of visually similar games, available only for business and enterprise API users.
GamesApi games_twitch_read GET /games/{id}/twitch Get streams on Twitch associated with the game, available only for business and enterprise API users.
GamesApi games_youtube_read GET /games/{id}/youtube Get videos from YouTube associated with the game, available only for business and enterprise API users.
GenresApi genres_list GET /genres Get a list of video game genres.
GenresApi genres_read GET /genres/{id} Get details of the genre.
PlatformsApi platforms_list GET /platforms Get a list of video game platforms.
PlatformsApi platforms_lists_parents_list GET /platforms/lists/parents Get a list of parent platforms.
PlatformsApi platforms_read GET /platforms/{id} Get details of the platform.
PublishersApi publishers_list GET /publishers Get a list of video game publishers.
PublishersApi publishers_read GET /publishers/{id} Get details of the publisher.
StoresApi stores_list GET /stores Get a list of video game storefronts.
StoresApi stores_read GET /stores/{id} Get details of the store.
TagsApi tags_list GET /tags Get a list of tags.
TagsApi tags_read GET /tags/{id} Get details of the tag.

Documentation For Models