REST Resource: assetSearch
Stay organized with collections
Save and categorize content based on your preferences.
Resource: AssetSnippet
The asset search collection enables you to search within the set of all assets. Each search result contains a snippet that provides key details about an asset.
Note that the asset metadata returned in search results may be slightly out of date. If you intend to update
an asset in the search result set, you should first retrieve the asset's complete and up-to-date metadata using either the assets.get()
method or the assets.list()
method.
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\u003eThe asset search collection allows searching within all assets, providing a snippet with key details for each search result.\u003c/p\u003e\n"],["\u003cp\u003eAsset metadata in search results might be outdated, so it's recommended to use \u003ccode\u003eassets.get()\u003c/code\u003e or \u003ccode\u003eassets.list()\u003c/code\u003e for up-to-date information before updating.\u003c/p\u003e\n"],["\u003cp\u003eEach asset is uniquely identified by an ID assigned by YouTube, along with other details such as title, type, creation time, and custom ID.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eassetSnippet\u003c/code\u003e contains multiple fields such as \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003etype\u003c/code\u003e, \u003ccode\u003etimeCreated\u003c/code\u003e, \u003ccode\u003eid\u003c/code\u003e, \u003ccode\u003ecustomId\u003c/code\u003e, \u003ccode\u003etitle\u003c/code\u003e, \u003ccode\u003eisrc\u003c/code\u003e, \u003ccode\u003eisrcs\u003c/code\u003e, \u003ccode\u003eiswc\u003c/code\u003e and \u003ccode\u003eiswcs\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the list method to search for assets based on asset metadata.\u003c/p\u003e\n"]]],["The `AssetSnippet` resource allows searching for assets, with results containing key asset details. Search results may be slightly outdated; use `assets.get()` or `assets.list()` for up-to-date metadata before updating. The JSON representation includes fields like `kind`, `type`, `timeCreated`, `id`, `customId`, `title`, `isrc`, and `iswc`. The `assetSearch/list` method is available for searching assets. Each search result contains snippet with key details.\n"],null,["# REST Resource: assetSearch\n\n- [Resource: AssetSnippet](#AssetSnippet)\n - [JSON representation](#AssetSnippet.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: AssetSnippet\n----------------------\n\nThe asset search collection enables you to search within the set of all assets. Each search result contains a snippet that provides key details about an asset.\n\nNote that the asset metadata returned in search results may be slightly out of date. If you intend to [update](/youtube/v3/docs/assets/update) an asset in the search result set, you should first retrieve the asset's complete and up-to-date metadata using either the [`assets.get()`](/youtube/partner/docs/v1/assets/get) method or the [`assets.list()`](/youtube/partner/docs/v1/assets/list) method.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"type\": string, \"timeCreated\": string, \"id\": string, \"customId\": string, \"title\": string, \"isrc\": string, \"isrcs\": [ string ], \"iswc\": string, \"iswcs\": [ string ] } ``` |\n\n| Fields ||\n|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` The type of the API resource. For this operation, the value is `youtubePartner#assetSnippet`. |\n| `type` | `string` The asset's type. This value determines which metadata fields might be included in the `metadata` object. |\n| `timeCreated` | `string` The date and time the asset was created. The value is specified in [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) (`YYYY-MM-DDThh:mm:ss.000Z`) format. |\n| `id` | `string` An ID that YouTube assigns and uses to uniquely identify the asset. |\n| `customId` | `string` Custom ID assigned by the content owner to this asset. |\n| `title` | `string` Title of this asset. |\n| `isrc` | `string` The ISRC (International Standard Recording Code) for this asset. |\n| `isrcs[]` | `string` The ISRCs (International Standard Recording Code) for this asset. |\n| `iswc` | `string` The ISWC (International Standard Musical Work Code) for this asset. |\n| `iswcs[]` | `string` The ISWCs (International Standard Musical Work Code) for this asset. |\n\n| Methods ------- ||\n|-----------------------------------------------------------------|----------------------------------------------|\n| ### [list](/youtube/partner/reference/rest/v1/assetSearch/list) | Searches for assets based on asset metadata. |"]]
