YouTube Video API

Access extended YouTube video data, including video info, comments, statistics, engagement, and AI-powered audits.

API FAQ
Get API Key Buy Credits
What can you do?
Detailed Video Data

Get title, description, publish date, duration, category, language, and more.

Statistics & Engagement

Fetch view, like, and comment counts, plus calculate engagement rate.

AI-Powered Audit

Receive GPT-based suggestions to improve your video’s SEO and engagement.

Try Live
99.9 % Uptime
— Response
20 req/s
0.009 Credits / request

Basic Information 


POST https://api.yeb.to/v1/youtube/video/information
ParameterTypeReq.Description
api_key string yes Your API key
video string yes Video ID (11 chars) **or** full YouTube URL

Example

curl -X POST https://api.yeb.to/v1/youtube/video/information \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","video":"dQw4w9WgXcQ"}'

Response Example

{
  "video": {
    "id":           "dQw4w9WgXcQ",
    "title":        "Rick Astley – Never Gonna Give You Up",
    "description":  "The official video for…",
    "duration":     "PT3M32S",
    "publishedAt":  "1987-10-25T00:00:00Z",
    "categoryId":   "10",
    "categoryName": "Music",
    "channelId":    "UCuAXFkgsw1L7xaCfnd5JJOw",
    "channelTitle": "Official Rick Astley",
    "statistics": {
      "viewCount":    "1 440 000 000",
      "likeCount":    "15 600 000",
      "commentCount": "1 900 000"
    },
    "thumbnails": { … },
    "contentDetails": { … },
    "snippet": { … }
  }
}
{"error":"Video not found","code":404}

Response Codes

CodeDescription
200 SuccessRequest processed OK.
400 Bad RequestInput validation failed.
401 UnauthorizedMissing / wrong API key.
403 ForbiddenKey inactive or not allowed.
429 Rate LimitToo many requests.
500 Server ErrorUnexpected failure.

Video Tags 


POST https://api.yeb.to/v1/youtube/video/tags
ParameterTypeReq.Description
api_key string yes Your API key
video string yes Video ID or URL

Example

curl -X POST https://api.yeb.to/v1/youtube/video/tags \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","video":"dQw4w9WgXcQ"}'

Response Example

{"tags":["80s","Rick Astley","Official Video"]}
{"error":"Tags unavailable","code":204}

Response Codes

CodeDescription
200 SuccessRequest processed OK.
400 Bad RequestInput validation failed.
401 UnauthorizedMissing / wrong API key.
403 ForbiddenKey inactive or not allowed.
429 Rate LimitToo many requests.
500 Server ErrorUnexpected failure.

Top Comments 


POST https://api.yeb.to/v1/youtube/video/comments
ParameterTypeReq.Description
api_key string yes Your API key
video string yes Video ID or URL
limit int opt 1-100, default 50
order string opt relevance (default) | time
repliesOn bool opt true = include replies

Example

curl -X POST https://api.yeb.to/v1/youtube/video/comments \
  -H "Content-Type: application/json" \
  -d '{
    "api_key":   "YOUR_KEY",
    "video":     "dQw4w9WgXcQ",
    "limit":     25,
    "order":     "time",
    "repliesOn": true
  }'

Response Example

{
  "cnt_comments": 25,
  "comments": [
    {
      "id":"Ugzx…",
      "author":"Alice",
      "text":"Still a banger!",
      "likes":42,
      "published":"2025-06-01T12:34:00Z",
      "replies":{
        "cnt":2,
        "items":[{"id":"Ugy…","author":"Bob","text":"100 %","likes":3,"published":"…"}]
      }
    }
  ]
}
{"error":"Comments disabled","code":403}

Response Codes

CodeDescription
200 SuccessRequest processed OK.
400 Bad RequestInput validation failed.
401 UnauthorizedMissing / wrong API key.
403 ForbiddenKey inactive or not allowed.
429 Rate LimitToo many requests.
500 Server ErrorUnexpected failure.

Settings / Status 


POST https://api.yeb.to/v1/youtube/video/settings
ParameterTypeReq.Description
api_key string yes Your API key
video string yes Video ID or URL

Example

curl -X POST https://api.yeb.to/v1/youtube/video/settings \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","video":"dQw4w9WgXcQ"}'

Response Example

{
   "settings": {
    "privacyStatus":       "public",
    "license":             "creativeCommon",
    "embeddable":          true,
       "publicStatsViewable": true,
   "disableComments":     false,
    "madeForKids":         false,
    "ageLimit":            false,
    "projection":          "rectangular",
   "recordingDate":       "2025-07-14",
    "locationDescription": "Berlin, Germany",

    "categoryId":          "25",
    "categoryName":        "News & Politics",
    "language":            "bg",
    "region":              "bg"
  }}
{"error":"Video not found","code":404}

Response Codes

