Skip to main content
POST
/
api
/
v1
/
youtube
/
channel
Get YouTube channel details
curl --request POST \
  --url https://app.dumplingai.com/api/v1/youtube/channel \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "handle": "@ThePatMcAfeeShow"
}
'
{
  "channelId": "<string>",
  "channel": "<string>",
  "name": "<string>",
  "description": "<string>",
  "subscriberCount": 123,
  "subscriberCountText": "<string>",
  "videoCountText": "<string>",
  "viewCountText": "<string>",
  "joinedDateText": "<string>",
  "tags": "<string>",
  "email": "<string>",
  "store": "<string>",
  "twitter": "<string>",
  "instagram": "<string>",
  "links": [
    "<string>"
  ],
  "country": "<string>",
  "avatar": {}
}

​
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": "[email protected]",
  "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": "[email protected]",
  "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 10 credits 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

Identify the YouTube channel to fetch. Provide at least one identifier (channelId, handle, or url).

​
channelId
string

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
​
tags
string | null
​
email
string | null
​
store
string<uri> | null
​
twitter
string<uri> | null
​
instagram
string<uri> | null
​
links
string<uri>[]
​
country
string | null
​
avatar
object

Structured avatar data as returned by YouTube.