Avatar image for theadmin
#1 Edited by TheAdmin (883 posts) -

I wanted to create this thread as the main place to request features for the staff to work on in the API. It seems that there are quite a few developers ready to make some really compelling apps, but currently some of the missing features makes that very difficult or impossible. Here are few of the ones that I would like added, and I would hope other developers could add in what they're looking for - together we can really expand the Giantbomb brand to a host of cool apps and utilities with the right support from the API's developers.   
 

Sorting:

The vast amount of data in the API is currently beyond the scope of sorting on the developer end.  I would really like to see full sorting on the API side.  Which would mean you could do "Sort=" and use any of the fields. Examples would be "sort=release_date", "sort=expected_release_month" and much more.  I think Adding sort will increase the usability of the API considerably and allow for better apps.
 

News: 

Lots of great articles are posted by the crew and a feed to know when and what those are would be great. Resource: /news/ would be awesome along with the sorting above - for example: /news/?api_key="MY KEY"&sort=date_posted&creator=jeff&format=xml - This would return all news, sorted by the date it was posted, created by Jeff Gerstmann. This would allow for apps that could watch the news feeds and keep up to date on when new stuff was posted.  
 

Video 

Currently, you can only sort by publish_date - which is helpful, but not quite enough. This goes back into sorting mostly, but having a new field for the type of video would be helpful. So the field could be "type" or "category" - and would display quick looks, features and so on - all sortable. Perhaps you could limit the type as well... so something like /video/?api_key="MY KEY"&sort="dated_posted"&limit=quick_look&format=XML would return all quick looks sorted by when they were posted.   

These are just some of the features that I would like to see added.  Please post anything you'd like to see in here as well, even if you want to expand on what I posted above. By consolidating our feature request list, perhaps we can show the GB devs that there is a lot of interest in the APIs. 

Avatar image for lordandrew
#2 Posted by LordAndrew (14600 posts) -

Yeah, sorting sucks. You could get around that by mirroring everything locally and implementing your own decent searching and sorting methods, but that's hardly practical.

The thing with news is that I'm not sure it uses the same license as the wiki stuff. Contributions to the wiki are licensed as CC-BY-NC. And I get the feeling they don't even like doing that. Most gaming sites like to retain the copyright over editorial content and like to make it available under free or sorta free-ish licenses. I imagine Giant Bomb's staff would be the same way. They don't mind making an RSS feed available; many sites do that. But making it available through the API with primarily CC-BY-NC content makes it look like the news would be available under that license, even if that's not what they intended. I'd only like to see news made available through the API if they explicitly state that they've released it under the CC-BY-NC license. There's too much licensing confusion already.

I'd love a list of authors for... well, about everything that the API can retrieve. For news and video though, you can currently get that from the RSS feed, through the dc:creator element. Yeah, it doesn't give you everything you want. But I haven't seen anything happen on the API development front for a very long time, so I'm not sure you'll ever see any of these enhancements. :(

Avatar image for theadmin
#3 Posted by TheAdmin (883 posts) -

For anyone that was wondering, the 4 feeds are: 
http://feeds.feedburner.com/Giantbombvideos,  http://feeds.feedburner.com/Giantbombnews,  http://www.giantbomb.com/podcast-xml/, and  http://feeds.feedburner.com/GiantbombAll   
 
Although, unfortunately it seems that even things like news and videos - and to a certain extent "ALL" doesn't exactly match the site's content. It seems like it gets posted and so forth at different times and sorted differently.  Oh well. C'mon Giantbomb! Give us developers the tools to really wow you! 

Avatar image for vigorousjammer
#4 Posted by Vigorousjammer (2912 posts) -
Avatar image for mosdl
#5 Posted by mosdl (3422 posts) -

One major missing piece is dlc - a game resource has no idea what dlc is available. Also, dlc reviews are lumped in with the game review without a way to discern which is which.

Avatar image for beforeseven
#6 Posted by beforeseven (38 posts) -

I might be missing this, I'm not sure, but as far as I can see API search results do not return the game platform. I see this as kind of critical. Any chance of adding this?

Avatar image for lordandrew
#7 Posted by LordAndrew (14600 posts) -
@beforeseven: Good catch. You can use the api_detail_url or id to query the game resource and get more data. I've had to do that for most of the stuff I do since most of the fields I need are not available via the games resource.
Avatar image for beforeseven
#8 Posted by beforeseven (38 posts) -
@LordAndrew: Thanks for the response. Yea, I could send another 20 queries to the api, one for each of the search results, but I think that'll slow down my search mechanism (done via Ajax for instant feedback, so needs to be fast). Not to mention the fact that I could potentially be hammering the api unnecessarily.  
 
