Method: assetSearch.list
Stay organized with collections
Save and categorize content based on your preferences.
Searches for assets based on asset metadata. The method can retrieve all assets or only assets owned by the content owner. This method mimics the functionality of the advanced search feature on the Assets
page in CMS.
HTTP request
GET https://youtubepartner.googleapis.com/youtube/partner/v1/assetSearch
The URL uses gRPC Transcoding
syntax.
Query parameters
| Parameters |
createdAfter
|
string
The createdAfter
parameter restricts the set of returned assets to ones originally created on or after the specified datetime. For example: 2015-01-29T23:00:00Z
|
createdBefore
|
string
The createdBefore
parameter restricts the set of returned assets to ones originally created on or before the specified datetime. For example: 2015-01-29T23:00:00Z
|
hasConflicts
|
boolean
The hasConflicts
parameter enables you to only retrieve assets that have ownership conflicts. The only valid value is true
. Setting the parameter value to false
does not affect the results.
|
includeAnyProvidedlabel
|
boolean
If includeAnyProvidedlabel
parameter is set to true, will search for assets that contain any of the provided labels; else will search for assets that contain all the provided labels.
|
isrcs
|
string
A comma-separated list of up to 50 ISRCs. If you specify a value for this parameter, the API server ignores any values set for the following parameters: q
, includeAnyProvidedLabel
, hasConflicts
, labels
, metadataSearchFields
, sort
, and type
.
|
labels
|
string
The labels
parameter specifies the assets with certain asset labels that you want to retrieve. The parameter value is a comma-separated list of asset labels.
|
metadataSearchFields
|
string
The metadataSearchField
parameter specifies which metadata fields to search by. It is a comma-separated list of metadata field and value pairs connected by colon(:). For example: customId:my_custom_id,artist:Dandexx
|
onBehalfOfContentOwner
|
string
The onBehalfOfContentOwner
parameter identifies the content owner that the user is acting on behalf of. This parameter supports users whose accounts are associated with multiple content owners.
|
ownershipRestriction
|
enum ( OwnershipRestriction
)
The ownershipRestriction
parameter specifies the ownership filtering option for the search. By default the search is performed in the assets owned by currently authenticated user only.
|
pageToken
|
string
The pageToken
parameter specifies a token that identifies a particular page of results to return. Set this parameter to the value of the nextPageToken
value from the previous API response to retrieve the next page of search results.
|
q
|
string
YouTube searches within the id
, type
, and customId
fields for all assets as well as in numerous other metadata fields – such as actor
, album
, director
, isrc
, and tmsId
– that vary for different types of assets (movies, music videos, etc.).
|
sort
|
enum ( Sort
)
The sort
parameter specifies how the search results should be sorted. Note that results are always sorted in descending order.
|
type
|
string
The type
parameter specifies the types of assets that you want to retrieve. The parameter value is a comma-separated list of asset types.
|
Request body
The request body must be empty.
Response body
This response shows a list of YouTube assets matching a search query. Each item in the list contains an asset's metadata.
If successful, the response body contains data with the following structure:
| Fields |
kind
|
string
The type of the API response. For this operation, the value is youtubePartner#assetSnippetList
.
|
pageInfo
|
object ( PageInfo
)
The pageInfo
object encapsulates paging information for the result set.
|
items[]
|
object ( AssetSnippet
)
A list of asset resources that match the request criteria.
|
nextPageToken
|
string
The token that can be used as the value of the pageToken
parameter to retrieve the next page of results.
|
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/youtubepartner
For more information, see the OAuth 2.0 Overview
.
OwnershipRestriction
Enum of ownership restriction.
Sort
Enum of supported sorting orders in asset search list request.
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eSearches YouTube assets based on metadata, like title, artist, or custom ID, and allows filtering by ownership, creation date, and more.\u003c/p\u003e\n"],["\u003cp\u003eThe search can be further refined using specific criteria such as ISRCs or labels to narrow down the results.\u003c/p\u003e\n"],["\u003cp\u003eResults are presented in pages, with options to sort by views, claims, or modification time and navigate through pages using tokens.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003eyoutubepartner\u003c/code\u003e scope is required to access this functionality.\u003c/p\u003e\n"]]],["This document outlines how to search for assets using the YouTube Partner API's `assetSearch` method. Key actions include sending a `GET` HTTP request to the specified URL, optionally including query parameters to filter results by creation date, conflicts, labels, ISRCs, metadata fields, and ownership. Sorting options (claims, time, views) are available. The response returns a list of assets, pagination details, and metadata. Authorization requires the `youtubepartner` scope. The request body should be empty.\n"],null,[]]
