Endpoints

14

Ungrouped Endpoints
14

What is the YouTube v3 API?

YouTube Data v3 API is a tool for developers to access and manipulate YouTube data, including videos, channels, and playlists, so they can create custom experiences for users. The YouTube Data API lets you incorporate functions normally executed on the YouTube website into your own website or application.

YouTube v3 API is available on the JoJ API marketplace. Subscribe with a single JoJ API key, call it through one gateway, and pay from one wallet — no separate account or contract with the provider.

YouTube v3 API endpoints

  • GET/activities/

    Activities

    Returns a list of channel activity events that match the request criteria. For example, you can retrieve events associated with a particular channel or with the user's own channel.

  • GET/captions/

    Captions

    Returns a list of caption tracks that are associated with a specified video.

  • GET/channels/

    Channels

    Returns a collection of zero or more `channel` resources that match the request criteria.

  • GET/channelSections/

    ChannelSections

    Returns a list of `channelSection` resources that match the API request criteria.

  • GET/comments/

    Comments

    Returns a list of comments that match the API request parameters.

  • GET/commentThreads/

    CommentThreads

    Returns a list of comment threads that match the API request parameters.

  • GET/i18nLanguages/

    I18nLanguages

    Returns a list of application languages that the YouTube website supports.

  • GET/i18nRegions/

    I18nRegions

    Returns a list of content regions that the YouTube website supports.

  • GET/playlistItems/

    PlaylistItems

    Returns a collection of playlist items that match the API request parameters. You can retrieve all of the playlist items in a specified playlist or retrieve one or more playlist items by their unique IDs.

  • GET/playlists/

    Playlists

    Returns a collection of playlists that match the API request parameters. For example, you can retrieve all playlists that the authenticated user owns, or you can retrieve one or more playlists by their unique IDs.

  • GET/search/

    Search

    Returns a collection of search results that match the query parameters specified in the API request. By default, a search result set identifies matching `video`, `channel` and `playlist` resources, but you can also configure queries to only retrieve a specific type of resource.

  • GET/subscriptions/

    Subscriptions

    Returns subscription resources that match the API request criteria.

  • GET/videoCategories/

    VideoCategories

    Returns a list of categories that can be associated with YouTube videos.

  • GET/videos/

    Videos

    Returns a list of videos that match the API request parameters.

Frequently asked questions about YouTube v3 API

How is usage counted?

One credit per request, flat, on every endpoint — unlike the official API's per-endpoint quota units. Note that pagination is billed per page: walking 10 pages of Search results with pageToken is 10 requests, not 1.

Do I need a Google Cloud project or a YouTube API key?

No. Authentication is a single X-JoJAPI-Key header issued from your JoJAPI dashboard. There is no project to create, no OAuth consent screen and no service account to manage.

Is this the official YouTube Data API?

No. It's an independent service, not affiliated with or endorsed by Google or YouTube. It deliberately mirrors the official v3 resource model — same resource names, part semantics and pagination — so existing code ports over with a base URL and header change, but it is a separate product with its own pricing and availability.

Can I upload videos, post comments or edit playlists?

No. Every endpoint is a read operation on public data. Anything that writes, or that requires a channel owner's OAuth grant to their private data, is out of scope.

What do 401, 402 and 429 responses mean?

They come from the JoJAPI gateway rather than the upstream API. 401 means the key is missing or invalid, 402 means you're out of credits, and 429 means you've hit your plan's rate limit. Other status codes are passed through from upstream.