YouTube Trending API

Fetch “most-popular” videos for any country or category in real-time.

API FAQ
Get API Key Buy Credits
What can you do?
Grab daily trending feed

Pull the official “Most-Popular” list straight from YouTube.

Filter by any country

Specify any ISO-3166 country code (US, GB, IN…).

Category & limit options

Narrow down to Music (10), Gaming (20) & more, max 50 results.

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

Trending List 


POST https://api.yeb.to/v1/youtube/trending
ParameterTypeReq.Description
api_key string yes Your API key
country string opt ISO-3166 code (default US)
category int opt YouTube category ID (e.g. 10 = Music)
limit int opt 1-50 results (default 20)

Example

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

Response Example

{
  "data": {
    "country":     "GB",
    "category":    "10",
    "cnt_results": 1,
    "videos": [
      {
        "id":           "abc123XYZ",
        "title":        "Top UK Hit 2025",
        "description":  "Official video…",
        "channelId":    "UCmusic",
        "channelTitle": "HitsNow",
        "publishedAt":  "2025-07-06T17:01:02Z",
        "categoryId":   "10",
        "durationISO":  "PT3M12S",
        "viewCount":    4500000,
        "likeCount":    128000,
        "commentCount": 9800,
        "thumb":        "https://i.ytimg.com/vi/abc123XYZ/hqdefault.jpg"
      }
    ]
  }
}
{"error":"Invalid country code. Use ISO 3166-1 alpha-2 format.","code":400}

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

YouTube itself refreshes the list roughly every 15 minutes; the API surfaces whatever is live at request time.

They are numeric: 10 = Music, 17 = Sports, 20 = Gaming, 24 = Entertainment, etc. See YouTube Data API docs for the full table.

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