Avatar image for rheediculous
#1 Posted by rheediculous (22 posts) -

Hey guys,

We have deprecated the "video_type" and "video_types" endpoints in our API. As you may know, we have converted existing video types (Quick Looks, Giant Bombcast, etc), to Video Shows.

We've provided the "video_show" and "video_shows" endpoints to retrieve access to the new live converted shows (Quick Looks, Giant Bombcast, etc), and the "video_category" and "video_categories" endpoints for traditional video categories (Reviews, Latest, Events, etc).

Please switch over to the new API endpoints as soon as possible, as we will be removing the "video_type" and "video_types" endpoints in the not-so-distant future.

http://www.giantbomb.com/api/documentation#toc-0-46

Happy Dev'ing!

Staff
Avatar image for alecgdouglas
#2 Posted by alecgdouglas (96 posts) -

@rheediculous: Hi there - are there any plans to include the "video_show" along with the category in the "video_type" field of a video?

For example, Jar Time videos have a "video_type" of "premium" but I don't see any way to link the Jar Time videos returned by a /video query to the "Jar Time" video_show.

<video>

<api_detail_url>http://www.giantbomb.com/api/video/2300-11876/</api_detail_url>

<deck>Why is this mic slightly blown out even though the gain is turned all the way down? That's just one of the questions that aren't answered in this masterfully produced video.</deck>

<hd_url>http://v.giantbomb.com/2017/02/17/mc_jeffqa_20170216_4000.mp4</hd_url>

<high_url>http://v.giantbomb.com/2017/02/17/mc_jeffqa_20170216_3200.mp4</high_url>

<low_url>http://v.giantbomb.com/2017/02/17/mc_jeffqa_20170216_1800.mp4</low_url>

<embed_player>http://www.giantbomb.com/videos/embed/11876/</embed_player>

<id>11876</id>

<length_seconds>4808</length_seconds>

<name>Jar Time w/ Jeff 02/16/2017</name>

<publish_date>2017-02-16 18:00:00</publish_date>

<site_detail_url>http://www.giantbomb.com/videos/jar-time-w-jeff-02162017/2300-11876/</site_detail_url>

<url>mc_jeffqa_20170216.flv</url>

<image>

<icon_url>http://www.giantbomb.com/api/image/square_avatar/2919980-vlcsnap-error506.png</icon_url>

<medium_url>http://www.giantbomb.com/api/image/scale_medium/2919980-vlcsnap-error506.png</medium_url>

<screen_url>http://www.giantbomb.com/api/image/screen_medium/2919980-vlcsnap-error506.png</screen_url>

<small_url>http://www.giantbomb.com/api/image/scale_small/2919980-vlcsnap-error506.png</small_url>

<super_url>http://www.giantbomb.com/api/image/scale_large/2919980-vlcsnap-error506.png</super_url>

<thumb_url>http://www.giantbomb.com/api/image/scale_avatar/2919980-vlcsnap-error506.png</thumb_url>

<tiny_url>http://www.giantbomb.com/api/image/square_mini/2919980-vlcsnap-error506.png</tiny_url>

</image>

<user>jeff</user>

<video_type>Premium</video_type>

<youtube_id/>

</video>

The reason it would be useful to have the video_shows included is for better categorization of videos in apps. I would love to be able to have a Jar Time category in my app but unless I do that manually (yuck) I can only categorize these types of videos as "premium". This is equally true for the other shows as well (Blue Bombin', Old Games, GBE Playdate, etc.).

(Also consider renaming the "video_type" field on videos to something else since the "video_type" API is deprecated)

Avatar image for rheediculous
#3 Posted by rheediculous (22 posts) -

@alecgdouglas: Great questions! Adding video_show and video_shows to the video API is currently in development right now. Should be coming very soon. Hope that helps you out in your development.

Let me know if you've got anymore questions.

Staff
Avatar image for alecgdouglas
#4 Edited by alecgdouglas (96 posts) -
Avatar image for scott-r
#5 Edited by Scott-R (11 posts) -

Will it be possible to filter the response from /videos by video_category or video_show at some point? For me just now, it seems like video_type is the only filter that works for filtering videos by show

EDIT: While I'm here, it looks like the /video_shows API is returning relative URLs for site_detail_url, whereas video_categories is returning full URLs for the same field. Is this intentional?

Avatar image for szlifier
#6 Posted by Szlifier (1475 posts) -

@rheediculous: How can I request, for example, Quick Looks only? Right now I'm using:

&filter=video_type:3

I tried using video_category and video_show instead without success. Is it being deprecated as well?

Avatar image for frobie
#7 Posted by frobie (224 posts) -

Hey duders,

These changes are now on production:

  • video_show URLs should now be absolute.
  • Changed the name field in video_show to title. Added image and position. Position is the ordering seen in the drop down menu above.
  • Added video_show and video_categories as fields to the video endpoint: http://www.giantbomb.com/api/video/2300-11793/
  • Example of filtering for the show Quick Looks: http://www.giantbomb.com/api/videos/?filter=video_show:3
  • Example of filtering for the category Premium: http://www.giantbomb.com/api/vidoes/?filter=video_categories:10
  • Added DLCs to the game endpoint: http://www.giantbomb.com/api/game/3030-20504/
  • To get a list of DLCs: http://www.giantbomb.com/api/dlcs/
  • Detail view of a DLC: http://www.giantbomb.com/api/dlc/3020-1/
  • Example of filtering for Xbox 360 DLCs : http://www.giantbomb.com/api/dlcs/?filter=platform:20
  • Example of filtering for Fallout 3 DLCs on the PS3: http://www.giantbomb.com/api/dlcs/?filter=game:20504,platform:35

Happy consuming,

-frobie

Staff
Avatar image for scott-r
#8 Posted by Scott-R (11 posts) -

Are there any plans to add images for video_categories? Or will they remain video_show specific?

At the moment, the "image" field is being returned for video_categories, but it always seems to be null for me

Avatar image for frobie
#9 Posted by frobie (224 posts) -

That is a good catch. There doesn't need to be an image field for video_categories. It'll be removed in a future update.

Staff