YouTube Search API

Fast, filterable search for videos, channels, playlists & query-autocomplete.

API FAQ
Get API Key Buy Credits
What can you do?
Multi-filter YouTube search

Search videos, channels or playlists with one call.

Instant autocomplete hints

Get query suggestions as users type.

Date & duration filters

Publish-date & duration let you narrow down results fast.

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

Autocomplete 


POST https://api.yeb.to/v1/youtube/search/autocomplete
ParameterTypeReq.Description
api_key string yes Your API key
q string yes User query
hl string opt Language (ISO-639-1, default en)

Example

curl -X POST https://api.yeb.to/v1/youtube/search/autocomplete \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "q": "minecraft survival",
  "hl": "en"
}'

Response Example

{
  "query":        "minecraft survival",
  "lang":         "en",
  "suggestions":  ["minecraft survival house","minecraft survival guide"],
  "cnt_results":  2
}
{"error":"Missing \"q\" (query) parameter","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.

Search Videos 


POST https://api.yeb.to/v1/youtube/search/videos
ParameterTypeReq.Description
api_key string yes Your API key
q string yes Search keywords
limit int opt 1-50 (default 25)
sort string opt relevance | date | rating | title | viewCount
published_after date opt YYYY-MM-DD
published_before date opt YYYY-MM-DD
duration string opt any | short | medium | long

Example

curl -X POST https://api.yeb.to/v1/youtube/search/videos \
  -H "Content-Type: application/json" \
  -d '{
  "api_key":          "YOUR_KEY",
  "q":                "how to draw",
  "limit":            10,
  "sort":             "date",
  "published_after":  "2025-01-01",
  "duration":         "short"
}'

Response Example

{
  "cnt_results": 1,
  "videos":[
    {
      "id":          "dQw4w9WgXcQ",
      "title":       "How to draw a cat",
      "description": "Learn cat drawing…",
      "publishedAt": "2025-06-05T14:00:01Z",
      "channelId":   "UCabc123",
      "durationISO": "PT3M45S",
      "views":       15230
    }
  ]
}
{"error":"Missing \"q\" (query) parameter","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.

Search Channels 


POST https://api.yeb.to/v1/youtube/search/channels
ParameterTypeReq.Description
api_key string yes Your API key
q string yes Search keywords
limit int opt 1-50 (default 25)
sort string opt relevance | date | rating | title | viewCount
published_after date opt YYYY-MM-DD
published_before date opt YYYY-MM-DD

Example

curl -X POST https://api.yeb.to/v1/youtube/search/channels \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "q":       "technology reviews",
  "limit":   5
}'

Response Example

{
  "cnt_results": 2,
  "channels":[
    {
      "id":          "UC_x5XG1OV2P6uZZ5FSM9Ttw",
      "title":       "Google Developers",
      "description": "The official Google Developers channel.",
      "publishedAt": "2007-08-23T00:34:43Z",
      "thumb":       "https://yt3.ggpht.com/abc=s88-c-k-c0xffffffff-no-rj-mo"
    }
  ]
}
{"error":"Missing \"q\" (query) parameter","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.

Search Playlists 


POST https://api.yeb.to/v1/youtube/search/playlists
ParameterTypeReq.Description
api_key string yes Your API key
q string yes Search keywords
limit int opt 1-50 (default 25)
sort string opt relevance | date | rating | title | viewCount
published_after date opt YYYY-MM-DD
published_before date opt YYYY-MM-DD

Example

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

Response Example

{
  "cnt_results": 1,
  "playlists":[
    {
      "id":          "PL12345ABCDE",
      "title":       "Lo-Fi Chill Beats",
      "description": "Relaxing music to study to.",
      "publishedAt": "2024-11-17T10:00:00Z",
      "channelId":   "UCLofi123",
      "items":       35
    }
  ]
}
{"error":"Missing \"q\" (query) parameter","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

You may send up to 20 requests per second, in line with the global burst limit.

You can mix keyword, safe-search level, publish-date range, duration (videos), order, and a results limit (1-50).

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