YouTubeget/channel/details

Channel Details

Channel
Cost / request

$0.01

Response format

JSON

Protocol

REST

About this endpoint

Access YouTube data through agntdata: Channel Details. This endpoint get all available details about a given channel ID. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need video metadata, channel discovery, comments, subtitles, and recommendations programmatically.

Use cases

AI agents that need YouTube data in structured form
Analytics and monitoring pipelines for YouTube content
Research and GTM workflows that combine YouTube signals with other data

Parameters

NameInTypeRequiredDescription
channel_idquerystringrequiredDefault: UCXuqSBlHAE6Xw-yeJA0Tunw

Responses

Response

{
  "title": "Channel",
  "required": [
    "channel_id"
  ],
  "type": "object",
  "properties": {
    "channel_id": {
      "title": "Channel Id",
      "type": "string"
    },
    "title": {
      "title": "Title",
      "type": "string"
    },
    "description": {
      "title": "Description",
      "type": "string"
    },
    "subscriber_count": {
      "title": "Subscriber Count",
      "type": "string"
    },
    "links": {
      "title": "Links",
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "avatar": {
      "title": "Avatar",
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "banner": {
      "title": "Banner",
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "verified": {
      "title": "Verified",
      "type": "boolean",
      "default": false
    }
  }
}

Agent / Developer Schema

Machine-readable formats for integrating this endpoint into AI agents and toolchains.

{
  "operationId": "Channel_Details",
  "method": "get",
  "path": "/channel/details",
  "summary": "Channel Details",
  "description": "This endpoint get all available details about a given channel ID",
  "parameters": [
    {
      "name": "channel_id",
      "in": "query",
      "required": true,
      "schema": {
        "type": "string",
        "default": "UCXuqSBlHAE6Xw-yeJA0Tunw"
      }
    }
  ],
  "responses": [
    {
      "statusCode": "200",
      "description": "Response",
      "content": {
        "application/json": {
          "schema": {
            "title": "Channel",
            "required": [
              "channel_id"
            ],
            "type": "object",
            "properties": {
              "channel_id": {
                "title": "Channel Id",
                "type": "string"
              },
              "title": {
                "title": "Title",
                "type": "string"
              },
              "description": {
                "title": "Description",
                "type": "string"
              },
              "subscriber_count": {
                "title": "Subscriber Count",
                "type": "string"
              },
              "links": {
                "title": "Links",
                "type": "array",
                "items": {
                  "type": "object"
                }
              },
              "avatar": {
                "title": "Avatar",
                "type": "array",
                "items": {
                  "type": "object"
                }
              },
              "banner": {
                "title": "Banner",
                "type": "array",
                "items": {
                  "type": "object"
                }
              },
              "verified": {
                "title": "Verified",
                "type": "boolean",
                "default": false
              }
            }
          },
          "example": {
            "channel_id": "UCXuqSBlHAE6Xw-yeJA0Tunw",
            "title": "Linus Tech Tips",
            "description": "Looking for a Tech YouTuber?\n\nLinus Tech Tips is a passionate team of \"professionally curious\" experts in consumer technology and video production which aims to inform and educate people of all ages through our entertaining videos. We create product reviews, step-by-step computer build guides, and a variety of other tech-focused content.\n\nSchedule:\nNew videos every Saturday to Thursday @ 10:00am Pacific\nLive WAN Show podcasts every Friday @ ~5:00pm Pacific\n\n",
            "subscriber_count": "14.9M subscribers",
            "links": [
              {
                "name": "Merch",
                "endpoint": "https://www.lttstore.com/"
              },
              {
                "name": "Facebook",
                "endpoint": "http://www.facebook.com/LinusTech"
              },
              {
                "name": "Twitter",
                "endpoint": "http://twitter.com/LinusTech"
              },
              {
                "name": "Twitch",
                "endpoint": "https://www.twitch.tv/linustech"
              },
              {
                "name": "Instagram",
                "endpoint": "https://www.instagram.com/linustech"
              }
            ],
            "avatar": [
              {
                "url": "https://yt3.ggpht.com/ytc/AMLnZu_qOpMK0tGNMCnReaXVp4ZvmNEIXn9eKeBGA_x-wQ=s48-c-k-c0x00ffffff-no-rj",
                "width": 48,
                "height": 48
              },
              {
                "url": "https://yt3.ggpht.com/ytc/AMLnZu_qOpMK0tGNMCnReaXVp4ZvmNEIXn9eKeBGA_x-wQ=s88-c-k-c0x00ffffff-no-rj",
                "width": 88,
                "height": 88
              },
              {
                "url": "https://yt3.ggpht.com/ytc/AMLnZu_qOpMK0tGNMCnReaXVp4ZvmNEIXn9eKeBGA_x-wQ=s176-c-k-c0x00ffffff-no-rj",
                "width": 176,
                "height": 176
              }
            ],
            "banner": [
              {
                "url": "https://yt3.ggpht.com/NXaFVEkrkdGsQcjLvmI8iQuzKFVlZJX770IT4C77dmQr0PI5LpZuhATjJf2yWXYgBQP8EwVBgTk=w1060-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
                "width": 1060,
                "height": 175
              },
              {
                "url": "https://yt3.ggpht.com/NXaFVEkrkdGsQcjLvmI8iQuzKFVlZJX770IT4C77dmQr0PI5LpZuhATjJf2yWXYgBQP8EwVBgTk=w1138-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
                "width": 1138,
                "height": 188
              },
              {
                "url": "https://yt3.ggpht.com/NXaFVEkrkdGsQcjLvmI8iQuzKFVlZJX770IT4C77dmQr0PI5LpZuhATjJf2yWXYgBQP8EwVBgTk=w1707-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
                "width": 1707,
                "height": 283
              },
              {
                "url": "https://yt3.ggpht.com/NXaFVEkrkdGsQcjLvmI8iQuzKFVlZJX770IT4C77dmQr0PI5LpZuhATjJf2yWXYgBQP8EwVBgTk=w2120-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
                "width": 2120,
                "height": 351
              },
              {
                "url": "https://yt3.ggpht.com/NXaFVEkrkdGsQcjLvmI8iQuzKFVlZJX770IT4C77dmQr0PI5LpZuhATjJf2yWXYgBQP8EwVBgTk=w2276-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
                "width": 2276,
                "height": 377
              },
              {
                "url": "https://yt3.ggpht.com/NXaFVEkrkdGsQcjLvmI8iQuzKFVlZJX770IT4C77dmQr0PI5LpZuhATjJf2yWXYgBQP8EwVBgTk=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
                "width": 2560,
                "height": 424
              }
            ],
            "verified": true
          }
        }
      }
    },
    {
      "statusCode": "422",
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "title": "HTTPValidationError",
            "type": "object",
            "properties": {
              "detail": {
                "title": "Detail",
                "type": "array",
                "items": {
                  "title": "ValidationError",
                  "required": [
                    "loc",
                    "msg",
                    "type"
                  ],
                  "type": "object",
                  "properties": {
                    "loc": {
                      "title": "Location",
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "integer"
                          }
                        ]
                      }
                    },
                    "msg": {
                      "title": "Message",
                      "type": "string"
                    },
                    "type": {
                      "title": "Error Type",
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "example": {
            "detail": [
              {
                "loc": [],
                "msg": "",
                "type": ""
              }
            ]
          }
        }
      }
    }
  ]
}

Pricing

$0.01per successful request

Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.

Related endpoints

Start using this endpoint

Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.

YouTube APIYouTube data APIchannel details APIAI agents data APIYouTube APIYouTube data APIYouTube for AI agents