Get YouTube Channel

Description

This endpoint retrieves comprehensive information about a YouTube channel including subscriber count, video count, description, and social media links. Can accept channel ID, handle, or full URL as input.

Endpoint

POST https://app.dumplingai.com/api/v1/youtube/channel

Headers

Content-Type: application/json
Authorization: Bearer <API_KEY> (required)

Request Body

{
  "channelId": "string", // Optional. YouTube channel ID (e.g., "UCxcTeAKWJca6XyJ37_ZoKIQ")
  "handle": "string", // Optional. YouTube channel handle (e.g., "@channelname")
  "url": "string" // Optional. Full YouTube channel URL
}

Note: At least one of channelId, handle, or url is required.

Responses

Success (200)

Returns comprehensive channel information including metadata, statistics, and social links.

{
  "channelId": "UCxcTeAKWJca6XyJ37_ZoKIQ",
  "channel": "@ThePatMcAfeeShow",
  "name": "The Pat McAfee Show",
  "avatar": {
    "image": {
      "sources": [
        {
          "url": "https://yt3.googleusercontent.com/ytc/AIdro_k4...",
          "width": 48,
          "height": 48
        },
        {
          "url": "https://yt3.googleusercontent.com/ytc/AIdro_k4...",
          "width": 88,
          "height": 88
        }
      ],
      "processor": {
        "borderImageProcessor": {
          "circular": true
        }
      }
    },
    "avatarImageSize": "48",
    "loggingDirectives": {
      "trackingParams": "CAEQAA==",
      "visibility": {
        "types": "12"
      }
    }
  },
  "description": "The Pat McAfee Show features Pat McAfee...",
  "subscriberCount": 4200000,
  "subscriberCountText": "4.2M",
  "videoCountText": "1,234",
  "viewCountText": "1.2B",
  "joinedDateText": "Jan 1, 2018",
  "tags": "sports, entertainment, comedy",
  "email": "business@patmcafeeshow.com",
  "store": "https://patmcafeeshow.store",
  "twitter": "https://twitter.com/PatMcAfeeShow",
  "instagram": "https://instagram.com/patmcafeeshow",
  "links": [
    "https://patmcafeeshow.com",
    "https://youtube.com/@ThePatMcAfeeShow"
  ],
  "country": "United States"
}

Content-Type: application/json
X-RateLimit-Limit: The rate limit for the user
X-RateLimit-Remaining: The remaining number of requests for the user

Bad Request (400)

Returned if the request is invalid or missing required parameters.

{
  "error": "At least one parameter is required: 'channelId', 'handle', or 'url'"
}

Bad Gateway (502)

Returned if the external service is unavailable or returns invalid data.

{
  "error": "Failed to retrieve YouTube channel information"
}

Internal Server Error (500)

Returned if there’s an unexpected server error.

{
  "error": "An unexpected server error occurred while fetching YouTube channel information"
}

Example Request

curl -X POST https://app.dumplingai.com/api/v1/youtube/channel \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
  "handle": "@ThePatMcAfeeShow"
}'

Example Response

{
  "channelId": "UCxcTeAKWJca6XyJ37_ZoKIQ",
  "channel": "@ThePatMcAfeeShow",
  "name": "The Pat McAfee Show",
  "avatar": {
    "image": {
      "sources": [
        {
          "url": "https://yt3.googleusercontent.com/ytc/AIdro_k4...",
          "width": 48,
          "height": 48
        }
      ],
      "processor": {
        "borderImageProcessor": {
          "circular": true
        }
      }
    },
    "avatarImageSize": "48",
    "loggingDirectives": {
      "trackingParams": "CAEQAA==",
      "visibility": {
        "types": "12"
      }
    }
  },
  "description": "The Pat McAfee Show features Pat McAfee...",
  "subscriberCount": 4200000,
  "subscriberCountText": "4.2M",
  "videoCountText": "1,234",
  "viewCountText": "1.2B",
  "joinedDateText": "Jan 1, 2018",
  "tags": "sports, entertainment, comedy",
  "email": "business@patmcafeeshow.com",
  "store": "https://patmcafeeshow.store",
  "twitter": "https://twitter.com/PatMcAfeeShow",
  "instagram": "https://instagram.com/patmcafeeshow",
  "links": [
    "https://patmcafeeshow.com"
  ],
  "country": "United States"
}

Notes

At least one parameter (channelId, handle, or url) must be provided
Channel handles should include the @ symbol (e.g., “@channelname”)
Channel URLs can be in formats like https://youtube.com/@channelname or https://youtube.com/channel/UC...
The response includes comprehensive channel metadata, statistics, and social media links
Some channels may not have all optional fields populated (email, store, social media links)
This endpoint uses 1 credit per request

Rate Limiting

Rate limit headers (X-RateLimit-Limit and X-RateLimit-Remaining) are included in the response to indicate the user’s current rate limit status.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Option 1
Option 2
Option 3

Identify the YouTube channel to fetch.

channelId

string

required

YouTube channel ID (e.g., UCxcTeAKWJca6XyJ37_ZoKIQ).

handle

string

YouTube handle beginning with @.

url

string<uri>

Full YouTube channel URL.

requestSource

enum<string>

Optional identifier describing where the API request originated.

Available options:

API,

WEB,

MAKE_DOT_COM,

ZAPIER,

N8N,

PLAYGROUND,

DEFAULT_AUTOMATION,

AGENT_PREVIEW,

AGENT_LIVE,

AUTOPILOT,

STUDIO

Response

Channel metadata retrieved.

Detailed metadata about a YouTube channel.

channelId

string

channel

string

Canonical handle with leading @.

name

string

description

string

subscriberCount

integer | null

subscriberCountText

string | null

videoCountText

string | null

viewCountText

string | null

joinedDateText

string | null

API Documentation

Endpoints

Description

Endpoint

Headers

Request Body

Responses

Success (200)

Bad Request (400)

Bad Gateway (502)

Internal Server Error (500)

Example Request

Example Response

Notes

Rate Limiting

Authorizations

Body

Response

API Documentation

Endpoints

​Description

​Endpoint

​Headers

​Request Body

​Responses

​Success (200)

​Bad Request (400)

​Bad Gateway (502)

​Internal Server Error (500)

​Example Request

​Example Response

​Notes

​Rate Limiting

Authorizations

Body

Response

Description

Endpoint

Headers

Request Body

Responses

Success (200)

Bad Request (400)

Bad Gateway (502)

Internal Server Error (500)

Example Request

Example Response

Notes

Rate Limiting