YouTube Data API v3 API

by googleapis.com

Overview

The YouTube Data API v3 is an API that provides access to YouTube data, such as videos, playlists, and channels.

YouTube Data API v3 is an analytics API from googleapis.com. Requests are authenticated with OAuth. It is served over HTTPS. Its OpenAPI description documents 76 endpoints.

At a glance

Authentication: OAuth
HTTPS: Yes
CORS: Unknown
Category: Analytics
Base URL: https://youtube.googleapis.com/
Version: v3
Endpoints: 76
OpenAPI: Specification ↗
Spec updated: 2023-04-21

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL

curl -X GET "https://youtube.googleapis.com/youtube/v3/activities" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"

JavaScript

const response = await fetch("https://youtube.googleapis.com/youtube/v3/activities", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
  },
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.request(
    "GET",
    "https://youtube.googleapis.com/youtube/v3/activities",
    headers={
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
    },
    timeout=30,
)
print(response.json())

Endpoints

Method	Path	What it does
POST	`/youtube/v3/abuseReports`	Inserts a new resource into this collection.
GET	`/youtube/v3/activities`	Retrieves a list of resources, possibly filtered.
GET	`/youtube/v3/captions`	Retrieves a list of resources, possibly filtered.
POST	`/youtube/v3/captions`	Inserts a new resource into this collection.
PUT	`/youtube/v3/captions`	Updates an existing resource.
DELETE	`/youtube/v3/captions`	Deletes a resource.
GET	`/youtube/v3/captions/{id}`	Downloads a caption track.
POST	`/youtube/v3/channelBanners/insert`	Inserts a new resource into this collection.
GET	`/youtube/v3/channelSections`	Retrieves a list of resources, possibly filtered.
POST	`/youtube/v3/channelSections`	Inserts a new resource into this collection.
PUT	`/youtube/v3/channelSections`	Updates an existing resource.
DELETE	`/youtube/v3/channelSections`	Deletes a resource.
GET	`/youtube/v3/channels`	Retrieves a list of resources, possibly filtered.
PUT	`/youtube/v3/channels`	Updates an existing resource.
GET	`/youtube/v3/commentThreads`	Retrieves a list of resources, possibly filtered.
POST	`/youtube/v3/commentThreads`	Inserts a new resource into this collection.
PUT	`/youtube/v3/commentThreads`	Updates an existing resource.
GET	`/youtube/v3/comments`	Retrieves a list of resources, possibly filtered.
POST	`/youtube/v3/comments`	Inserts a new resource into this collection.
PUT	`/youtube/v3/comments`	Updates an existing resource.
DELETE	`/youtube/v3/comments`	Deletes a resource.
POST	`/youtube/v3/comments/markAsSpam`	Expresses the caller's opinion that one or more comments should be flagged as spam.
POST	`/youtube/v3/comments/setModerationStatus`	Sets the moderation status of one or more comments.
GET	`/youtube/v3/i18nLanguages`	Retrieves a list of resources, possibly filtered.
GET	`/youtube/v3/i18nRegions`	Retrieves a list of resources, possibly filtered.
GET	`/youtube/v3/liveBroadcasts`	Retrieve the list of broadcasts associated with the given channel.
POST	`/youtube/v3/liveBroadcasts`	Inserts a new stream for the authenticated user.
PUT	`/youtube/v3/liveBroadcasts`	Updates an existing broadcast for the authenticated user.
DELETE	`/youtube/v3/liveBroadcasts`	Delete a given broadcast.
POST	`/youtube/v3/liveBroadcasts/bind`	Bind a broadcast to a stream.
POST	`/youtube/v3/liveBroadcasts/cuepoint`	Insert cuepoints in a broadcast
POST	`/youtube/v3/liveBroadcasts/transition`	Transition a broadcast to a given status.
POST	`/youtube/v3/liveChat/bans`	Inserts a new resource into this collection.
DELETE	`/youtube/v3/liveChat/bans`	Deletes a chat ban.
GET	`/youtube/v3/liveChat/messages`	Retrieves a list of resources, possibly filtered.
POST	`/youtube/v3/liveChat/messages`	Inserts a new resource into this collection.
DELETE	`/youtube/v3/liveChat/messages`	Deletes a chat message.
GET	`/youtube/v3/liveChat/moderators`	Retrieves a list of resources, possibly filtered.
POST	`/youtube/v3/liveChat/moderators`	Inserts a new resource into this collection.
DELETE	`/youtube/v3/liveChat/moderators`	Deletes a chat moderator.
GET	`/youtube/v3/liveStreams`	Retrieve the list of streams associated with the given channel. --
POST	`/youtube/v3/liveStreams`	Inserts a new stream for the authenticated user.
PUT	`/youtube/v3/liveStreams`	Updates an existing stream for the authenticated user.
DELETE	`/youtube/v3/liveStreams`	Deletes an existing stream for the authenticated user.
GET	`/youtube/v3/members`	Retrieves a list of members that match the request criteria for a channel.
GET	`/youtube/v3/membershipsLevels`	Retrieves a list of all pricing levels offered by a creator to the fans.
GET	`/youtube/v3/playlistItems`	Retrieves a list of resources, possibly filtered.
POST	`/youtube/v3/playlistItems`	Inserts a new resource into this collection.
PUT	`/youtube/v3/playlistItems`	Updates an existing resource.
DELETE	`/youtube/v3/playlistItems`	Deletes a resource.
GET	`/youtube/v3/playlists`	Retrieves a list of resources, possibly filtered.
POST	`/youtube/v3/playlists`	Inserts a new resource into this collection.
PUT	`/youtube/v3/playlists`	Updates an existing resource.
DELETE	`/youtube/v3/playlists`	Deletes a resource.
GET	`/youtube/v3/search`	Retrieves a list of search resources
GET	`/youtube/v3/subscriptions`	Retrieves a list of resources, possibly filtered.
POST	`/youtube/v3/subscriptions`	Inserts a new resource into this collection.
DELETE	`/youtube/v3/subscriptions`	Deletes a resource.
GET	`/youtube/v3/superChatEvents`	Retrieves a list of resources, possibly filtered.
POST	`/youtube/v3/tests`	POST method.
GET	`/youtube/v3/thirdPartyLinks`	Retrieves a list of resources, possibly filtered.
POST	`/youtube/v3/thirdPartyLinks`	Inserts a new resource into this collection.
PUT	`/youtube/v3/thirdPartyLinks`	Updates an existing resource.
DELETE	`/youtube/v3/thirdPartyLinks`	Deletes a resource.
POST	`/youtube/v3/thumbnails/set`	As this is not an insert in a strict sense (it supports uploading/setting of a thumbnail for multiple videos, which doesn't result in creation of a single resou
GET	`/youtube/v3/videoAbuseReportReasons`	Retrieves a list of resources, possibly filtered.
GET	`/youtube/v3/videoCategories`	Retrieves a list of resources, possibly filtered.
GET	`/youtube/v3/videos`	Retrieves a list of resources, possibly filtered.
POST	`/youtube/v3/videos`	Inserts a new resource into this collection.
PUT	`/youtube/v3/videos`	Updates an existing resource.
DELETE	`/youtube/v3/videos`	Deletes a resource.
GET	`/youtube/v3/videos/getRating`	Retrieves the ratings that the authorized user gave to a list of specified videos.
POST	`/youtube/v3/videos/rate`	Adds a like or dislike rating to a video or removes a rating from a video.
POST	`/youtube/v3/videos/reportAbuse`	Report abuse for a video.
POST	`/youtube/v3/watermarks/set`	Allows upload of watermark image and setting it for a channel.
POST	`/youtube/v3/watermarks/unset`	Allows removal of channel watermark.

Questions

Does the YouTube Data API v3 API need an API key?

Yes. The YouTube Data API v3 API uses OAuth authentication; the documentation explains how to get credentials.

Does the YouTube Data API v3 API support HTTPS?

Yes, the YouTube Data API v3 API is served over HTTPS.

How many endpoints does the YouTube Data API v3 API have?

Its OpenAPI description lists 76 endpoints in version v3. All of them are shown on this page.

What are alternatives to the YouTube Data API v3 API?

Other Analytics APIs include Google Play Integrity API, versionhistory.googleapis.com API, Doc Converter, Perspective Comment Analyzer API, Safe Browsing API.

Compare alternatives →

Google Play Integrity API

Analytics

The Play Integrity API helps you check that you're interacting with your genuine app on a genuine Android device powered by Google Play services. The Play Integrity API has replaced SafetyNet Attestation and Android Device Verification.

OAuth1 endpoints

versionhistory.googleapis.com API

Analytics

Version History API - Prod

No auth4 endpoints

Doc Converter

Analytics

This api converts file formats of OpenXml and OpenOffice documents formats to vector files (e.g., svg)

No auth1 endpoints

Perspective Comment Analyzer API

Analytics

The Perspective Comment Analyzer API provides information about the potential impact of a comment on a conversation (e.g. it can provide a score for the "toxicity" of a comment). Users can leverage the "SuggestCommentScore" method to submit corrections to improve Perspective over time. Users can set the "doNotStore" flag to ensure that all submitted comments are automatically deleted after scores are returned.

OAuth2 endpoints

Safe Browsing API

Analytics

Enables client applications to check web resources (most commonly URLs) against Google-generated lists of unsafe web resources. The Safe Browsing APIs are for non-commercial use only. If you need to use APIs to detect malicious URLs for commercial purposes – meaning “for sale or revenue-generating purposes” – please refer to the Web Risk API.

No auth7 endpoints

Web Fonts Developer API

Analytics

The Google Web Fonts Developer API lets you retrieve information about web fonts served by Google.

No auth1 endpoints

Listed from APIs.guru (CC0).

Overview

At a glance

Make a first request

Endpoints

Questions

Similar analytics APIs

Google Play Integrity API

versionhistory.googleapis.com API

Doc Converter

Perspective Comment Analyzer API

Safe Browsing API

Web Fonts Developer API