REST Resource: claimSearch
Stay organized with collections
Save and categorize content based on your preferences.
Resource: ClaimSnippet
The claim search collection lets you search within the set of your claims for claims that are associated with a specific asset ID or video ID or that match a specified query string.
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 ClaimSnippet resource allows searching for claims associated with specific asset or video IDs, or by a query string within your set of claims.\u003c/p\u003e\n"],["\u003cp\u003eClaimSnippet JSON representation contains details such as claim ID, creation time, status, content type, video views, title, third-party status, partner upload status, and related asset/video IDs.\u003c/p\u003e\n"],["\u003cp\u003eThe Origin object in ClaimSnippet identifies the source of the claim, represented by a string field named \u003ccode\u003esource\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe ClaimSnippet resource has a \u003ccode\u003elist\u003c/code\u003e method that can be used to retrieve multiple claims based on search criteria.\u003c/p\u003e\n"]]],["The `ClaimSnippet` resource enables searching for claims associated with a specific asset or video ID, or matching a query. Key information includes claim creation time, status, content type, video views, and title. It also details whether it's a third-party or partner-uploaded claim, the unique claim ID, asset ID, and video ID, and if the video is eligible for Shorts. `Origin` indicates the claim's source. The primary action is listing claims that match specified search criteria using the `list` method.\n"],null,["# REST Resource: claimSearch\n\n- [Resource: ClaimSnippet](#ClaimSnippet)\n - [JSON representation](#ClaimSnippet.SCHEMA_REPRESENTATION)\n- [Origin](#Origin)\n - [JSON representation](#Origin.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: ClaimSnippet\n----------------------\n\nThe claim search collection lets you search within the set of your claims for claims that are associated with a specific asset ID or video ID or that match a specified query string.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"timeCreated\": string, \"status\": string, \"contentType\": string, \"videoViews\": string, \"engagedViews\": string, \"videoTitle\": string, \"thirdPartyClaim\": boolean, \"isPartnerUploaded\": boolean, \"timeStatusLastModified\": string, \"id\": string, \"assetId\": string, \"videoId\": string, \"origin\": { object (/youtube/partner/reference/rest/v1/claimSearch#Origin) }, \"isVideoShortsEligible\": boolean, \"studioInfo\": { object (/youtube/partner/reference/rest/v1/StudioInfo) } } ``` |\n\n| Fields ||\n|--------------------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` The type of the API resource. For this operation, the value is `youtubePartner#claimSnippet`. |\n| `timeCreated` | `string` The time the claim was created. |\n| `status` | `string` The claim's status. |\n| `contentType` | `string` This value indicates whether the claim covers the audio, video, or audiovisual portion of the claimed content. |\n| `videoViews` | `string` Number of engaged views for the claimed video. |\n| `engagedViews` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Number of engaged views for the claimed video. |\n| `videoTitle` | `string` The title of the claimed video. |\n| `thirdPartyClaim` | `boolean` Indicates that this is a third party claim. |\n| `isPartnerUploaded` | `boolean` Indicates whether or not the claim is a partner uploaded claim. |\n| `timeStatusLastModified` | `string` The time the claim status and/or status detail was last modified. |\n| `id` | `string` The ID that YouTube assigns and uses to uniquely identify the claim. |\n| `assetId` | `string` The unique YouTube asset ID that identifies the asset associated with the claim. |\n| `videoId` | `string` The unique YouTube video ID that identifies the video associated with the claim. |\n| `origin` | `object (`[Origin](/youtube/partner/reference/rest/v1/claimSearch#Origin)`)` |\n| `isVideoShortsEligible` | `boolean` Indicates whether or not the claim is on a video that is eligible for YouTube Shorts. |\n| `studioInfo` | `object (`[StudioInfo](/youtube/partner/reference/rest/v1/StudioInfo)`)` Contains URLs linking back to claim-related pages in Studio. |\n\nOrigin\n------\n\n| JSON representation |\n|------------------------------|\n| ``` { \"source\": string } ``` |\n\n| Fields ||\n|----------|----------|\n| `source` | `string` |\n\n| Methods ------- ||\n|-----------------------------------------------------------------|------------------------------------------------------------|\n| ### [list](/youtube/partner/reference/rest/v1/claimSearch/list) | Retrieves a list of claims that match the search criteria. |"]]
