YouTube API

YouTube Channel API

Look up a channel by handle, id or URL and get its public profile as JSON: subscribers, video count, description, keywords and avatar.

  • 100 free credits
  • No card needed
  • No Google Cloud project or OAuth
curl "https://pipefetch.com/v1/youtube/channel?channel=%40mkbhd" \
  -H "x-api-key: YOUR_API_KEY"
The response

What you get

  • The channel id, handle, title and URL
  • Subscriber count and video count
  • Description and channel keywords
  • Avatar and the channel's RSS feed URL
200 OK · application/json
{
  "data": {
    "id": "UCBJycsmduvYEL83R_U4JriQ",
    "handle": "@mkbhd",
    "title": "Marques Brownlee",
    "url": "https://www.youtube.com/@mkbhd",
    "description": "MKBHD: Quality Tech Videos | YouTuber | Geek | Consumer Electronics | Tech Head | Internet Personality!\n\nbusiness@MKBHD.com\n\nNYC",
    "keywords": [
      "MKBHD",
      "MarquesBrownlee"
    ],
    "subscriberCount": 21400000,
    "videoCount": 1800,
    "avatarUrl": "https://yt3.googleusercontent.com/qu4TmIaYUlS41-dJ9gZ7DUR3nilvmB5_11i6OKSdvNnBNiyOusZP1bMN6ICnuxtjFBb6ioKgRQ=s900-c-k-c0x00ffffff-no-rj",
    "rssUrl": "https://www.youtube.com/feeds/videos.xml?channel_id=UCBJycsmduvYEL83R_U4JriQ",
    "isFamilySafe": true
  },
  "credits": {
    "used": 1,
    "remaining": 99
  }
}
Reference

One GET request

Everything the endpoint accepts. The full reference, with the complete example response, is in the docs.

GET/v1/youtube/channel

Costs 1 credit per request. Only requests that return data are charged.

Parameters

NameTypeDescription
channelrequired string Channel handle (@mkbhd), channel id (UC…) or any channel URL.

Good to know

  • Subscriber and video counts are the rounded figures YouTube publishes (21.4M, 1.8K).

Open the reference

Use cases

What people build with it

  • Resolve a handle to a channel id

    Turn @handles and old /c/ or /user/ links into the stable UC… channel id other tools need.

  • Vet creators

    Check audience size and what a channel says about itself before you reach out.

  • Monitor growth

    Store the subscriber count every day and chart how a channel develops.

Pricing

Buy credits once. Use them whenever.

This endpoint costs 1 credit per request, and a request that returns no data costs nothing. Move the slider to see what your volume costs.

5,000requests a month
5005,00050,000250,000
5,000video transcripts
5,000searches or video lookups
100,000comments

One credit is one request that returns data. Requests that return nothing are free.

Best fit
Builder pack
12,000 credits, one-time payment
$29once
  • $2.42 per 1,000 requests
  • About $12.08 a month at this pace
  • Lasts about 2.4 months at this pace
  • Credits never expire
Start with 100 free credits

See all packs and what a credit buys

FAQ

Questions and answers

Are subscriber counts exact?

They are the figures YouTube publishes, which are rounded for every channel (21.4M, not 21,412,907). Nobody outside the channel owner can see the exact number.

How can I identify the channel?

By handle (@mkbhd), by channel id (UC…) or by any channel URL, including the older /c/ and /user/ forms.

Can I get the channel's videos too?

Yes, with the channel videos endpoint, which returns the latest uploads together with the channel.

What does a request cost?

One request costs 1 credit. Credit packs start at $9 for 3,000 credits, never expire, and a request that returns no data is not charged. New accounts get 100 free credits without a card.

Guides

Step-by-step guides

More

More YouTube APIs

Make your first request in a minute

Sign in, copy your key and call an endpoint. Your account starts with 100 free credits.