Search | YouTube Data API - Google Developers

A search result contains information about a YouTube video, channel, or playlist that matches the search parameters specified in an API ... YouTube DataAPI Language English BahasaIndonesia Deutsch Español Français Português–Brasil Русский 中文–简体 日本語 한국어 Signin Home Guides Reference Samples Support YouTube DataAPI Home Guides Reference Samples Support Overview Activities Overviewlistinsert Captions Overviewlistinsertupdatedownloaddelete ChannelBanners Overviewinsert Channels Overviewlistupdate ChannelSections Overviewlistinsertupdatedelete Comments OverviewlistinsertupdatemarkAsSpamsetModerationStatusdelete CommentThreads Overviewlistinsert i18nLanguages Overviewlist i18nRegions Overviewlist Members Overviewlist MembershipsLevels Overviewlist PlaylistItems Overviewlistinsertupdatedelete Playlists Overviewlistinsertupdatedelete Search Overviewlist Subscriptions Overviewlistinsertdelete Thumbnails Overviewset VideoAbuseReportReasons Overviewlist VideoCategories Overviewlist Videos OverviewlistinsertupdaterategetRatingreportAbusedelete Watermarks Overviewsetunset GuideCategories Overviewlist StandardQueryParameters YouTubeDataAPIErrors OverviewGlobalDomainErrors Home Products YouTube DataAPI Reference Search AsearchresultcontainsinformationaboutaYouTubevideo,channel,orplaylistthatmatchesthesearchparametersspecifiedinanAPIrequest.Whileasearchresultpointstoauniquelyidentifiableresource,likeavideo,itdoesnothaveitsownpersistentdata. Methods TheAPIsupportsthefollowingmethodsforsearch: list ReturnsacollectionofsearchresultsthatmatchthequeryparametersspecifiedintheAPIrequest.Bydefault,asearchresultsetidentifiesmatchingvideo,channel,andplaylistresources,butyoucanalsoconfigurequeriestoonlyretrieveaspecifictypeofresource. Tryitnow. Resourcerepresentation ThefollowingJSONstructureshowstheformatofasearchresult: { "kind":"youtube#searchResult", "etag":etag, "id":{ "kind":string, "videoId":string, "channelId":string, "playlistId":string }, "snippet":{ "publishedAt":datetime, "channelId":string, "title":string, "description":string, "thumbnails":{ (key):{ "url":string, "width":unsignedinteger, "height":unsignedinteger } }, "channelTitle":string, "liveBroadcastContent":string } } Properties Thefollowingtabledefinesthepropertiesthatappearinasearchresult: Properties kind string IdentifiestheAPIresource'stype.Thevaluewillbeyoutube#searchResult. etag etag TheEtagofthisresource. id object Theidobjectcontainsinformationthatcanbeusedtouniquelyidentifytheresourcethatmatchesthesearchrequest. id.kind string ThetypeoftheAPIresource. id.videoId string Iftheid.typeproperty'svalueisyoutube#video,thenthispropertywillbepresentanditsvaluewillcontaintheIDthatYouTubeusestouniquelyidentifyavideothatmatchesthesearchquery. id.channelId string Iftheid.typeproperty'svalueisyoutube#channel,thenthispropertywillbepresentanditsvaluewillcontaintheIDthatYouTubeusestouniquelyidentifyachannelthatmatchesthesearchquery. id.playlistId string Iftheid.typeproperty'svalueisyoutube#playlist,thenthispropertywillbepresentanditsvaluewillcontaintheIDthatYouTubeusestouniquelyidentifyaplaylistthatmatchesthesearchquery. snippet object Thesnippetobjectcontainsbasicdetailsaboutasearchresult,suchasitstitleordescription.Forexample,ifthesearchresultisavideo,thenthetitlewillbethevideo'stitleandthedescriptionwillbethevideo'sdescription. snippet.publishedAt datetime Thecreationdateandtimeoftheresourcethatthesearchresultidentifies.ThevalueisspecifiedinISO8601format. snippet.channelId string ThevaluethatYouTubeusestouniquelyidentifythechannelthatpublishedtheresourcethatthesearchresultidentifies. snippet.title string Thetitleofthesearchresult. snippet.description string Adescriptionofthesearchresult. snippet.thumbnails object Amapofthumbnailimagesassociatedwiththesearchresult.Foreachobjectinthemap,thekeyisthenameofthethumbnailimage,andthevalueisanobjectthatcontainsotherinformationaboutthethumbnail. snippet.thumbnails.(key) object Validkeyvaluesare:default–Thedefaultthumbnailimage.Thedefaultthumbnailforavideo–oraresourcethatreferstoavideo,suchasaplaylistitemorsearchresult–is120pxwideand90pxtall.Thedefaultthumbnailforachannelis88pxwideand88pxtall.medium–Ahigherresolutionversionofthethumbnailimage.Foravideo(oraresourcethatreferstoavideo),thisimageis320pxwideand180pxtall.Forachannel,thisimageis240pxwideand240pxtall.high–Ahighresolutionversionofthethumbnailimage.Foravideo(oraresourcethatreferstoavideo),thisimageis480pxwideand360pxtall.Forachannel,thisimageis800pxwideand800pxtall.standard–Anevenhigherresolutionversionofthethumbnailimagethanthehighresolutionimage.Thisimageisavailableforsomevideosandotherresourcesthatrefertovideos,likeplaylistitemsorsearchresults.Thisimageis640pxwideand480pxtall.maxres–Thehighestresolutionversionofthethumbnailimage.Thisimagesizeisavailableforsomevideosandotherresourcesthatrefertovideos,likeplaylistitemsorsearchresults.Thisimageis1280pxwideand720pxtall. snippet.thumbnails.(key).url string Theimage'sURL. snippet.thumbnails.(key).width unsignedinteger Theimage'swidth. snippet.thumbnails.(key).height unsignedinteger Theimage'sheight. snippet.channelTitle string Thetitleofthechannelthatpublishedtheresourcethatthesearchresultidentifies. snippet.liveBroadcastContent string Anindicationofwhetheravideoorchannelresourcehaslivebroadcastcontent.Validpropertyvaluesareupcoming,live,andnone.Foravideoresource,avalueofupcomingindicatesthatthevideoisalivebroadcastthathasnotyetstarted,whileavalueofliveindicatesthatthevideoisanactivelivebroadcast.Forachannelresource,avalueofupcomingindicatesthatthechannelhasascheduledbroadcastthathasnotyetstarted,whileavalueofliveindicatesthatthechannelhasanactivelivebroadcast. Exceptasotherwisenoted,thecontentofthispageislicensedundertheCreativeCommonsAttribution4.0License,andcodesamplesarelicensedundertheApache2.0License.Fordetails,seetheGoogleDevelopersSitePolicies.JavaisaregisteredtrademarkofOracleand/oritsaffiliates. Lastupdated2020-05-20UTC. [{ "type":"thumb-down", "id":"missingTheInformationINeed", "label":"MissingtheinformationIneed" },{ "type":"thumb-down", "id":"tooComplicatedTooManySteps", "label":"Toocomplicated/toomanysteps" },{ "type":"thumb-down", "id":"outOfDate", "label":"Outofdate" },{ "type":"thumb-down", "id":"samplesCodeIssue", "label":"Samples/codeissue" },{ "type":"thumb-down", "id":"otherDown", "label":"Other" }] [{ "type":"thumb-up", "id":"easyToUnderstand", "label":"Easytounderstand" },{ "type":"thumb-up", "id":"solvedMyProblem", "label":"Solvedmyproblem" },{ "type":"thumb-up", "id":"otherUp", "label":"Other" }] Blog ThelatestnewsontheYouTubeblog GitHub FindAPIcodesamplesandotherYouTubeopen-sourceprojects. IssueTracker Somethingwrong?Sendusabugreport! StackOverflow Askaquestionundertheyoutube-apitag Videos CheckouttheYouTubeDeveloperRelationsteam'sYouTubechannel Tools GoogleAPIsExplorer YouTubePlayerDemo ConfigureaSubscribeButton IssueTracker Fileabug Requestafeature Seeopenissues ProductInfo TermsofService BrandingGuidelines MonetizationGuidelines APIssubjecttoDeprecationPolicy Android Chrome Firebase GoogleCloudPlatform Allproducts Terms Privacy SignupfortheGoogleDevelopersnewsletter Subscribe Language English BahasaIndonesia Deutsch Español Français Português–Brasil Русский 中文–简体 日本語 한국어