The game platform adds essential context to the search results, which is why I think it would be a good fit to be included then and there. Without it, you're seeing multiple results for a search string such as "Street Fighter" with no idea which one is most relevant to you. 
 
So, to reiterate: Any chance of it being added?
Avatar image for crstffr
#9 Posted by crstffr (2 posts) -

Hello, just to put my two cents in here, I'd like to also say that I'd love to see the sort be expanded upon, as well as the addition of a sort direction (ascending or descending).
 
Then to also have the console platform information in the result of a search query would be great too.  Having to run a loop and lookup game platforms for each result item is a bit clumsy.
 
Thanks and good work on the API thus far.

Avatar image for soulcutter
#10 Posted by Soulcutter (2 posts) -

 For security reasons, you should really consider adding an API Key Secret which can be used to sign API requests with. As it stands there's nothing stopping a person from stealing another person's API Key by snooping their app's http requests or even just googling ( http://www.google.com/search?q=api.giantbomb.com+api_key shows a few). It's a fairly standard feature of most developer APIs, and just a Good Idea™ (at least if you're trying to restrict access to your API at all).

Avatar image for andrewfader
#11 Posted by andrewfader (4 posts) -

Agree that platform data on search would be useful, rather than having to hammer the API with checks for every result.

Avatar image for entropic
#12 Posted by Entropic (2 posts) -

I would also echo the need for returning platform information in the Games resource... Including Genre, Publisher, and Developer would also be extremely helpful.

Avatar image for adamsadler
#13 Posted by adamsadler (2 posts) -

 As a UK based dev, I would love the ability to return UK box art (or any other country for that matter!) if available. Even if all images were available as URL's, with a caption, and we had to look for any with UK in the title (Halo CE for example, has a UK box art file which is not available via the API).
 
Hopefully this can be included in the proposed rewrite.
 
And I also would love the full genre, publisher and developer information within the standard search request - although I imagine there could be problems with queries where different devs have worked on different platforms etc - hanheld versions are often different devs.
 
Thanks for everything we have so far!

Avatar image for avenged
#14 Posted by Avenged (37 posts) -
@adamsadler: Searching for a particular game is not region specific. In order to get the UK box art of a game you need to dig deeper and look at the individual releases of the game. You will then see (if the image has been uploaded and is available for that region) the UK boxart. Hope that helps. 
Avatar image for subkamran
#15 Posted by subkamran (29 posts) -

After using the API for awhile now, I definitely agree we need better sorting, especially for searches. Right now I recursively do a search and fetch all results so I can reliably display results (i.e. exact matches go to the top and then sorted by popularity!).
 
In addition, I'd love to see the Achievements resource exposed (I don't even know how you get that info, Xbox API?).
 
I also would like to reduce round-trips to the API so a way to manually pre-fetch relationships would be awesome. Example, I would love to show platforms on search but in order to do that, I'd have to re-fetch the platform data per each game in the search... when search already takes 100-300ms, adding that again and again... not fun. I already am forced to do it when a user adds a game (I fetch platforms and soon am going to have to fetch releases too).

Avatar image for jackg100
#16 Posted by JackG100 (428 posts) -

I just wanted to make a list of great in game music, but noticed (I think) that GB doesnt grab specific tracks of soundtracks, which I find kinda sad since gamemusic is one of my favorite genres of music. :) So I guess Id like a dataentry for musical tracks out of the game OSTs.

Avatar image for pcx360
#17 Posted by pcx360 (2 posts) -

Hello,

