A .NET GiantBomb API built on top of RestSharp


GiantBomb C#

Build status


  • BUG: Fixed deserialization exception for single resource errors (e.g. Object Not Found)
  • BUG: Fixed synchronous API to not deadlock
  • Removed fastJSON DLL since it wasn't actually being used
  • Upgrade to RestSharp 105.2.3
  • Added .NET 4.6 and 4.6.1 support


  • Better error handling for API exceptions


  • Upgrade to .NET 4.5.2 (you should too!)
  • Upgrade RestSharp to 105.1
  • async/await support for all methods
  • Better fatal error handling
    • If GiantBomb returns a non-JSON response, the library will throw a GiantBombHttpException containing the raw response body
  • FIX: Issue with searches returning duplicate games from GiantBomb


  • Add new fields:
    • Platform.Aliases
    • Platform.InstallBase
    • Platform.OnlineOnly
    • Platform.OriginalPrice
    • Game.Franchises
    • Release.Game
  • Add exception handling and wrapping for GiantBomb API errors (GiantBombApiException class)
    • For example, exceeding the 400 requests in 15 minutes rate limit
  • Allow overriding Execute methods
  • Update RestSharp to 105 (fixes #13)


  • Fixes issue with search paging (offset vs. page parameter)

API v2 Support

GiantBomb-C# 2.0+ is only compatible with GiantBomb APIv2. Keep using the old packages if you need v1 support, as there are breaking changes in v2!

Notable Changes

  • Search is now MUCH better in GiantBomb's v2 API, there's little to no need for SearchAllGames now unless you expect/want more than 100 results
  • List resources support new sort and filter options
  • All single resource requests must use a resource ID, e.g. "game/3030-33394", which GBCS implements transparently for you
  • Game and Release now have ExpectedReleaseDay
  • Search results now include platforms
  • Game has two new fields:
    • Aliases - newline delimited aliases
    • OriginalGameRating
  • You can now use GetReleasesForGame() to directly retrieve releases for a game in one request
  • Using FastJSON to deserialize, which is... fast, obviously


This library aims to wrap the GiantBomb REST API in C# with strongly-typed models and is built on top of RestSharp.

It also helps make your life easier when dealing with searching because it recursively fetches your search results all at once to enable better sorting.

Note: This is not really needed anymore due to search improvements in APIv2

var giantBomb = new GiantBombRestClient();

// Get all search results
var results = giantBomb.SearchForAllGames("assassin's creed");

// Display
return results.OrderByDescending(g => g.DateAdded)


Download and install the GiantBomb.Api Nuget package:

PM> Install-Package GiantBomb.Api


Read about contributing on the wiki. If you plan to contribute, you must read this.


Read about examples on the wiki.


Dual-licensed on MIT & GPL