YouTube metadata API for AI assistants

The YouTube metadata API takes a channel URL, a channel ID, or a playlist ID and returns channel details, playlists, activities, member lists, or localization settings. The reply is JSON, so your assistant reads the fields directly.

What it does

You pass one input, and the provider returns what it has. Some endpoints convert a channel URL into the channel ID, others list the videos in a playlist, and others return channel sections, activities, or member lists. Each endpoint answers a different question about YouTube accounts and content organization.

The API reads public channels and playlists only. It does not log in or see anything that YouTube hides from logged-out visitors.

How a Joshu assistant uses it

When you hand Joshu a YouTube channel link, it converts the URL to the channel ID and saves it in a note with the other creator IDs you track.

When you ask Joshu what videos are in a playlist, it pulls the list and writes the title and link of each one into a shared doc.

When you want to track a channel's activity before a partnership meeting, Joshu gets the recent uploads and community posts and adds a note to your calendar event with the last three things the channel published.

Choosing a provider

Providers differ in which metadata they return. Pick one that returns playlist contents when you need the list of videos, pick one that returns channel activities when you need recent uploads, and pick one that converts URLs to IDs when you have links and need numeric identifiers.

curl https://hello.joshu.me/api/router/call \
  -H "Authorization: Bearer $JOSHU_ROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "scrapecreators.x.v1-youtube-playlist",
    "params": {
      "playlist_id": "<playlist ID>"
    }
  }'