CodeDescription
200 SuccessRequest processed OK.
400 Bad RequestInput validation failed.
401 UnauthorizedMissing / wrong API key.
403 ForbiddenKey inactive or not allowed.
429 Rate LimitToo many requests.
500 Server ErrorUnexpected failure.

Restrictions 


POST https://api.yeb.to/v1/youtube/video/restricted
ParameterTypeReq.Description
api_key string yes Your API key
video string yes Video ID or URL

Example

curl -X POST https://api.yeb.to/v1/youtube/video/restricted \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","video":"dQw4w9WgXcQ"}'

Response Example

{
    "restrictions": {
      "geoBlocked":    false,
      "ageRestricted": false,
      "blocked":       [],
      "allowed":       [],
      "embeddable":    true,
      "madeForKids":   false,
      "license":       "youtube",
      "privacyStatus": "public"
    }
  }
{"error":"Video removed","code":410}

Response Codes

CodeDescription
200 SuccessRequest processed OK.
400 Bad RequestInput validation failed.
401 UnauthorizedMissing / wrong API key.
403 ForbiddenKey inactive or not allowed.
429 Rate LimitToo many requests.
500 Server ErrorUnexpected failure.

Trending Check 


POST https://api.yeb.to/v1/youtube/video/trending
ParameterTypeReq.Description
api_key string yes Your API key
video string yes Video ID or URL
country string opt ISO country (US default)
categoryId string opt Optional numeric ID

Example

curl -X POST https://api.yeb.to/v1/youtube/video/trending \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","video":"dQw4w9WgXcQ","country":"GB"}'

Response Example

{
    "trending": {
      "country":      "GB",
      "categoryId":   null,
      "categoryName": null,
      "isTrending":   true,
      "position":     17
    }
  }
{"error":"Quota exceeded","code":429}

Response Codes

CodeDescription
200 SuccessRequest processed OK.
400 Bad RequestInput validation failed.
401 UnauthorizedMissing / wrong API key.
403 ForbiddenKey inactive or not allowed.
429 Rate LimitToo many requests.
500 Server ErrorUnexpected failure.

Statistics 


POST https://api.yeb.to/v1/youtube/video/statistics
ParameterTypeReq.Description
api_key string yes Your API key
video string yes Video ID or URL

Example

curl -X POST https://api.yeb.to/v1/youtube/video/statistics \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","video":"dQw4w9WgXcQ"}'

Response Example

{
  "statistics": {
    "views"      : 1580000000,
    "likes"      : 15400000,
    "comments"   : 1120000,
    "favourites" : 45000
  }
}
{"error":"Video not found","code":404}

Response Codes

CodeDescription
200 SuccessRequest processed OK.
400 Bad RequestInput validation failed.
401 UnauthorizedMissing / wrong API key.
403 ForbiddenKey inactive or not allowed.
429 Rate LimitToo many requests.
500 Server ErrorUnexpected failure.

Watch-Time Estimate 


POST https://api.yeb.to/v1/youtube/video/watchtime-estimate
ParameterTypeReq.Description
api_key string yes Your API key
video string yes Video ID or URL
avgRetention float opt Override (0-1). e.g. 0.55

Example

curl -X POST https://api.yeb.to/v1/youtube/video/watchtime-estimate \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","video":"dQw4w9WgXcQ"}'

Response Example

{
  "watchtime": {
    "views":        739,
    "durationSec":  1733,
    "avgRetention": 0.30,
    "perViewSec":   520,
    "seconds":      384206,
    "watchHours":   106.7

}
}
{"error":"Video not found","code":404}

Response Codes

CodeDescription
200 SuccessRequest processed OK.
400 Bad RequestInput validation failed.
401 UnauthorizedMissing / wrong API key.
403 ForbiddenKey inactive or not allowed.
429 Rate LimitToo many requests.
500 Server ErrorUnexpected failure.

Engagement Rate 


POST https://api.yeb.to/v1/youtube/video/engagement-rate
ParameterTypeReq.Description
api_key string yes Your API key
video string yes Video ID or URL

Example

curl -X POST https://api.yeb.to/v1/youtube/video/engagement-rate \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","video":"dQw4w9WgXcQ"}'

Response Example

{
  "engagement": {
    "views":     1580000000,
    "likes":     15400000,
    "comments":  1120000,
    "rate":      0.011
  }
}
{"error":"Video not found","code":404}

Response Codes

CodeDescription
200 SuccessRequest processed OK.
400 Bad RequestInput validation failed.
401 UnauthorizedMissing / wrong API key.
403 ForbiddenKey inactive or not allowed.
429 Rate LimitToo many requests.
500 Server ErrorUnexpected failure.

Thumbnail URLs 


POST https://api.yeb.to/v1/youtube/video/thumbnail
ParameterTypeReq.Description
api_key string yes Your API key
video string yes Video ID or URL

Example

curl -X POST https://api.yeb.to/v1/youtube/video/thumbnail \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","video":"dQw4w9WgXcQ"}'

Response Example

