Click here to see your recently viewed pages and most viewed pages.
Hide

Getting Started with YouTube APIs and Tools

YouTube provides several APIs and tools that let you integrate the YouTube experience into your website, mobile app, or device. This document is designed to help you to determine which APIs and tools best suit your needs.

  • The Players and Player APIs section identifies ways you can let your users watch YouTube videos in your application and control the playback experience.

  • The Data and Analytics APIs section briefly describes APIs that let your application access features and data normally available on the YouTube website.

  • The Buttons, Widgets, and Tools section describes other tools you can use to add YouTube functionality to your app or to test YouTube APIs.

Players and Player APIs

With an embedded YouTube player, you can integrate the YouTube video playback experience directly in your web page or application. You can use player parameters to customize the player's appearance, and you can also use Player APIs to control the player directly from your web page or app.

  • The player parameters document explains how to embed a YouTube player in your app and customize the playback experience by adding parameters to the player URL. For example, you can set the player's interface language with the hl parameter or play a video repeatedly using the loop parameter.

    Without writing any code, you can embed a player that plays either a video, search results for a specified query term, or any playlist, such as a list of videos uploaded to a your channel.

  • If users will control the player from your app, then you also need to use one of the Player APIs. These APIs let you change the videos being played, control video playback, change the player volume, and more. APIs also fire events to notify your app of changes in the player.

    YouTube supports the following Player APIs and tools:

    Web

    Android

    Use the YouTube Android Player API to incorporate video playback functionality and customize the playback experience in an Android app.

    iOS

    Use the YouTube iOS Helper Library to allow an iOS application to control a YouTube player.

The player demo lets you preview an embedded player and test different parameter settings.

Note: Embedded players must have a viewport that is at least 200px by 200px. If the player displays controls, it must be large enough to fully display the controls without shrinking the viewport below the minimum size. We recommend 16:9 players be at least 480 pixels wide and 270 pixels tall.

Data and Analytics APIs

YouTube supports several APIs that let your application's users interact with features normally available on the YouTube website or in YouTube apps:

  • The YouTube Data API (v3) lets you perform many operations available on the YouTube website and enables your app to have a deep integration with YouTube. Using this API, you can search for content, upload videos, create playlists, manage subscriptions, and much more.

  • The YouTube Analytics API lets your app retrieve viewing statistics, popularity metrics, and viewer demographics for YouTube videos and channels. A content owner who participates in the YouTube Partner Program can also use the API to retrieve aggregated Analytics data for all YouTube channels linked to its content owner account.

  • The YouTube Live Streaming API lets you create, update, and manage live events on YouTube. Using the API, you can schedule events (broadcasts) and associate them with video streams, which represent the actual broadcast content.

YouTube APIs provide rich client library support and are integrated with Google's common API infrastructure.

Buttons, Widgets, and Tools

YouTube provides several other widgets and tools designed to help you more easily incorporate YouTube functionality into your application:

  • The YouTube Subscribe Button lets people subscribe to your YouTube channel with a single click and without having to leave your site to log in or confirm their subscriptions.

  • The APIs Explorer lets you submit API requests and see the API responses for the YouTube Data API (v3), YouTube Analytics API, and YouTube Live Streaming API.

  • The YouTube player demo lets you see how different player parameters affect the appearance of a player. It also shows you which Player API functions are called when you preview an embedded player and test different parameter settings.