Built-in tool
YouTube channels
Get a YouTube channel’s public details from its URL.
Endpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| urlstring · required | string | required | YouTube channel URL |
| limit_per_inputnumber · optional | number | optional | Limit the number of results per input |
| limit_multiple_resultsnumber · optional | number | optional | Limit the total number of results |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"elements"
],
"properties": {
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"Links": {
"type": "array",
"items": {
"type": "string"
},
"description": "External links from the channel's About page. Always an array — empty when the channel lists none."
},
"views": {
"type": "number"
},
"handle": {
"type": "string"
},
"Details": {
"anyOf": [
{},
{
"type": "null"
}
],
"description": "About-page details (location, join date, …). Always present: null when the channel has none."
},
"banner_img": {
"type": "string"
},
"identifier": {
"type": "string"
},
"top_videos": {
"type": "array"
},
"Description": {
"type": [
"string",
"null"
],
"description": "Channel description. Always present: null when the channel has none (e.g. an auto-generated \"- Topic\" channel)."
},
"has_podcast": {
"type": "boolean"
},
"subscribers": {
"type": "number"
},
"created_date": {
"type": "string"
},
"videos_count": {
"type": "number"
},
"profile_image": {
"type": "string"
},
"collaborations": {
"type": "array"
},
"featured_video": {
"type": "string"
},
"featured_channels": {
"type": "array"
}
},
"additionalProperties": true
}
},
"capReason": {
"enum": [
"tier_default",
"limit_clamped"
],
"type": "string"
},
"recordCap": {
"type": "number"
},
"truncated": {
"type": "boolean"
},
"capApplied": {
"type": "boolean"
},
"suggestion": {
"type": "string"
},
"totalElements": {
"type": "number"
}
},
"additionalProperties": true
}