{
  "thumbnails": {
    "default":  "https://i.ytimg.com/vi/dQw4w9WgXcQ/default.jpg",
    "medium":   "https://i.ytimg.com/vi/dQw4w9WgXcQ/mqdefault.jpg",
    "high":     "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
    "standard": "https://i.ytimg.com/vi/dQw4w9WgXcQ/sddefault.jpg",
    "maxres":   "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"
  }
}
{"error":"Video not found","code":404}

Response Codes

CodeDescription
200 SuccessRequest processed OK.
400 Bad RequestInput validation failed.
401 UnauthorizedMissing / wrong API key.
403 ForbiddenKey inactive or not allowed.
429 Rate LimitToo many requests.
500 Server ErrorUnexpected failure.

Playlists Featuring This Video 


POST https://api.yeb.to/v1/youtube/video/search-playlists
ParameterTypeReq.Description
api_key string yes Your API key
video string yes Video ID or URL
limit int opt 1-50, default 50

Example

curl -X POST https://api.yeb.to/v1/youtube/video/search-playlists \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","video":"dQw4w9WgXcQ","limit":10}'

Response Example

{
  "cnt_playlists": 2,
  "playlists": [
    {"id":"PL123…","title":"Best 80s Hits","url":"https://…","found":true},
    {"id":"PL456…","title":"Rick Astley Favs","url":"https://…","found":true}
  ]
}
{"error":"Video not found","code":404}

Response Codes

CodeDescription
200 SuccessRequest processed OK.
400 Bad RequestInput validation failed.
401 UnauthorizedMissing / wrong API key.
403 ForbiddenKey inactive or not allowed.
429 Rate LimitToo many requests.
500 Server ErrorUnexpected failure.

Extract Links 


POST https://api.yeb.to/v1/youtube/video/extract-links
ParameterTypeReq.Description
api_key string yes Your API key
video string yes Video ID or URL

Example

curl -X POST https://api.yeb.to/v1/youtube/video/extract-links \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","video":"dQw4w9WgXcQ"}'

Response Example

Response Codes

CodeDescription
200 SuccessRequest processed OK.
400 Bad RequestInput validation failed.
401 UnauthorizedMissing / wrong API key.
403 ForbiddenKey inactive or not allowed.
429 Rate LimitToo many requests.
500 Server ErrorUnexpected failure.

Extract Hashtags 


POST https://api.yeb.to/v1/youtube/video/extract-hashtags
ParameterTypeReq.Description
api_key string yes Your API key
video string yes Video ID or URL

Example

curl -X POST https://api.yeb.to/v1/youtube/video/extract-hashtags \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","video":"dQw4w9WgXcQ"}'

Response Example

{"cnt_hashtags":2,"hashtags":["#RickAstley","#NeverGonnaGiveYouUp"]}
{"error":"Video not found","code":404}

Response Codes

CodeDescription
200 SuccessRequest processed OK.
400 Bad RequestInput validation failed.
401 UnauthorizedMissing / wrong API key.
403 ForbiddenKey inactive or not allowed.
429 Rate LimitToo many requests.
500 Server ErrorUnexpected failure.

AI-Powered Audit 


POST https://api.yeb.to/v1/youtube/video/audit
ParameterTypeReq.Description
api_key string yes Your API key
video string yes Video ID or URL
sample int opt Baseline sample size (10-100, default 50)

Example

curl -X POST https://api.yeb.to/v1/youtube/video/audit \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","video":"dQw4w9WgXcQ"}'

Response Example

{
  "videoId":"dQw4w9WgXcQ",
  "views":1580000000,
  "likes":15400000,
  "comments":1120000,
  "engagementRate":0.011,
  "channelMedianViews":420000,
  "isAboveMedian":true,
  "aiRecommendations":"• Use a more curiosity-driven title…"
}
{"error":"Video not found","code":404}

Response Codes

CodeDescription
200 SuccessRequest processed OK.
400 Bad RequestInput validation failed.
401 UnauthorizedMissing / wrong API key.
403 ForbiddenKey inactive or not allowed.
429 Rate LimitToo many requests.
500 Server ErrorUnexpected failure.

Frequently Asked Questions

You can fetch titles, descriptions, tags, thumbnails, comments (with replies), statistics (views, likes, comments), audience engagement, video chapters, playlists containing a video, and even request an AI-powered content audit.

Both are supported! You can pass a YouTube video ID (e.g., dQw4w9WgXcQ) or a full YouTube video URL.

The API returns a clear error message and HTTP status code (e.g., 404 for not found, 403 for restricted/private videos).

Up to 5 requests / second per key. No daily or monthly caps – just pay as you go.

We operate on a credit system. Buy once – credits never expire and there are no subscriptions.

Every HTTP call is one request; each request consumes a number of credits depending on the endpoint.

Yes, they never expire until you spend them (but they are non-refundable).

Credits are non-refundable. Please buy only what you need – you can top-up any time.

Prices are set in credits, not dollars. Each endpoint lists its own cost – see the “Credits / request” badge above.
← Back to APIs