Skip to main content
POST
Get YouTube channel details

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

Headers

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

Request Body

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

Responses

Success (200)

Returns comprehensive channel information including metadata, statistics, and social links.
  • 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.

Bad Gateway (502)

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

Internal Server Error (500)

Returned if there’s an unexpected server error.

Example Request

Example Response

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
country
string | null
avatar
object

Structured avatar data as returned by YouTube.