YouTube Search API

Api Details

Endpoint GET https://serpapi.abcproxy.com/search

Description Retrieve comprehensive user profile including basic info, account status and optional permission sets.


Source
Description

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

Name
Type
Required
Description
Example

search_query

string

Yes

Parameter defines the search query. You can use anything that you would use in a regular YouTube search.

coffee

Localization

Name
Type
Required
Description
Example

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

Name
Type
Required
Description
Example

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

Name
Type
Required
Description
Example

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

Name
Type
Required
Description
Example

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.

trueorfalse

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

Field
Type
Description

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

HTTP Status
Error Code
Description

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