YouTube Search API
Api Details
Endpoint
GET https://serpapi.abcproxy.com/search
Description Retrieve comprehensive user profile including
basic info
,account status
and optionalpermission sets
.
youtube_search
Up to 20 search results for a search term of your choice.
youtube_search_max
Up to 700 search results for a search term of your choice.
Request
HTTP Request
curl -X GET "https://serpapi.abcproxy.com/search" \
-d "engine=youtube" \
-d "q=coffee" \
-d "no_cache=false" \
-d "api_key=YOUR_API_KEY"
API Parameters
Search Query
search_query
string
Yes
Parameter defines the search query. You can use anything that you would use in a regular YouTube search.
coffee
Localization
gl
string
No
Parameter defines the country to use for the Youtube search. It's a two-letter country code. (e.g., us
for the United States, uk
for United Kingdom, or fr
for France) Head to the Google countries page for a full list of supported Google countries.
us
hl
string
No
Parameter defines the language to use for the Youtube search. It's a two-letter language code. (e.g., en
for English, es
for Spanish, or fr
for French). Head to the Google languages page for a full list of supported Google languages.
en
Filters Parameters
upload_date
string
No
Filters videos by when they were uploaded. Available values are: today
, last_hour
, this_week
, this_month
, this_year
.
today
type
string
No
Returns results by content type. Available values are: video
, channel
, playlist
, movie
.
video
duration
string
No
Content duration in minutes. Available values are
>4
sort_by
string
No
Determines how search results are ordered. Available values are rating
, relevance
, view_count
,upload_date
.
relevance
is360
boolean
No
Returns 360-degree videos in search results.
false
is3d
boolean
No
Returns 3D videos in search results.
false
is4k
boolean
No
Returns 4K resolution videos in search results.
false
creative_commons
boolean
No
Returns only videos with Creative Commons licenses.
false
hd
boolean
No
Returns high-definition videos in search results.
false
hdr
boolean
No
Returns HDR (High Dynamic Range) videos in search results.
false
live
boolean
No
Returns live streams in search results.
false
area
boolean
No
Returns videos with location information.
false
purchased
boolean
No
Returns purchased content in search results.
false
subtitles
boolean
No
Returns videos with subtitles or closed captions.
false
vr180
boolean
No
Returns VR180 format videos in search results.
false
Advanced Google Play Parameters
sp
string
No
Parameter can be used for pagination. Youtube uses continous pagination and the next page token can be found in the SerpApi JSON responseserpapi_pagination -> next_page_token
and pagination -> next_page_token
fields.
Parameter can also be used to filter the search results:
by Upload date, you need to set the sp parameter to CAI%3D
by 4K, you need to set the sp parameter to EgJwAQ%3D%3D
...
It can also be used for forcing the exact search query spelling by setting the sp value to QgIIAQ%3D%3D
.
If you are interested in passing other filters, you can visit the YouTube website, set filters you want and simply copy sp value from their URL to SerpApi URL.
-
Serpapi Parameters
engine
string
Yes
Set parameter to youtube
to use the YouTube API engine.
youtube
no_cache
boolean
No
Parameter will force SerpApi to fetch the YouTube results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false
(default) to allow results from the cache, or true
to disallow results from the cache.
true
orfalse
api_key
string
Yes
Parameter defines the SerpApi private key to use.
-
Response
Success 200
Response Body
{
"search_metadata": {
"id": "b940f394-34b5-4aaa-9c91-aa1d7bfd3c7a",
"json_endpoint": "https://webserp.abcproxy.com/files/1a80eeed8d480492/b940f394-34b5-4aaa-9c91-aa1d7bfd3c7a.json",
"created_at": "2025-04-14 17:19:11",
"youtube_url": "https://www.youtube.com/results?search_query=Coffee",
"raw_html_file": "https://webserp.abcproxy.com/files/1a80eeed8d480492/b940f394-34b5-4aaa-9c91-aa1d7bfd3c7a.html",
"xray_html_file": "https://webserp.abcproxy.com/files/1a80eeed8d480492/b940f394-34b5-4aaa-9c91-aa1d7bfd3c7a.xray",
"total_time_taken": "8.3667"
},
"search_parameters": {
"engine": "youtube",
"no_cache": true,
"api_key": "YOUR_API_KEY",
"fetch_mode": "dynamic",
"search_query": "Coffee"
},
"latest_from_results": [
{
"published_date": "12daysago",
"views": 369000,
"length": "5:02",
"description": "Patreon:https://www.patreon.com/jameshoffmannLimitedEditionMerch:https://geni.us/TensHundredsThousandsInstagram:https...",
"extensions": [
"4KSubtitles"
],
"title": "The Secrets Of My Daily Coffee Routine",
"link": "https://www.youtube.com/watch?v=epIgulaBryA&pp=ygUGQ29mZmVl",
"channel": {
"name": "JamesHoffmann",
"link": "https://www.youtube.com/@JamesHoffmann",
"verified": true
}
},
{
"channel": {
"name": "a!ka",
"link": "https://www.youtube.com/@a!ka"
},
"published_date": "1.8Mviews",
"length": "3:05",
"description": "ProvidedtoYouTubebyDistroKidCoffee·a!kaCoffee℗a!kaReleasedon:2024-10-25Auto-generatedbyYouTube.",
"title": "Coffee",
"link": "https://www.youtube.com/watch?v=D9B_RkMQVGY&pp=ygUGQ29mZmVl"
},
"..."
],
"video_results": [
{
"description": "Herearethelinkstothetopbestcoffeebeansof2025featuredinourreviewvideotoday:DiscoverthePerfectCoffeeBeansfor ...",
"thumbnail": {
"static": "https://i.ytimg.com/vi/5TKAWkWlgck/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLCMZteq_TOtaLGl6TcUt0Sj1AtWYg"
},
"title": "Top 10 Best Coffee Beans of 2025 || A Coffee Lover’s Dream!",
"link": "https://www.youtube.com/watch?v=5TKAWkWlgck&pp=ygUGQ29mZmVl",
"channel": {
"name": "TheCoffeeDelight",
"link": "https://www.youtube.com/watch?v=5TKAWkWlgck&t=429s",
"thumbnail": "https://yt3.ggpht.com/3E6BUW6nfDoDirR5ZQXgtEz2rIgRZEIGlM0KDmhHeJmCpDrhnYgwcuVe-tW6GyZ9dkU6lkr1vQ=s68-c-k-c0x00ffffff-no-rj"
},
"published_date": "9monthsago",
"views": 54000,
"length": "7:43"
},
{
"title": "Rainy Jazz Cafe - Slow Jazz Music in Coffee Shop Ambience for Work, Study and Relaxation",
"link": "https://www.youtube.com/watch?v=NJuSStkIZBg&pp=ygUGQ29mZmVl",
"channel": {
"name": "CoffeeShopVibes",
"link": "https://www.youtube.com/@CoffeeShopVibes",
"verified": true
},
"published_date": "2yearsago",
"views": 41000000,
"length": "3:34:00",
"description": "Welcometothiscityrainycafeambiencewithcozyjazzmusicforwork,studyingandrelaxation.ThisisaASMRCoffeeshop ..."
},
"..."
],
"shorts_results": [
{
"shorts": [
{
"title": "Differentwaystomakewhippedcoffee",
"link": "https://www.youtube.com/shorts/nAJ_eXIwwgk",
"thumbnail": "https://i.ytimg.com/vi/nAJ_eXIwwgk/oardefault.jpg?sqp=-oaymwEoCJUDENAFSFqQAgHyq4qpAxcIARUAAIhC2AEB4gEKCBgQAhgGOAFAAQ==&rs=AOn4CLA8nTHzJuQb2R_99nqt0HIpErvliQ",
"views_original": "6.9Mviews",
"video_id": "nAJ_eXIwwgk"
},
{
"link": "https://www.youtube.com/shorts/wxFI24dkCSQ",
"views_original": "9.2Mviews",
"video_id": "wxFI24dkCSQ",
"title": "ShouldYouDrinkCoffeeforStudying?"
}
"..."
]
}
]
}
Response Fields
search_metadata
object
Contains timing and status information
search_parameters
object
Contains query parameters and search context
organic_results
object[]
OrganicResults
latest_from_results
object
LatestfromRes
video_results
object
VideoResults
shorts_results
object
ShortsResults
Error Responses
Common Errors
200
400
API Key can not be empty
200
401
Param error
200
402
Api key error
200
403
Insufficient Balance
200
404
Deduction failed
200
405
Failed to record usage count
200
406
Unsupported engine
200
407
Network error
200
408
File not found
200
409
Limit param error
200
410
Build url error
200
411
Failed to QueryRecentRecord
200
412
Failed to find json
200
413
Get html error
200
414
HTML is empty
200
429
Too many request
Error Example
{
"code": 400,
"message": "API Key can not be empty"
}
Last updated