Home » Desktop Java » youtube » Query YouTube videos using YouTube Java API

About Byron Kiourtzoglou

Avatar photo
Byron is a master software engineer working in the IT and Telecom domains. He is an applications developer in a wide variety of applications/services. He is currently acting as the team leader and technical architect for a proprietary service creation and integration platform for both the IT and Telecom industries in addition to a in-house big data real-time analytics solution. He is always fascinated by SOA, middleware services and mobile development. Byron is co-founder and Executive Editor at Java Code Geeks.

Query YouTube videos using YouTube Java API

In this example we are going to demonstrate how to query YouTube videos using YouTube Java API. This is particularly useful when you want to embed YouTube support in your application.

In order to query YouTube videos using YouTube Java API you should follows these steps:

First we create two model classes which will be used to hold information about the feeds and the videos. The first one is called YouTubeMedia and contains the media content URL and the media content type. The second one is named YouTubeVideo and contains all the information regarding a specific video (URL, embedded player URL, thumbnails and instances of YoutTubeMedia).

The source code for these is the following:

package com.javacodegeeks.youtube.model;

public class YouTubeMedia {

     private String location;
     private String type;

     public YouTubeMedia(String location, String type) {


    this.location = location;

    this.type = type;

     public String getLocation() {

    return location;
     public void setLocation(String location) {

    this.location = location;

     public String getType() {

    return type;
     public void setType(String type) {

    this.type = type;

package com.javacodegeeks.youtube.model;

import java.util.List;

public class YouTubeVideo {

     private List<String> thumbnails;
     private List<YouTubeMedia> medias;
     private String webPlayerUrl;
     private String embeddedWebPlayerUrl;

     public List<String> getThumbnails() {

    return thumbnails;
     public void setThumbnails(List<String> thumbnails) {

    this.thumbnails = thumbnails;

     public List<YouTubeMedia> getMedias() {

    return medias;
     public void setMedias(List<YouTubeMedia> medias) {

   this.medias = medias;

     public String getWebPlayerUrl() {

    return webPlayerUrl;
     public void setWebPlayerUrl(String webPlayerUrl) {

this.webPlayerUrl = webPlayerUrl;

     public String getEmbeddedWebPlayerUrl() {

    return embeddedWebPlayerUrl;
     public void setEmbeddedWebPlayerUrl(String embeddedWebPlayerUrl) {

    this.embeddedWebPlayerUrl = embeddedWebPlayerUrl;

     public String retrieveHttpLocation() {

    if (medias==null || medias.isEmpty()) {

   return null;


    for (YouTubeMedia media : medias) {

   String location = media.getLocation();

   if (location.startsWith("http")) {

  return location;



    return null;



Finally, the YouTubeManager class is presented. It can be used to perform search queries and returns instances of the YouTubeVideo model class with all the relevant information. It also creates the appropriate embedded web player URL. Here is the code for that class:

package com.javacodegeeks.youtube;

import java.net.URL;
import java.util.LinkedList;
import java.util.List;

import com.google.gdata.client.youtube.YouTubeQuery;
import com.google.gdata.client.youtube.YouTubeService;
import com.google.gdata.data.media.mediarss.MediaThumbnail;
import com.google.gdata.data.youtube.VideoEntry;
import com.google.gdata.data.youtube.VideoFeed;
import com.google.gdata.data.youtube.YouTubeMediaContent;
import com.google.gdata.data.youtube.YouTubeMediaGroup;
import com.javacodegeeks.youtube.model.YouTubeMedia;
import com.javacodegeeks.youtube.model.YouTubeVideo;

public class YouTubeManager {

    private static final String YOUTUBE_URL = "http://gdata.youtube.com/feeds/api/videos";
    private static final String YOUTUBE_EMBEDDED_URL = "http://www.youtube.com/v/";

    private String clientID;

    public YouTubeManager(String clientID) {

  this.clientID = clientID;

     public List<YouTubeVideo> retrieveVideos(String textQuery, int maxResults, boolean filter, int timeout) throws Exception {

  YouTubeService service = new YouTubeService(clientID);

  service.setConnectTimeout(timeout); // millis

  YouTubeQuery query = new YouTubeQuery(new URL(YOUTUBE_URL));





  VideoFeed videoFeed = service.query(query, VideoFeed.class);  

  List<VideoEntry> videos = videoFeed.getEntries();

  return convertVideos(videos);


    private List<YouTubeVideo> convertVideos(List<VideoEntry> videos) {

  List<YouTubeVideo> youtubeVideosList = new LinkedList<YouTubeVideo>();

  for (VideoEntry videoEntry : videos) {

YouTubeVideo ytv = new YouTubeVideo();

YouTubeMediaGroup mediaGroup = videoEntry.getMediaGroup();

String webPlayerUrl = mediaGroup.getPlayer().getUrl();


String query = "?v=";

int index = webPlayerUrl.indexOf(query);

String embeddedWebPlayerUrl = webPlayerUrl.substring(index+query.length());

embeddedWebPlayerUrl = YOUTUBE_EMBEDDED_URL + embeddedWebPlayerUrl;


List<String> thumbnails = new LinkedList<String>();

for (MediaThumbnail mediaThumbnail : mediaGroup.getThumbnails()) {




List<YouTubeMedia> medias = new LinkedList<YouTubeMedia>();

for (YouTubeMediaContent mediaContent : mediaGroup.getYouTubeContents()) {

    medias.add(new YouTubeMedia(mediaContent.getUrl(), mediaContent.getType()));





  return youtubeVideosList;



In order to test our class, as well provide a show case example, we create the following simple test class:

package com.javacodegeeks.youtube.test;

import java.util.List;

import com.javacodegeeks.youtube.YouTubeManager;
import com.javacodegeeks.youtube.model.YouTubeVideo;

public class YouTubeTester {

    public static void main(String[] args) throws Exception {

  String clientID = "JavaCodeGeeks";

  String textQuery = "java code";

  int maxResults = 10;

  boolean filter = true;

  int timeout = 2000;

  YouTubeManager ym = new YouTubeManager(clientID);

  List<YouTubeVideo> videos = ym.retrieveVideos(textQuery, maxResults, filter, timeout);

  for (YouTubeVideo youtubeVideo : videos) {



for (String thumbnail : youtubeVideo.getThumbnails()) {

    System.out.println("t" + thumbnail);







This was an example on how to query YouTube videos using YouTube Java API.

Related Article:

Do you want to know how to develop your skillset to become a Java Rockstar?

Subscribe to our newsletter to start Rocking right now!

To get you started we give you our best selling eBooks for FREE!


1. JPA Mini Book

2. JVM Troubleshooting Guide

3. JUnit Tutorial for Unit Testing

4. Java Annotations Tutorial

5. Java Interview Questions

6. Spring Interview Questions

7. Android UI Design


and many more ....


Receive Java & Developer job alerts in your Area

I have read and agree to the terms & conditions


Notify of

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Inline Feedbacks
View all comments