Responses

status_codeAn integer indicating the result of the request. Acceptable values are: 1:OK, 100:Invalid API Key, 101:Object Not Found, 102:Error in URL Format, 103:'jsonp' format requires a 'json_callback' argument, 104:Filter Error, 105:Subscriber only video is for subscribers only
errorA text string representing the status_code
number_of_total_resultsThe number of total results matching the filter conditions specified
number_of_page_resultsThe number of results on this page
limitThe value of the limit filter specified, or 100 if not specified
offsetThe value of the offset filter specified, or 0 if not specified
resultsZero or more items that match the filters specified

Resources

games

URL: http://www.gamespot.com/api/games/?api_key=[YOUR API KEY]
Filters
field_listList 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 ","
limitThe number of results to display per page. This value defaults to 100 and can not exceed this number.
offsetReturn results starting with the object at the offset specified.
sortThe 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.
filterThe result can be filtered by the marked fields in the Fields section below. Format: &filter=field:value,field:value
FieldsSortFilter
release_date Date of the game.
deck Brief summary of the game.
description Description of the game.
id Unique ID of the game.
name Name of the game.
image Main image of the game.
site_detail_url Website URL pointing to the game.
videos_api_url Api call for videos for the game.
articles_api_url Api call for articles for the game.
reviews_api_url Api call for reviews for the game.
images_api_url Api call for images for the game.
releases_api_url Api call for releases for the game.

releases

URL: http://www.gamespot.com/api/releases/?api_key=[YOUR API KEY]
Filters
field_listList 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 ","
limitThe number of results to display per page. This value defaults to 100 and can not exceed this number.
offsetReturn results starting with the object at the offset specified.
sortThe 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.
filterThe result can be filtered by the marked fields in the Fields section below. Format: &filter=field:value,field:value
FieldsSortFilter
id Unique ID of the release.
name Name of the release.
upc Universal product code for release.
platform Platform of the release.
association Object guid.
release_date Date of the release.
region Region the release is responsible for.
rating Regional rating for release.
game_api_url Api call for the game for the release.
videos_api_url Api call for videos for the release.
articles_api_url Api call for articles for the release.
reviews_api_url Api call for reviews for the release.

articles

URL: http://www.gamespot.com/api/articles/?api_key=[YOUR API KEY]
Filters
field_listList 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 ","
limitThe number of results to display per page. This value defaults to 100 and can not exceed this number.
offsetReturn results starting with the object at the offset specified.
sortThe 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.
filterThe result can be filtered by the marked fields in the Fields section below. Format: &filter=field:value,field:value
FieldsSortFilter
id Unique ID of the article.
authors Author of the article.
title Title of the article.
deck Brief summary of the article.
image Main image of the article.
publish_date Date the article was published.
site_detail_url Website URL pointing to the article.

reviews

URL: http://www.gamespot.com/api/reviews/?api_key=[YOUR API KEY]
Filters
field_listList 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 ","
limitThe number of results to display per page. This value defaults to 100 and can not exceed this number.
offsetReturn results starting with the object at the offset specified.
sortThe 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.
filterThe result can be filtered by the marked fields in the Fields section below. Format: &filter=field:value,field:value
FieldsSortFilter
id Unique ID of the review.
authors Author of the review.
title Title of the review.
deck Brief summary of the review.
image Main image of the review.
publish_date Date the review was published.
score The score given to the game on a scale of 1 to 5.
site_detail_url Website URL pointing to the review.
review_type Type of review: primary, secondary or second take.
game Game the review is for.
releases Releases of the review.

videos

URL: http://www.gamespot.com/api/videos/?api_key=[YOUR API KEY]
Filters
field_listList 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 ","
limitThe number of results to display per page. This value defaults to 100 and can not exceed this number.
offsetReturn results starting with the object at the offset specified.
sortThe 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.
filterThe result can be filtered by the marked fields in the Fields section below. Format: &filter=field:value,field:value
FieldsSortFilter
id Unique ID of the video.
title Title of the video.
image Main image of the video.
deck Brief summary of the video.
low_url URL to the Low Res version of the video.
high_url URL to the High Res version of the video.
hd_url URL to the HD version of the video.
length_seconds Length (in seconds) of the video.
publish_date Date the video was published.
site_detail_url Website URL pointing to the video.
source The source id of the video.

images

URL: http://www.gamespot.com/api/images/?api_key=[YOUR API KEY]&filter=association:[GUID]
Filters
field_listList 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 ","
limitThe number of results to display per page. This value defaults to 100 and can not exceed this number.
offsetReturn results starting with the object at the offset specified.
sortThe 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.
filterThe result can be filtered by the marked fields in the Fields section below. Format: &filter=field:value,field:value
FieldsSortFilter
site_detail_url Website URL pointing to the image.
icon_url URL to the icon version of the image.
medium_url URL to the medium version of the image.
screen_url URL to the 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.
screen_tiny
square_tiny
original

events

URL: http://www.gamespot.com/api/events/?api_key=[YOUR API KEY]
Filters
field_listList 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 ","
limitThe number of results to display per page. This value defaults to 100 and can not exceed this number.
offsetReturn results starting with the object at the offset specified.
filterThe result can be filtered by the marked fields in the Fields section below. Format: &filter=field:value,field:value
FieldsSortFilter
id Unique ID of the event.
title Title of the event.
deck Brief summary of the event.
description Description of the event.
articles_api_url Api call for articles for the event.
videos_api_url Api call for videos for the event.