Responses
status_code | An integer indicating the result of the request. Acceptable values are:
|
error | A text string representing the status_code |
number_of_total_results | The number of total results matching the filter conditions specified |
number_of_page_results | The number of results on this page |
limit | The value of the limit filter specified, or 100 if not specified |
offset | The value of the offset filter specified, or 0 if not specified |
results | Zero or more items that match the filters specified |
Resources
accessory
URL: https://www.giantbomb.com/api/accessory/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the accessory detail resource. | ||
date_added | Date the accessory was added to Giant Bomb. | ||
date_last_updated | Date the accessory was last updated on Giant Bomb. | ||
deck | Brief summary of the accessory. | ||
description | Description of the accessory. | ||
guid | For use in single item api call for accessory. | ||
id | Unique ID of the accessory. | ||
image | Main image of the accessory. | ||
image_tags | List of image tags to filter the images endpoint. | ||
name | Name of the accessory. | ||
site_detail_url | URL pointing to the accessory on Giant Bomb. |
accessories
URL: https://www.giantbomb.com/api/accessories/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
api_detail_url | URL pointing to the accessory detail resource. | ||
date_added | Date the accessory was added to Giant Bomb. | ||
date_last_updated | Date the accessory was last updated on Giant Bomb. | ||
deck | Brief summary of the accessory. | ||
description | Description of the accessory. | ||
guid | For use in single item api call for accessory. | ||
id | Unique ID of the accessory. | ||
image | Main image of the accessory. | ||
image_tags | List of image tags to filter the images endpoint. | ||
name | Name of the accessory. | ||
site_detail_url | URL pointing to the accessory on Giant Bomb. |
character
URL: https://www.giantbomb.com/api/character/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
aliases | List of aliases the character is known by. A \n (newline) seperates each alias. | ||
api_detail_url | URL pointing to the character detail resource. | ||
birthday | Birthday of the character. | ||
concepts | Concepts related to the character. | ||
date_added | Date the character was added to Giant Bomb. | ||
date_last_updated | Date the character was last updated on Giant Bomb. | ||
deck | Brief summary of the character. | ||
description | Description of the character. | ||
enemies | Enemeis of the character. | ||
first_appeared_in_game | Game where the character made its first appearance. | ||
franchises | Franchises related to the character. | ||
friends | Friends of the character. | ||
games | Games the character has appeared in. | ||
gender | Gender of the character. Available options are: Male, Female, Other | ||
guid | For use in single item api call for character. | ||
id | Unique ID of the character. | ||
image | Main image of the character. | ||
image_tags | List of image tags to filter the images endpoint. | ||
last_name | Last name of the character. | ||
locations | Locations related to the character. | ||
name | Name of the character. | ||
objects | Objects related to the character. | ||
people | People who have worked with the character. | ||
real_name | Real name of the character. | ||
site_detail_url | URL pointing to the character on Giant Bomb. |
characters
URL: https://www.giantbomb.com/api/characters/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
aliases | List of aliases the character is known by. A \n (newline) seperates each alias. | ||
api_detail_url | URL pointing to the character detail resource. | ||
birthday | Birthday of the character. | ||
date_added | Date the character was added to Giant Bomb. | ||
date_last_updated | Date the character was last updated on Giant Bomb. | ||
deck | Brief summary of the character. | ||
description | Description of the character. | ||
first_appeared_in_game | Game where the character made its first appearance. | ||
gender | Gender of the character. Available options are: Male, Female, Other | ||
guid | For use in single item api call for character. | ||
id | Unique ID of the character. | ||
image | Main image of the character. | ||
image_tags | List of image tags to filter the images endpoint. | ||
last_name | Last name of the character. | ||
name | Name of the character. | ||
real_name | Real name of the character. | ||
site_detail_url | URL pointing to the character on Giant Bomb. |
chat
URL: https://www.giantbomb.com/api/chat/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the chat detail resource. | ||
channel_name | Name of the video streaming channel associated with the chat. | ||
deck | Brief summary of the chat. | ||
guid | For use in single item api call for chat. | ||
id | Unique ID of the chat. | ||
image | Main image of the chat. | ||
password | chat password. | ||
site_detail_url | URL pointing to the chat on Giant Bomb. | ||
title | Title of the chat. |
chats
URL: https://www.giantbomb.com/api/chats/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the chat detail resource. | ||
channel_name | Name of the video streaming channel associated with the chat. | ||
deck | Brief summary of the chat. | ||
guid | For use in single item api call for chat. | ||
id | Unique ID of the chat. | ||
image | Main image of the chat. | ||
password | chat password. | ||
site_detail_url | URL pointing to the chat on Giant Bomb. | ||
title | Title of the chat. |
company
URL: https://www.giantbomb.com/api/company/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
abbreviation | Abbreviation of the company. | ||
aliases | List of aliases the company is known by. A \n (newline) seperates each alias. | ||
api_detail_url | URL pointing to the company detail resource. | ||
characters | Characters related to the company. | ||
concepts | Concepts related to the company. | ||
date_added | Date the company was added to Giant Bomb. | ||
date_founded | Date the company was founded. | ||
date_last_updated | Date the company was last updated on Giant Bomb. | ||
deck | Brief summary of the company. | ||
description | Description of the company. | ||
developed_games | Games the company has developed. | ||
developer_releases | Releases the company has developed. | ||
distributor_releases | Releases the company has distributed. | ||
guid | For use in single item api call for company. | ||
id | Unique ID of the company. | ||
image | Main image of the company. | ||
image_tags | List of image tags to filter the images endpoint. | ||
location_address | Street address of the company. | ||
location_city | City the company resides in. | ||
location_country | Country the company resides in. | ||
location_address | Street address of the company. | ||
location_city | City the company resides in. | ||
location_country | Country the company resides in. | ||
location_state | State the company resides in. | ||
locations | Locations related to the company. | ||
name | Name of the company. | ||
objects | Objects related to the company. | ||
people | People who have worked with the company. | ||
phone | Phone number of the company. | ||
published_games | Games published by the company. | ||
publisher_releases | Releases the company has published. | ||
site_detail_url | URL pointing to the company on Giant Bomb. | ||
website | URL to the company website. |
companies
URL: https://www.giantbomb.com/api/companies/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
abbreviation | Abbreviation of the company. | ||
aliases | List of aliases the company is known by. A \n (newline) seperates each alias. | ||
api_detail_url | URL pointing to the company detail resource. | ||
date_added | Date the company was added to Giant Bomb. | ||
date_founded | Date the company was founded. | ||
date_last_updated | Date the company was last updated on Giant Bomb. | ||
deck | Brief summary of the company. | ||
description | Description of the company. | ||
guid | For use in single item api call for company. | ||
id | Unique ID of the company. | ||
image | Main image of the company. | ||
image_tags | List of image tags to filter the images endpoint. | ||
location_address | Street address of the company. | ||
location_city | City the company resides in. | ||
location_country | Country the company resides in. | ||
location_state | State the company resides in. | ||
name | Name of the company. | ||
phone | Phone number of the company. | ||
site_detail_url | URL pointing to the company on Giant Bomb. | ||
website | URL to the company website. |
concept
URL: https://www.giantbomb.com/api/concept/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
aliases | List of aliases the concept is known by. A \n (newline) seperates each alias. | ||
api_detail_url | URL pointing to the concept detail resource. | ||
characters | Characters related to the concept. | ||
concepts | Concepts related to the concept. | ||
date_added | Date the concept was added to Giant Bomb. | ||
date_last_updated | Date the concept was last updated on Giant Bomb. | ||
deck | Brief summary of the concept. | ||
description | Description of the concept. | ||
first_appeared_in_franchise | Franchise where the concept made its first appearance. | ||
first_appeared_in_game | Game where the concept made its first appearance. | ||
franchises | Franchises related to the concept. | ||
games | Games the concept has appeared in. | ||
guid | For use in single item api call for concept. | ||
id | Unique ID of the concept. | ||
image | Main image of the concept. | ||
image_tags | List of image tags to filter the images endpoint. | ||
locations | Locations related to the concept. | ||
name | Name of the concept. | ||
objects | Objects related to the concept. | ||
people | People who have worked with the concept. | ||
related_concepts | Other concepts related to the concept. | ||
site_detail_url | URL pointing to the concept on Giant Bomb. |
concepts
URL: https://www.giantbomb.com/api/concepts/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
aliases | List of aliases the concept is known by. A \n (newline) seperates each alias. | ||
api_detail_url | URL pointing to the concept detail resource. | ||
date_added | Date the concept was added to Giant Bomb. | ||
date_last_updated | Date the concept was last updated on Giant Bomb. | ||
deck | Brief summary of the concept. | ||
description | Description of the concept. | ||
first_appeared_in_franchise | Franchise where the concept made its first appearance. | ||
first_appeared_in_game | Game where the concept made its first appearance. | ||
guid | For use in single item api call for concept. | ||
id | Unique ID of the concept. | ||
image | Main image of the concept. | ||
image_tags | List of image tags to filter the images endpoint. | ||
name | Name of the concept. | ||
site_detail_url | URL pointing to the concept on Giant Bomb. |
dlc
URL: https://www.giantbomb.com/api/dlc/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the dlc detail resource. | ||
date_added | Date the dlc was added to Giant Bomb. | ||
date_last_updated | Date the dlc was last updated on Giant Bomb. | ||
deck | Brief summary of the dlc. | ||
description | Description of the dlc. | ||
game | Game the dlc is for. | ||
guid | For use in single item api call for dlc. | ||
id | Unique ID of the dlc. | ||
image | Main image of the dlc. | ||
name | Name of the dlc. | ||
platform | Platform of the dlc. | ||
release_date | Date of the dlc. | ||
site_detail_url | URL pointing to the dlc on Giant Bomb. |
dlcs
URL: https://www.giantbomb.com/api/dlcs/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
platforms | Filters results by platform. The value passed to this filter should be the ID of the platform to filter results by. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
api_detail_url | URL pointing to the dlc detail resource. | ||
date_added | Date the dlc was added to Giant Bomb. | ||
date_last_updated | Date the dlc was last updated on Giant Bomb. | ||
deck | Brief summary of the dlc. | ||
description | Description of the dlc. | ||
game | Game the dlc is for. | ||
guid | For use in single item api call for dlc. | ||
id | Unique ID of the dlc. | ||
image | Main image of the dlc. | ||
name | Name of the dlc. | ||
platform | The dlc's platform. | ||
release_date | Date of the dlc. | ||
site_detail_url | URL pointing to the dlc on Giant Bomb. |
franchise
URL: https://www.giantbomb.com/api/franchise/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
aliases | List of aliases the franchise is known by. A \n (newline) seperates each alias. | ||
api_detail_url | URL pointing to the franchise detail resource. | ||
characters | Characters related to the franchise. | ||
concepts | Concepts related to the franchise. | ||
date_added | Date the franchise was added to Giant Bomb. | ||
date_last_updated | Date the franchise was last updated on Giant Bomb. | ||
deck | Brief summary of the franchise. | ||
description | Description of the franchise. | ||
games | Games the franchise has appeared in. | ||
guid | For use in single item api call for franchise. | ||
id | Unique ID of the franchise. | ||
image | Main image of the franchise. | ||
image_tags | List of image tags to filter the images endpoint. | ||
locations | Locations related to the franchise. | ||
name | Name of the franchise. | ||
objects | Objects related to the franchise. | ||
people | People who have worked with the franchise. | ||
site_detail_url | URL pointing to the franchise on Giant Bomb. |
franchises
URL: https://www.giantbomb.com/api/franchises/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
Fields | |||
aliases | List of aliases the franchise is known by. A \n (newline) seperates each alias. | ||
api_detail_url | URL pointing to the franchise detail resource. | ||
date_added | Date the franchise was added to Giant Bomb. | ||
date_last_updated | Date the franchise was last updated on Giant Bomb. | ||
deck | Brief summary of the franchise. | ||
description | Description of the franchise. | ||
guid | For use in single item api call for franchise. | ||
id | Unique ID of the franchise. | ||
image | Main image of the franchise. | ||
image_tags | List of image tags to filter the images endpoint. | ||
name | Name of the franchise. | ||
site_detail_url | URL pointing to the franchise on Giant Bomb. |
game
URL: https://www.giantbomb.com/api/game/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
aliases | List of aliases the game is known by. A \n (newline) seperates each alias. | ||
api_detail_url | URL pointing to the game detail resource. | ||
characters | Characters related to the game. | ||
concepts | Concepts related to the game. | ||
date_added | Date the game was added to Giant Bomb. | ||
date_last_updated | Date the game was last updated on Giant Bomb. | ||
deck | Brief summary of the game. | ||
description | Description of the game. | ||
developers | Companies who developed the game. | ||
expected_release_day | Expected day of release. The month is represented numerically. Combine with 'expected_release_day', 'expected_release_month', 'expected_release_year' and 'expected_release_quarter' for Giant Bomb's best guess release date of the game. These fields will be empty if the 'original_release_date' field is set. | ||
expected_release_month | Expected month of release. The month is represented numerically. Combine with 'expected_release_day', 'expected_release_quarter' and 'expected_release_year' for Giant Bomb's best guess release date of the game. These fields will be empty if the 'original_release_date' field is set. | ||
expected_release_quarter | Expected quarter of release. The quarter is represented numerically, where 1 = Q1, 2 = Q2, 3 = Q3, and 4 = Q4. Combine with 'expected_release_day', 'expected_release_month' and 'expected_release_year' for Giant Bomb's best guess release date of the game. These fields will be empty if the 'original_release_date' field is set. | ||
expected_release_year | Expected year of release. Combine with 'expected_release_day', 'expected_release_month' and 'expected_release_quarter' for Giant Bomb's best guess release date of the game. These fields will be empty if the 'original_release_date' field is set. | ||
first_appearance_characters | Characters that first appeared in the game. | ||
first_appearance_concepts | Concepts that first appeared in the game. | ||
first_appearance_locations | Locations that first appeared in the game. | ||
first_appearance_objects | Objects that first appeared in the game. | ||
first_appearance_people | People that were first credited in the game. | ||
franchises | Franchises related to the game. | ||
genres | Genres that encompass the game. | ||
guid | For use in single item api call for game. | ||
id | Unique ID of the game. | ||
image | Main image of the game. | ||
images | List of images associated to the game. | ||
image_tags | List of image tags to filter the images endpoint. | ||
killed_characters | Characters killed in the game. | ||
locations | Locations related to the game. | ||
name | Name of the game. | ||
number_of_user_reviews | Number of user reviews of the game on Giant Bomb. | ||
objects | Objects related to the game. | ||
original_game_rating | Rating of the first release of the game. | ||
original_release_date | Date the game was first released. | ||
people | People who have worked with the game. | ||
platforms | Platforms the game appeared in. | ||
publishers | Companies who published the game. | ||
releases | Releases of the game. | ||
dlcs | Game DLCs | ||
reviews | Staff reviews of the game. | ||
similar_games | Other games similar to the game. | ||
site_detail_url | URL pointing to the game on Giant Bomb. | ||
themes | Themes that encompass the game. | ||
videos | Videos associated to the game. |
games
URL: https://www.giantbomb.com/api/games/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
platforms | Filters results by platform. The value passed to this filter should be the ID of the platform to filter results by. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
aliases | List of aliases the game is known by. A \n (newline) seperates each alias. | ||
api_detail_url | URL pointing to the game detail resource. | ||
date_added | Date the game was added to Giant Bomb. | ||
date_last_updated | Date the game was last updated on Giant Bomb. | ||
deck | Brief summary of the game. | ||
description | Description of the game. | ||
expected_release_day | Expected day of release. The month is represented numerically. Combine with 'expected_release_month', 'expected_release_year' and 'expected_release_quarter' for Giant Bomb's best guess release date of the game. These fields will be empty if the 'original_release_date' field is set. | ||
expected_release_month | Expected month of release. The month is represented numerically. Combine with 'expected_release_day', 'expected_release_quarter' and 'expected_release_year' for Giant Bomb's best guess release date of the game. These fields will be empty if the 'original_release_date' field is set. | ||
expected_release_quarter | Expected quarter of release. The quarter is represented numerically, where 1 = Q1, 2 = Q2, 3 = Q3, and 4 = Q4. Combine with 'expected_release_day', 'expected_release_day', 'expected_release_month' and 'expected_release_year' for Giant Bomb's best guess release date of the game. These fields will be empty if the 'original_release_date' field is set. | ||
expected_release_year | Expected year of release. Combine with 'expected_release_day', 'expected_release_month' and 'expected_release_quarter' for Giant Bomb's best guess release date of the game. These fields will be empty if the 'original_release_date' field is set. | ||
guid | For use in single item api call for game. | ||
id | Unique ID of the game. | ||
image | Main image of the game. | ||
image_tags | List of image tags to filter the images endpoint. | ||
name | Name of the game. | ||
number_of_user_reviews | Number of user reviews of the game on Giant Bomb. | ||
original_game_rating | Rating of the first release of the game. | ||
original_release_date | Date the game was first released. | ||
platforms | The platforms the game exists on. | ||
site_detail_url | URL pointing to the game on Giant Bomb. |
game_rating
URL: https://www.giantbomb.com/api/game_rating/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the game_rating detail resource. | ||
guid | For use in single item api call for game_rating. | ||
id | Unique ID of the game_rating. | ||
image | Main image of the game_rating. | ||
name | Name of the game_rating. | ||
rating_board | Rating board that issues this game_rating. |
game_ratings
URL: https://www.giantbomb.com/api/game_ratings/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
api_detail_url | URL pointing to the game_rating detail resource. | ||
guid | For use in single item api call for game_rating. | ||
id | Unique ID of the game_rating. | ||
image | Main image of the game_rating. | ||
name | Name of the game_rating. | ||
rating_board | Rating board that issues this game_rating. |
genre
URL: https://www.giantbomb.com/api/genre/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the genre detail resource. | ||
date_added | Date the genre was added to Giant Bomb. | ||
date_last_updated | Date the genre was last updated on Giant Bomb. | ||
deck | Brief summary of the genre. | ||
description | Description of the genre. | ||
guid | For use in single item api call for genre. | ||
id | Unique ID of the genre. | ||
image | Main image of the genre. | ||
name | Name of the genre. | ||
site_detail_url | URL pointing to the genre on Giant Bomb. |
genres
URL: https://www.giantbomb.com/api/genres/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
Fields | |||
api_detail_url | URL pointing to the genre detail resource. | ||
date_added | Date the genre was added to Giant Bomb. | ||
date_last_updated | Date the genre was last updated on Giant Bomb. | ||
deck | Brief summary of the genre. | ||
description | Description of the genre. | ||
guid | For use in single item api call for genre. | ||
id | Unique ID of the genre. | ||
image | Main image of the genre. | ||
name | Name of the genre. | ||
site_detail_url | URL pointing to the genre on Giant Bomb. |
images
URL: https://www.giantbomb.com/api/images/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
icon_url | URL to the icon version of the image. | ||
medium_url | URL to the medium size of the image. | ||
original_url | URL to the original image. | ||
screen_url | URL to the screenshot version of the image. | ||
screen_large_url | URL to the large screenshot version of the image. | ||
small_url | URL to the small version of the image. | ||
super_url | URL to the super sized version of the image. | ||
thumb_url | URL to the thumb-sized version of the image. | ||
tiny_url | URL to the tiny version of the image. | ||
image_tag | Name of image tag for filerting images. |
location
URL: https://www.giantbomb.com/api/location/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
aliases | List of aliases the location is known by. A \n (newline) seperates each alias. | ||
api_detail_url | URL pointing to the location detail resource. | ||
date_added | Date the location was added to Giant Bomb. | ||
date_last_updated | Date the location was last updated on Giant Bomb. | ||
deck | Brief summary of the location. | ||
description | Description of the location. | ||
first_appeared_in_game | Game where the location made its first appearance. | ||
guid | For use in single item api call for location. | ||
id | Unique ID of the location. | ||
image | Main image of the location. | ||
image_tags | List of image tags to filter the images endpoint. | ||
name | Name of the location. | ||
site_detail_url | URL pointing to the location on Giant Bomb. |
locations
URL: https://www.giantbomb.com/api/locations/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
aliases | List of aliases the location is known by. A \n (newline) seperates each alias. | ||
api_detail_url | URL pointing to the location detail resource. | ||
date_added | Date the location was added to Giant Bomb. | ||
date_last_updated | Date the location was last updated on Giant Bomb. | ||
deck | Brief summary of the location. | ||
description | Description of the location. | ||
first_appeared_in_game | Game where the location made its first appearance. | ||
guid | For use in single item api call for location. | ||
id | Unique ID of the location. | ||
image | Main image of the location. | ||
image_tags | List of image tags to filter the images endpoint. | ||
name | Name of the location. | ||
site_detail_url | URL pointing to the location on Giant Bomb. |
object
URL: https://www.giantbomb.com/api/object/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
aliases | List of aliases the object is known by. A \n (newline) seperates each alias. | ||
api_detail_url | URL pointing to the object detail resource. | ||
characters | Characters related to the object. | ||
companies | Companies related to the object. | ||
concepts | Concepts related to the object. | ||
date_added | Date the object was added to Giant Bomb. | ||
date_last_updated | Date the object was last updated on Giant Bomb. | ||
deck | Brief summary of the object. | ||
description | Description of the object. | ||
first_appeared_in_game | Game where the object made its first appearance. | ||
franchises | Franchises related to the object. | ||
games | Games the object has appeared in. | ||
guid | For use in single item api call for object. | ||
id | Unique ID of the object. | ||
image | Main image of the object. | ||
image_tags | List of image tags to filter the images endpoint. | ||
locations | Locations related to the object. | ||
name | Name of the object. | ||
objects | Objects related to the object. | ||
people | People who have worked with the object. | ||
site_detail_url | URL pointing to the object on Giant Bomb. |
objects
URL: https://www.giantbomb.com/api/objects/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
aliases | List of aliases the object is known by. A \n (newline) seperates each alias. | ||
api_detail_url | URL pointing to the object detail resource. | ||
date_added | Date the object was added to Giant Bomb. | ||
date_last_updated | Date the object was last updated on Giant Bomb. | ||
deck | Brief summary of the object. | ||
description | Description of the object. | ||
first_appeared_in_game | Game where the object made its first appearance. | ||
guid | For use in single item api call for object. | ||
id | Unique ID of the object. | ||
image | Main image of the object. | ||
image_tags | List of image tags to filter the images endpoint. | ||
name | Name of the object. | ||
site_detail_url | URL pointing to the object on Giant Bomb. |
person
URL: https://www.giantbomb.com/api/person/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
aliases | List of aliases the person is known by. A \n (newline) seperates each alias. | ||
api_detail_url | URL pointing to the person detail resource. | ||
birth_date | Date the person was born. | ||
characters | Characters related to the person. | ||
concepts | Concepts related to the person. | ||
country | Country the person resides in. | ||
date_added | Date the person was added to Giant Bomb. | ||
date_last_updated | Date the person was last updated on Giant Bomb. | ||
death_date | Date the person died. | ||
deck | Brief summary of the person. | ||
description | Description of the person. | ||
first_credited_game | Game the person was first credited. | ||
franchises | Franchises related to the person. | ||
games | Games the person has appeared in. | ||
gender | Gender of the person. Available options are: Male, Female, Other | ||
guid | For use in single item api call for person. | ||
hometown | City or town the person resides in. | ||
id | Unique ID of the person. | ||
image | Main image of the person. | ||
image_tags | List of image tags to filter the images endpoint. | ||
locations | Locations related to the person. | ||
name | Name of the person. | ||
objects | Objects related to the person. | ||
people | People who have worked with the person. | ||
site_detail_url | URL pointing to the person on Giant Bomb. |
people
URL: https://www.giantbomb.com/api/people/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
aliases | List of aliases the person is known by. A \n (newline) seperates each alias. | ||
api_detail_url | URL pointing to the person detail resource. | ||
birth_date | Date the person was born. | ||
country | Country the person resides in. | ||
date_added | Date the person was added to Giant Bomb. | ||
date_last_updated | Date the person was last updated on Giant Bomb. | ||
death_date | Date the person died. | ||
deck | Brief summary of the person. | ||
description | Description of the person. | ||
first_credited_game | Game the person was first credited. | ||
gender | Gender of the person. Available options are: Male, Female, Other | ||
guid | For use in single item api call for person. | ||
hometown | City or town the person resides in. | ||
id | Unique ID of the person. | ||
image | Main image of the person. | ||
image_tags | List of image tags to filter the images endpoint. | ||
name | Name of the person. | ||
site_detail_url | URL pointing to the person on Giant Bomb. |
platform
URL: https://www.giantbomb.com/api/platform/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
abbreviation | Abbreviation of the platform. | ||
api_detail_url | URL pointing to the platform detail resource. | ||
company | Company that created the platform. | ||
date_added | Date the platform was added to Giant Bomb. | ||
date_last_updated | Date the platform was last updated on Giant Bomb. | ||
deck | Brief summary of the platform. | ||
description | Description of the platform. | ||
guid | For use in single item api call for platform. | ||
id | Unique ID of the platform. | ||
image | Main image of the platform. | ||
image_tags | List of image tags to filter the images endpoint. | ||
install_base | Approximate number of sold hardware units. | ||
name | Name of the platform. | ||
online_support | Flag indicating whether the platform has online capabilities. | ||
original_price | Initial price point of the platform. | ||
release_date | Date of the platform. | ||
site_detail_url | URL pointing to the platform on Giant Bomb. |
platforms
URL: https://www.giantbomb.com/api/platforms/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
abbreviation | Abbreviation of the platform. | ||
api_detail_url | URL pointing to the platform detail resource. | ||
company | Company that created the platform. | ||
date_added | Date the platform was added to Giant Bomb. | ||
date_last_updated | Date the platform was last updated on Giant Bomb. | ||
deck | Brief summary of the platform. | ||
description | Description of the platform. | ||
guid | For use in single item api call for platform. | ||
id | Unique ID of the platform. | ||
image | Main image of the platform. | ||
image_tags | List of image tags to filter the images endpoint. | ||
install_base | Approximate number of sold hardware units. | ||
name | Name of the platform. | ||
online_support | Flag indicating whether the platform has online capabilities. | ||
original_price | Initial price point of the platform. | ||
release_date | Date of the platform. | ||
site_detail_url | URL pointing to the platform on Giant Bomb. |
promo
URL: https://www.giantbomb.com/api/promo/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the promo detail resource. | ||
date_added | Date the promo was added to Giant Bomb. | ||
deck | Brief summary of the promo. | ||
guid | For use in single item api call for promo. | ||
id | Unique ID of the promo. | ||
image | Main image of the promo. | ||
link | The link that promo points to. | ||
name | Name of the promo. | ||
resource_type | The type of resource the promo is pointing towards. | ||
user | Author of the promo. |
promos
URL: https://www.giantbomb.com/api/promos/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
api_detail_url | URL pointing to the promo detail resource. | ||
date_added | Date the promo was added to Giant Bomb. | ||
deck | Brief summary of the promo. | ||
guid | For use in single item api call for promo. | ||
id | Unique ID of the promo. | ||
image | Main image of the promo. | ||
link | The link that promo points to. | ||
name | Name of the promo. | ||
resource_type | The type of resource the promo is pointing towards. | ||
user | Author of the promo. |
rating_board
URL: https://www.giantbomb.com/api/rating_board/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the rating_board detail resource. | ||
date_added | Date the rating_board was added to Giant Bomb. | ||
date_last_updated | Date the rating_board was last updated on Giant Bomb. | ||
deck | Brief summary of the rating_board. | ||
description | Description of the rating_board. | ||
guid | For use in single item api call for rating_board. | ||
id | Unique ID of the rating_board. | ||
image | Main image of the rating_board. | ||
name | Name of the rating_board. | ||
region | Region the rating_board is responsible for. | ||
site_detail_url | URL pointing to the rating_board on Giant Bomb. |
rating_boards
URL: https://www.giantbomb.com/api/rating_boards/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
api_detail_url | URL pointing to the rating_board detail resource. | ||
date_added | Date the rating_board was added to Giant Bomb. | ||
date_last_updated | Date the rating_board was last updated on Giant Bomb. | ||
deck | Brief summary of the rating_board. | ||
description | Description of the rating_board. | ||
guid | For use in single item api call for rating_board. | ||
id | Unique ID of the rating_board. | ||
image | Main image of the rating_board. | ||
name | Name of the rating_board. | ||
site_detail_url | URL pointing to the rating_board on Giant Bomb. |
region
URL: https://www.giantbomb.com/api/region/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the region detail resource. | ||
date_added | Date the region was added to Giant Bomb. | ||
date_last_updated | Date the region was last updated on Giant Bomb. | ||
deck | Brief summary of the region. | ||
description | Description of the region. | ||
guid | For use in single item api call for region. | ||
id | Unique ID of the region. | ||
image | Main image of the region. | ||
name | Name of the region. | ||
rating_boards | region in the region. | ||
site_detail_url | URL pointing to the region on Giant Bomb. |
regions
URL: https://www.giantbomb.com/api/regions/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
api_detail_url | URL pointing to the region detail resource. | ||
date_added | Date the region was added to Giant Bomb. | ||
date_last_updated | Date the region was last updated on Giant Bomb. | ||
deck | Brief summary of the region. | ||
description | Description of the region. | ||
guid | For use in single item api call for region. | ||
id | Unique ID of the region. | ||
image | Main image of the region. | ||
name | Name of the region. | ||
site_detail_url | URL pointing to the region on Giant Bomb. |
release
URL: https://www.giantbomb.com/api/release/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the release detail resource. | ||
date_added | Date the release was added to Giant Bomb. | ||
date_last_updated | Date the release was last updated on Giant Bomb. | ||
deck | Brief summary of the release. | ||
description | Description of the release. | ||
developers | Companies who developed the release. | ||
expected_release_day | "Expected day of release. The day is represented numerically. Combine with 'expected_release_month', 'expected_release_year' and 'expected_release_quarter' for Giant Bomb's best guess release date of the release. These fields will be empty if the 'release_date' field is set." | ||
expected_release_month | "Expected month of release. The month is represented numerically. Combine with 'expected_release_day', expected_release_quarter' and 'expected_release_year' for Giant Bomb's best guess release date of the release. These fields will be empty if the 'release_date' field is set." | ||
expected_release_quarter | Expected quarter of release. The quarter is represented numerically, where 1 = Q1, 2 = Q2, 3 = Q3, and 4 = Q4. Combine with 'expected_release_day', 'expected_release_month' and 'expected_release_year' for Giant Bomb's best guess release date of the release. These fields will be empty if the 'release_date' field is set. | ||
expected_release_year | Expected year of release. Combine with 'expected_release_day', 'expected_release_month' and 'expected_release_quarter' for Giant Bomb's best guess release date of the game. These fields will be empty if the 'release_date' field is set. | ||
game | Game the release is for. | ||
game_rating | Rating of the release. | ||
guid | For use in single item api call for release. | ||
id | Unique ID of the release. | ||
image | Main image of the release. | ||
maximum_players | Maximum players | ||
minimum_players | Minimum players | ||
multiplayer_features | Multiplayer features | ||
name | Name of the release. | ||
platform | Platform of the release. | ||
product_code_type | The type of product code the release has (ex. UPC/A, ISBN-10, EAN-13). | ||
product_code_value | The release's product code. | ||
publishers | Companies who published the release. | ||
region | Region the release is responsible for. | ||
release_date | Date of the release. | ||
resolutions | Resolutions available | ||
singleplayer_features | Singleplayer features | ||
sound_systems | Sound systems | ||
site_detail_url | URL pointing to the release on Giant Bomb. | ||
widescreen_support | Widescreen support |
releases
URL: https://www.giantbomb.com/api/releases/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
platforms | Filters results by platform. The value passed to this filter should be the ID of the platform to filter results by. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
api_detail_url | URL pointing to the release detail resource. | ||
date_added | Date the release was added to Giant Bomb. | ||
date_last_updated | Date the release was last updated on Giant Bomb. | ||
deck | Brief summary of the release. | ||
description | Description of the release. | ||
expected_release_day | "Expected day of release. The day is represented numerically. Combine with 'expected_release_month', 'expected_release_year' and 'expected_release_quarter' for Giant Bomb's best guess release date of the release. These fields will be empty if the 'release_date' field is set." | ||
expected_release_month | "Expected month of release. The month is represented numerically. Combine with 'expected_release_day', expected_release_quarter' and 'expected_release_year' for Giant Bomb's best guess release date of the release. These fields will be empty if the 'release_date' field is set." | ||
expected_release_quarter | Expected quarter of release. The quarter is represented numerically, where 1 = Q1, 2 = Q2, 3 = Q3, and 4 = Q4. Combine with 'expected_release_day', 'expected_release_month' and 'expected_release_year' for Giant Bomb's best guess release date of the release. These fields will be empty if the 'release_date' field is set. | ||
expected_release_year | Expected year of release. Combine with 'expected_release_day', 'expected_release_month' and 'expected_release_quarter' for Giant Bomb's best guess release date of the game. These fields will be empty if the 'release_date' field is set. | ||
game | Game the release is for. | ||
game_rating | Rating of the release. | ||
guid | For use in single item api call for release. | ||
id | Unique ID of the release. | ||
image | Main image of the release. | ||
maximum_players | Maximum players | ||
minimum_players | Minimum players | ||
multiplayer_features | Multiplayer features | ||
name | Name of the release. | ||
platform | The release's platform. | ||
product_code_type | The type of product code the release has (ex. UPC/A, ISBN-10, EAN-13). | ||
product_code_value | The release's product code. | ||
region | Region the release is responsible for. | ||
release_date | Date of the release. | ||
resolutions | Resolutions available | ||
singleplayer_features | Singleplayer features | ||
sound_systems | Sound systems | ||
site_detail_url | URL pointing to the release on Giant Bomb. | ||
widescreen_support | Widescreen support |
review
URL: https://www.giantbomb.com/api/review/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the review detail resource. | ||
deck | Brief summary of the review. | ||
description | Description of the review. | ||
dlc_name | Name of the Downloadable Content package. | ||
game | Game the review is for. | ||
guid | For use in single item api call for review. | ||
id | Unique ID of the review. | ||
platforms | Platforms the review appeared in. | ||
publish_date | Date the review was published on Giant Bomb. | ||
release | Release of game for review. | ||
reviewer | Name of the review's author. | ||
score | The score given to the game on a scale of 1 to 5. | ||
site_detail_url | URL pointing to the review on Giant Bomb. |
reviews
URL: https://www.giantbomb.com/api/reviews/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
api_detail_url | URL pointing to the review detail resource. | ||
deck | Brief summary of the review. | ||
description | Description of the review. | ||
dlc_name | Name of the Downloadable Content package. | ||
game | Game the review is for. | ||
guid | For use in single item api call for review. | ||
id | Unique ID of the review. | ||
publish_date | Date the review was published on Giant Bomb. | ||
release | Release of game for review. | ||
reviewer | Name of the review's author. | ||
score | The score given to the game on a scale of 1 to 5. | ||
site_detail_url | URL pointing to the review on Giant Bomb. |
search
URL: https://www.giantbomb.com/api/search/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 10 and can not exceed this number. | ||
page | Page number of search results. | ||
query | The search string. | ||
resources | List of resources to filter results. This filter can accept multiple arguments, each delimited with a ",". Available options
are:
| ||
subscriber_only | NEED DESCRIPTION | ||
Fields | |||
resource_type | The type of resource the result is mapped to. Available options are:
|
theme
URL: https://www.giantbomb.com/api/theme/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the theme detail resource. | ||
guid | For use in single item api call for theme. | ||
id | Unique ID of the theme. | ||
name | Name of the theme. | ||
site_detail_url | URL pointing to the theme on Giant Bomb. |
themes
URL: https://www.giantbomb.com/api/themes/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
api_detail_url | URL pointing to the theme detail resource. | ||
guid | For use in single item api call for theme. | ||
id | Unique ID of the theme. | ||
name | Name of the theme. | ||
site_detail_url | URL pointing to the theme on Giant Bomb. |
types
URL: https://www.giantbomb.com/api/types/?api_key=[YOUR API KEY] | |||
Fields | |||
detail_resource_name | The name of the type's detail resource. | ||
id | Unique ID of the type. | ||
list_resource_name | The name of the type's list resource. |
user_review
URL: https://www.giantbomb.com/api/user_review/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the user_review detail resource. | ||
date_added | Date the user_review was added to Giant Bomb. | ||
date_last_updated | Date the user_review was last updated on Giant Bomb. | ||
deck | Brief summary of the user_review. | ||
description | Description of the user_review. | ||
game | Game being reviewd. | ||
release | Release being reviewed. | ||
dlc | DLC being reviewed. | ||
guid | For use in single item api call for user_review. | ||
id | Unique ID of the user_review. | ||
reviewer | Name of the review's author. | ||
score | The score given to the game on a scale of 1 to 5. | ||
site_detail_url | URL pointing to the user_review on Giant Bomb. |
user_reviews
URL: https://www.giantbomb.com/api/user_reviews/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
game | Filter by the ID field on the game resource. | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
api_detail_url | URL pointing to the user_review detail resource. | ||
date_added | Date the user_review was added to Giant Bomb. | ||
date_last_updated | Date the user_review was last updated on Giant Bomb. | ||
deck | Brief summary of the user_review. | ||
description | Description of the user_review. | ||
game | Game being reviewd. | ||
release | Release being reviewed. | ||
dlc | DLC being reviewed. | ||
guid | For use in single item api call for user_review. | ||
id | Unique ID of the user_review. | ||
reviewer | Name of the review's author. | ||
score | The score given to the game on a scale of 1 to 5. | ||
site_detail_url | URL pointing to the user_review on Giant Bomb. |
video
URL: https://www.giantbomb.com/api/video/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the video detail resource. | ||
associations | Related objects to the video. | ||
deck | Brief summary of the video. | ||
hd_url | URL to the HD version of the video. | ||
high_url | URL to the High Res version of the video. | ||
low_url | URL to the Low Res version of the video. | ||
embed_player | URL for video embed player. To be inserted into an iFrame. You can add ?autoplay=true to auto-play. You can add ?time=x where 'x' is an integer between 0 and the length of the video in seconds to start the video at that point. You can add ?vol=x where 'x' is a decimal between 0 and 1, .75 for example, to set the starting volume. The above three parameters may be used together. Example: ?time=45&vol=.5&autoplay=true See http://www.giantbomb.com/api/video-embed-sample/ for more information on using the embed player. |
||
guid | For use in single item api call for video. | ||
id | Unique ID of the video. | ||
image | Main image of the video. | ||
length_seconds | Length (in seconds) of the video. | ||
name | Name of the video. | ||
publish_date | Date the video was published on Giant Bomb. | ||
site_detail_url | URL pointing to the video on Giant Bomb. | ||
url | The video's filename. | ||
user | Author of the video. | ||
video_categories | Video categories | ||
video_type | Video category | ||
video_show | Video show | ||
youtube_id | Youtube ID for the video. | ||
saved_time | The time where the user left off watching this video | ||
premium | Premium status of video. | ||
hosts | Hosts of the video. | ||
crew | Crew of the video. |
videos
URL: https://www.giantbomb.com/api/videos/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
subscriber_only | NEED DESCRIPTION | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
api_detail_url | URL pointing to the video detail resource. | ||
associations | Related objects to the video. | ||
deck | Brief summary of the video. | ||
hd_url | URL to the HD version of the video. | ||
high_url | URL to the High Res version of the video. | ||
low_url | URL to the Low Res version of the video. | ||
embed_player | URL for video embed player. To be inserted into an iFrame. You can add ?autoplay=true to auto-play. You can add ?time=x where 'x' is an integer between 0 and the length of the video in seconds to start the video at that point. You can add ?vol=x where 'x' is a decimal between 0 and 1, .75 for example, to set the starting volume. The above three parameters may be used together. Example: ?time=45&vol=.5&autoplay=true See http://www.giantbomb.com/api/video-embed-sample/ for more information on using the embed player. |
||
guid | For use in single item api call for video. | ||
id | Unique ID of the video. | ||
image | Main image of the video. | ||
length_seconds | Length (in seconds) of the video. | ||
name | Name of the video. | ||
publish_date | Date the video was published on Giant Bomb. | ||
site_detail_url | URL pointing to the video on Giant Bomb. | ||
url | The video's filename. | ||
user | Author of the video. | ||
video_categories | Video categories | ||
video_type | Video category | ||
video_show | Video show | ||
youtube_id | Youtube ID for the video. | ||
saved_time | The time where the user left off watching this video | ||
premium | Premium status of video. |
video_type - DEPRECATED
URL: https://www.giantbomb.com/api/video_type/[id]/?api_key=[YOUR API KEY] | |||
Description: Get a details of a video type | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the video_type detail resource. | ||
deck | Brief summary of the video_type. | ||
id | Unique ID of the video_type. | ||
name | Name of the video_type. | ||
site_detail_url | URL pointing to the video_type on Giant Bomb. |
video_types - DEPRECATED
URL: https://www.giantbomb.com/api/video_types/?api_key=[YOUR API KEY] | |||
Description: Get a list of video types | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
Fields | |||
api_detail_url | URL pointing to the video_type detail resource. | ||
deck | Brief summary of the video_type. | ||
id | Unique ID of the video_type. | ||
name | Name of the video_type. | ||
site_detail_url | URL pointing to the video_type on Giant Bomb. |
video_category
URL: https://www.giantbomb.com/api/video_category/[id]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the video_category detail resource. | ||
deck | Brief summary of the video_category. | ||
id | Unique ID of the video_category. | ||
name | Name of the video_category. | ||
image | Main image of the video_category. | ||
site_detail_url | URL pointing to the video_category on Giant Bomb. |
video_categories
URL: https://www.giantbomb.com/api/video_categories/[id]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
Fields | Sort | Filter | |
api_detail_url | URL pointing to the video_category detail resource. | ||
deck | Brief summary of the video_category. | ||
id | Unique ID of the video_category. | ||
name | Name of the video_category. | ||
image | Main image of the video_category. | ||
site_detail_url | URL pointing to the video_category on Giant Bomb. |
video_show
URL: https://www.giantbomb.com/api/video_show/[guid]/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
Fields | |||
api_detail_url | URL pointing to the video_show detail resource. | ||
deck | Brief summary of the video_show. | ||
guid | For use in single item api call for video_show. | ||
id | Unique ID of the video_show. | ||
title | Title of the video_show. | ||
position | Editor ordering. | ||
image | Main image of the video_show. | ||
logo | Show logo. | ||
site_detail_url | URL pointing to the video_show on Giant Bomb. | ||
active | Is this show currently active | ||
display_nav | Should this show be displayed in navigation menus | ||
latest | The latest episode of a video show. Overrides other sorts when used as a sort field. | ||
premium | Premium status of video_show. | ||
api_videos_url | Endpoint to retrieve the videos attached to this video_show. |
video_shows
URL: https://www.giantbomb.com/api/video_shows/?api_key=[YOUR API KEY] | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
field_list | List of field names to include in the response. Use this if you want to reduce the size of the response payload. This filter can accept multiple arguments, each delimited with a "," | ||
limit | The number of results to display per page. This value defaults to 100 and can not exceed this number. | ||
offset | Return results starting with the object at the offset specified. | ||
sort | The result set can be sorted by the marked fields in the Fields section below. Format: &sort=field:direction where direction is either asc or desc. | ||
filter | The result can be filtered by the marked fields in the Fields section below. Single filter: &filter=field:value Multiple filters: &filter=field:value,field:value Date filters: &filter=field:start value|end value (using datetime format) | ||
Fields | Sort | Filter | |
api_detail_url | URL pointing to the video_show detail resource. | ||
deck | Brief summary of the video_show. | ||
guid | For use in single item api call for video_show. | ||
id | Unique ID of the video_show. | ||
title | Title of the video_show. | ||
position | Editor ordering. | ||
image | Main image of the video_show. | ||
logo | Show logo. | ||
site_detail_url | URL pointing to the video_show on Giant Bomb. | ||
active | Is this show currently active | ||
display_nav | Should this show be displayed in navigation menus | ||
latest | The latest episode of a video show. Overrides other sorts when used as a sort field. | ||
premium | Premium status of video_show. | ||
api_videos_url | Endpoint to retrieve the videos attached to this video_show. |
current-live
URL: https://www.giantbomb.com/api/video/current-live/?api_key=[YOUR API KEY] | |||
Description: Get the currently running live stream | |||
Fields | |||
video.title | Title of the live video | ||
video.image | Thumbnail image of the video | ||
video.stream | URL of the stream (HLS format) |
get-saved-time
URL: https://www.giantbomb.com/api/video/get-saved-time/?api_key=[YOUR API KEY] | |||
Description: Get the saved time of a video for the user | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
video_id | Id of the video | ||
Fields | |||
savedTime | Saved time of the video or -1 if no time is saved for this user | ||
message | Error/status message |
save-time
URL: https://www.giantbomb.com/api/video/save-time/?api_key=[YOUR API KEY] | |||
Description: Save the progress time of a video for this user | |||
Filters | |||
format | The data format of the response takes either xml, json, or jsonp. | ||
video_id | Id of the video | ||
time_to_save | The number of seconds into the video the current user is |
get-all-saved-times
URL: https://www.giantbomb.com/api/video/get-all-saved-times/?api_key=[YOUR API KEY] | |||
Description: Get all the video saved times for the user | |||
Fields | |||
videoId | Id of the video | ||
savedTime | Saved time for this video | ||
savedOn | Time/date the progress was saved |
Log in to comment