---
title: "YouTube Channel Details"
method: GET
path: "/v1/youtube/channel"
tags: ["YouTube"]
---

# YouTube Channel Details

`GET /v1/youtube/channel`

## Request

- Base URL: `https://apidirect.io`
- URL: `https://apidirect.io/v1/youtube/channel`
- Auth: API key in header `X-API-Key`

Get detailed information about a YouTube channel by channel ID, URL, or name/handle. Returns the channel name, description, subscriber count, video count, exact total view count, country, creation date, verification status, external links, profile picture, and banner. Provide exactly one of id, url, or name.

**Price:** $0.005 per request. **Free tier:** 50 requests/month.

## Query parameters

- `id` string
- `url` string
- `name` string

## Response `200`

Successful response

- YoutubeChannelDetailsResponse: Inferred from a live response. Any field can be null or absent, and new fields may be added at any time.
  - `channel` object, nullable
    - `channel_id` string, nullable
    - `channel_name` string, nullable
    - `description` string, nullable
    - `subscriber_count` string, nullable
    - `video_count` string, nullable
    - `view_count` number, nullable
    - `country` string, nullable
    - `creation_date` string, nullable
    - `verified` boolean, nullable
    - `has_business_email` boolean, nullable
    - `links` object[], nullable
      - `name` string, nullable
      - `url` string, nullable
    - `profile_pic_url` string, nullable
    - `banner` string, nullable
    - `url` string, nullable

## Other responses

- `400`: Bad request: missing or invalid parameters
- `401`: Unauthorized: invalid or missing API key
- `402`: Free tier used up for this endpoint and no payment method on file (`payment_required`).
- `403`: Account blocked after a failed payment (`account_blocked`).
- `404`: Channel not found
- `429`: Rate limit exceeded or too many concurrent requests
- `500`: Internal server error
- `502`: Temporary failure retrieving YouTube data. Please retry shortly.
- `503`: Service temporarily unavailable. Please retry shortly.
- `504`: The request timed out

---

[API](https://skmtc.dev/apidirect/apis/api-direct.md) · [All operations](https://skmtc.dev/apidirect/apis/api-direct/llms.txt) · [OpenAPI document](https://skmtc.dev/apidirect/apis/api-direct/revisions/fa8c68d70bd0?raw)