Search Contributions Schema Reference

  • User-generated content (UGC) data, including thumbs ratings, reviews, streaming provider subscriptions, and watched items, can be exported from Google products.

  • This data includes timestamps, content titles, and user-specific feedback or actions.

  • Exported data is organized into four categories: Thumbs, Reviews, Streaming video providers, and Watched.

  • Each category is accessed through a specific resource group and OAuth scope.

  • All exported data is provided in JSON format for easy integration and analysis.
Exported Object: Thumbs
Exported Object represents: Thumb ratings for movies, TV shows, music albums, etc.
Object is exported in these formats: JSON
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field * Field Definition Data Field Type
Published Time and date the user did the activity.

Examples:
2023-08-23T03:49:28.734Z 		string
Search Query Name of movie, tvshow, tv series.

Examples:
Game of thrones
Moana 		string
Thumbs Rating The value which specifies likes/dislikes.

Examples:
Thumbs Up
Thumbs Down 		string
Updated Time and date the user last did an activity.

Examples:
2023-08-23T03:49:28.734Z 		string
Exported Object: Reviews
Exported Object represents: Reviews added to movies and other search results.
Object is exported in these formats: JSON
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field * Field Definition Data Field Type
Published Time and date the contribution was published.

Examples:
2023-08-23T03:49:28.734Z 		string
Review Comment The value which specifies the review.

Examples:
Amazing movie! Must watch. Interesting plot 		string
Review Star Rating The value which specifies the star rating.

Examples:
Five stars		 string
Search Query Name of entity (movie, tv show, video game, etc).

Examples:
Game of thrones
Moana 		string
Updated Time and date the contribution was updated.

Examples:
2023-08-23T03:49:28.734Z 		string
Exported Object: Comments on Search
Exported Object represents: Comments added in Search.
Object is exported in these formats: JSON
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Exported Object: Streaming video providers
Exported Object represents: User-reported information about streaming providers that the user is subscribed to.
Object is exported in these formats: JSON
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field * Field Definition Data Field Type
Published Date and time of the user subscription report.

Examples:
2023-08-23T03:49:28.734Z 		string
Provider Name Name of the provider user is subscribed to.

Examples:
Hulu		 string
Exported Object: Watched
Exported Object represents: Movies and TV shows that the user reported as already watched.
Object is exported in these formats: JSON
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field * Field Definition Data Field Type
Published Date and time of the user reaction.

Examples:
2023-08-23T03:49:28.734Z 		string
Search Query Name of the entity the user reported as already watched.

Examples:
Moana 		string
A table representing Resource Groups and the objects that are exported with it.
Resource Group * Description Exported Objects
search_ugc.media.thumbs This resource group contains user indicated thumbs up and thumbs down for movies, books, TV shows, music, and video games on Google Search and Google TV.
Thumbs
search_ugc.media.reviews_and_stars This resource group contains user indicated reviews and stars for movies, books, TV shows, music, and video games on Google Search.
Reviews
search_ugc.media.streaming_video_providers This resource group contains user-reported information about streaming providers that the user is subscribed to on Google Search and Google TV.
Streaming video providers
search_ugc.media.watched This resource group contains the movies and TV shows that the user reported as already watched on Google Search and Google TV.
Watched
search_ugc.comments This resource group contains user comments on Google Search.
Comments on Search
* To obtain the OAuth Scope Name for a particular Resource Group, append "https://www.googleapis.com/auth/dataportability." to the Resource Group. For example, the OAuth Scope Name for the "myactivity.search" Resource Group is "https://www.googleapis.com/auth/dataportability.myactivity.search".