Games client

The GamesClient is the client used to access the games endpoint of the Giant Bomb API.

GamesClient has two external methods. search offers a full API to the endpoint, allowing you to specify all fields, filters and return parameters. There is also a quick_search that allows you to search just using a game title and, optionally, the platform.

search

Here is an example showing the full usage of the search method:

import pybomb

my_key = your_giant_bomb_api_key
games_client = pybomb.GamesClient(my_key)

return_fields = ('id', 'name', 'platforms')
limit = 10
offset = 5
sort_by = 'name'
filter_by = {'platforms': pybomb.PS3}

response = games_client.search(
  filter_by=filter_by,
  return_fields=return_fields,
  sort_by=sort_by,
  desc=True,
  limit=limit,
  offset=offset
)

print response.results
print response.uri
print response.num_page_results
print response.num_total_results

quick_search

Here is an example showing the full usage of the quick_search method:

import pybomb

my_key = your_giant_bomb_api_key
games_client = pybomb.GamesClient(my_key)

response = games_client.quick_search(
  name='call of duty',
  platform=pybomb.PS3,
  sort_by='original_release_date',
  desc=True
)

print response.results
print response.uri
print response.num_page_results
print response.num_total_results