I'm posting here but what I'm looking for might already be available in the current API and I simply overlooked (because it seems like what I'm doing is a bit overcomplicated compared to my very simple goal).

Basically I want, every few days, to execute a batch that retrieves all the Xbox 360 and XBLA games, along with their genre tags and their release date.

So right now I have to do it like this (there are some extra internal things for caching and such, but this is complete as far as the API is concerned):

  1. Get the list of games (/games/), filtering using "platforms" and "field_list" for id/game
  2. Get game details (/game/id), filtering using "field_list" for id, name, releases and genres
  3. Get release details (/release/id), filtering using "field_list" for game, platform and release_date

Could this be done in a simpler way? My main issue is really with the release date, which causes a lot of extra queries when that info could be available directly in /game/.

And if it can't be done, could it possibly be added to the API that the releases information for /game/ includes the platform, because some old games have been released on tons of platforms and in the end I have to do 20 or queries to find the right release...

Thanks

Avatar image for kzork
#18 Posted by KZork (2 posts) -

Hi,

what do you think about adding CORS header to your json responses?

I know, that you are supporting jsonp as a result format, but making plain json based requests/response handling would make life easier using javascript in modern browsers....

Thanks & cheers

Christian

Avatar image for dickverbunt
#19 Posted by dickverbunt (2 posts) -

My request:

Add "platforms" of the games to /search/

I realy miss that.

Avatar image for kungpung
#20 Posted by KungPung (2 posts) -

I'd really like to be able to get images with a specific tag (I only want screenshots, for example).

Avatar image for atholm
#21 Posted by atholm (42 posts) -

@kungpung said:

I'd really like to be able to get images with a specific tag (I only want screenshots, for example).

I second that. The API only allows retrieving 30 images from the gallery and I expect that these are the 30 last uploaded?

Avatar image for jonathanrezende
#22 Posted by jonathanrezende (14 posts) -

Hi,

I couldn't find these info in the game object, so I will put here as a request:

  • Multiplayer - Is the game able to player multiplayer? Maximum at same time?
  • Cooperative - Can I play with my friends the campaign of the game? Maximum at same time?
  • Languages - Which languages the game is translated on? English, japanese, portuguese?

Now, the next request is a very special one.
I couldn't find out a place to edit games in other language.
I am Brazilian. Here we speak portuguese.
I was thinking in building a brazilian version of the giantbomb but using the same resources as you, so we could have a unique and international database game.
But for that to happen, we need to be able to edit a "portuguese" version of the game. That includes videos and any text field, like title and description.

Thanks!
Jonathan

Avatar image for joshuacant
#23 Edited by joshuacant (14 posts) -

It would be really awesome to have dlc_release and dlc_releases like we do for full games. Or add DLC to the release/releases resources? Whatever makes the most sense.

Avatar image for sata
#24 Edited by Sata (34 posts) -

It's hard and sad to read this thread and see how it looks completely abandoned. No real answers from any mod or developer or anything.

I feel like I should still post anyway my request, even though I have no idea how much attention it would be given.

I was reading through the /api/promos/ output and it lists some of the podcasts that aren't on the bombcast rss feed. Understandably, sure. There should probably be another feed for ones that aren't "bombcasts".

However I noticed that their resource type is "podcast". That is when I saw that there is no "podcast" resource type on the API. I mean, no /api/podcasts/ or /api/podcast/id/. I don't understand why there isn't one. It looks like there should be one. So that's my request. A new API resource type that covers those podcasts.

Avatar image for mrpibb
#25 Posted by mrpibb (478 posts) -

sorry guys, we're in the midst of spinning up gamespot. We will start attacking most of these features around the end of September beginning of October. Apologies again for the lack of response, just been pretty busy.

Avatar image for darkbeatdk
#26 Edited by DarkbeatDK (2131 posts) -

How about allowing Instagram and Vine embedding in comments/forum posts?

Avatar image for chaser324
#27 Posted by Chaser324 (7825 posts) -

@darkbeatdk: That isn't an API feature request. That sort of forum feature request would be better suited for a thread on the Bug Reporting forum.

Moderator
Avatar image for jbn566
#28 Posted by jbn566 (86 posts) -

Is there a way to expose a user's custom list via the API? If not then consider it a feature request :)

I noticed lists are displayed on the right side of the games so it is not really a privacy thing right?

Avatar image for peteace
#29 Posted by peteace (30 posts) -

@mrpibb Is there anyway that we can get the list of DLC as part of the /game resource? I've had several users on Grouvee ask me to be able to add DLC to their collection.

Avatar image for atrament
#30 Posted by atrament (2 posts) -

Hi

I would like to join the crowd here calling for the fields genres and platforms in the search results. I know I can get it from the detailed info about a game but it means I have to make a special http request for every returned search result and that makes the search sooo slow :(

Avatar image for poonarge
#31 Edited by Poonarge (5 posts) -

Hi,

Would be nice to be able to search games by UPC/EAN

Regards,

Richard

Avatar image for abitdodgy
#32 Posted by abitdodgy (7 posts) -

Would you considering including genre in the releases? This would circumvent having to make an additional request to the game object.

Avatar image for alfaalex
#33 Posted by alfaalex (4 posts) -

Would it be possible to add the name of the game localized? For example:

en: Uncharted 3: Drake's Deception
fr: Uncharted 3 : L'Illusion de Drake
it: Uncharted 3: L'inganno di Drake
es: Uncharted 3: La traición de Drake
jp: アンチャーテッド 砂漠に眠るアトランティス

:D

Avatar image for abitdodgy
#34 Posted by abitdodgy (7 posts) -

I think something that is really useful is having the release type, if it's digital or CD.

Avatar image for mrdan
#35 Edited by mrdan (7 posts) -

Quick one: Access to the schedule for upcoming videos / streams? (i.e. what's in the upcoming box on the main page)

Avatar image for screamingfist
#37 Posted by ScreamingFist (392 posts) -

@mrdan said:

Quick one: Access to the schedule for upcoming videos / streams? (i.e. what's in the upcoming box on the main page)

I second this request =)

Avatar image for kurka
#38 Posted by kurka (9 posts) -

Is a bug fix considered a feature request? ;-) Ref http://www.giantbomb.com/forums/api-developers-3017/missing-image-wrong-url-in-game-result-1770921/#5

Avatar image for sigomatix
#39 Posted by sigomatix (5 posts) -

I've been trying to recreate this request http://www.giantbomb.com/games/?letter=&sortBy=&platform=94&genre=&theme=&minRating=4&rating=&region=&___developers=&___publishers=&fromYear=&toYear=

using the api (basically, all PC games with an average score above 4)...but I can't figure it out, it seems the API doesn't provide average scores for games.

So on the "games" resource with have the field "number_of_user_reviews", which is good but it would also be useful to have the average score of all these reviews...unless I've missed something !

Avatar image for crzylikefox13
#40 Edited by crzylikefox13 (6 posts) -
@theadmin said:

News:

Lots of great articles are posted by the crew and a feed to know when and what those are would be great. Resource: /news/ would be awesome along with the sorting above - for example: /news/?api_key="MY KEY"&sort=date_posted&creator=jeff&format=xml - This would return all news, sorted by the date it was posted, created by Jeff Gerstmann. This would allow for apps that could watch the news feeds and keep up to date on when new stuff was posted.

Yup. With Austin cranking out some killer articles, I'd like a better way to get to them!

Avatar image for screamingfist
#41 Posted by ScreamingFist (392 posts) -

@theadmin said:

News:

Lots of great articles are posted by the crew and a feed to know when and what those are would be great. Resource: /news/ would be awesome along with the sorting above - for example: /news/?api_key="MY KEY"&sort=date_posted&creator=jeff&format=xml - This would return all news, sorted by the date it was posted, created by Jeff Gerstmann. This would allow for apps that could watch the news feeds and keep up to date on when new stuff was posted.

Yup. With Austin cranking out some killer articles, I'd like a better way to get to them!

Yes I would LOVE for this to be added. I currently am using the API for a bot that I have running in IRC on the #GB_Gaming_Hub channel on QuakeNet. It automatically posts site updates and stream information to the channel via /promos/ and /videos/ but the /promos/ never has news in it so there is currently no way to grab news through the API. I wonder if there is a reason it hasn't been added since the original post was almost 6 years ago at this time. I may have to reprogram the entire bot to read from the RSS instead if nothing changes. =/

Avatar image for dinaga
#42 Posted by dinaga (1 posts) -

Hello,

First of all, thanks for an incredible API! It's really powerful, well documented and fun to use. :)

I just wanted to ask if you would mind adding something like a number_of_characters field in the search/ response. I am making a quiz app which would use the API to create custom character quizzes. User can search for games and add them to the list. After that, characters from those games would be used to create a custom quiz. The problem is, there are games with 0 characters which should be filtered out, but that is currently impossible (without sending too many game/id requests).

I can make some sort of local black-listing solution for this, but having number_of_characters count in the search/ response would really be awesome :)

Avatar image for b3b0p
#43 Edited by b3b0p (3 posts) -

I have one request. I'm not sure how difficult it is to implement on your end, but would be nice to get the same results as shown on the main website (only using as a reference example here). What I mean, as an example if you click "New Games" on the main site versus either using /games sorted by original_release_date:desc or /releases sorted by release_date:desc the results different and neither match anything on the website accurately skimming over my results anyway.

If I am doing it wrong, can you explain?

Also, one question/inquiry, would you rather have us download the entire data and only make occasional requests to get updates or would you rather have us use the API in closer to realtime? I ask for implementation issues on my end and in some cases some APIs / ToS don't allow storing the data.

If you would rather have us store the data with only the occasional update request can you provide a download in a readable format if not, I can provide one and keep it updated and put it on GitHub or something. I've written a few. It ended up being 10's of gigabytes including the images.

I am willing to offer any services as this is the closest half way decent (but still lacking, sorry guys) video game API that I can find. I'm in Austin, but not subverting your API.

EDIT: Guys, did you change something? I'm all of sudden get redirects in the responses. I noticed it seems to result from not including a trailing slash. I never noticed this previously.