↑ ↓ to move ↵ to open
YouTube API · Endpoint

YouTube Channel API

Get a channel from its link, handle or ID: name, description, subscribers, video count, keywords and tabs.

  • 1 credit per call
  • Failed calls are free
  • Updated
  • youtube.channel.get
Response completed
{  "title": "NASA",  "channel_handle": "@NASA",  "channel_id": "UCLA_DiR1FfKNvjuUpBHmylQ",  "description": "NASA's mission is to pioneer the future in space exploration, scientific discovery, and aeronautics research.\r\n\r\nTo do that, we have worked a…",  "external_id": "UCLA_DiR1FfKNvjuUpBHmylQ",  "is_family_safe": true,  "keywords": "nasa space iss shuttle 50th astronauts planets earth rockets hubble telescopes NASA TV galaxy apollo gemini mercury sta Moon Artemis \"solar…",  "subscriber_count": 15100000,  "subscriber_count_approximate": true,  "subscriber_count_text": "15.1M subscribers",  "url": "https://www.youtube.com/channel/UCLA_DiR1FfKNvjuUpBHmylQ",  "vanity_url": "http://www.youtube.com/@NASA",  "video_count": 6100,  "video_count_approximate": true,  "video_count_text": "6.1K videos",  "available_tabs": [    "Home",    "Videos"  ]}
Try it live, free
Input

What you send

The input object of the request, with every field the endpoint accepts.

FieldTypeRequiredWhat it doesExample
url string yes The channel's link, its handle such as @NASA, or its channel ID. @NASA
Response

Fields it returns

What each record in the response holds, with the values from the sample above.

FieldTypeWhat it isExample
title string The channel's name. NASA
channel_handle string The channel's handle. @NASA
subscriber_count integer Subscribers as a number, read from what YouTube shows. 15,100,000
video_count integer Videos as a number, read from what YouTube shows. 6100
description string The channel's description. NASA's mission is to pioneer the future in space exploration, s…
is_family_safe boolean Whether YouTube marks it as family safe. true
available_tabs array The tabs the channel page has. Home, Videos, Shorts
channel_id string YouTube's ID for the channel. UCLA_DiR1FfKNvjuUpBHmylQ
external_id string YouTube's ID for the channel. UCLA_DiR1FfKNvjuUpBHmylQ
keywords string Keywords set by the channel. nasa space iss shuttle 50th astronauts planets earth rockets hu…
subscriber_count_approximate boolean Whether the subscriber count comes from a rounded figure such as 15.1M. true
subscriber_count_text string Subscribers as YouTube writes them. 15.1M subscribers
url string The channel's link. https://www.youtube.com/channel/UCLA_DiR1FfKNvjuUpBHmylQ
vanity_url string The channel's short link. http://www.youtube.com/@NASA
video_count_approximate boolean Whether the video count comes from a rounded figure such as 6.1K. true
video_count_text string Videos as YouTube writes them. 6.1K videos
REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "youtube.channel.get",  "input": {    "url": "@NASA"  }}'
In your AI agent Claude · Cursor · any MCP client
1Add the Upscrape MCP server
https://data.upscrape.com/mcp
2Ask for the data in plain words

With Upscrape, look up the @NASA channel on YouTube. How many subscribers and videos does it have?

The agent finds the endpoint, shows you the price, and runs it with your credits.
YouTube

More from the YouTube API

Same data, other platforms

The same data from other platforms

Questions

YouTube Channel API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.
How much does the YouTube Channel API cost?

1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.

What do I send?

Send url. The input fields below list every option with its type and limits.

Do I need a YouTube login?

No. It reads public YouTube data; nothing runs on your account.

Can my AI agent call it?

Yes, over MCP: the agent finds youtube.channel.get, checks its price and runs it with the same credits as the REST API.

Get started

Your first YouTube call is free.

Up to 100 free credits to start, no card needed.