NOTICE: Video_Type & Video Types Endpoint Deprecation!!

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!

@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)

@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.

@rheediculous: That's great to hear, thanks!

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?

@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?

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

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

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.