Search Contributions Schema Reference
Stay organized with collections
Save and categorize content based on your preferences.
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".
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-13 UTC.
[null,null,["Last updated 2025-02-13 UTC."],[[["\u003cp\u003eUser-generated content (UGC) data, including thumbs ratings, reviews, streaming provider subscriptions, and watched items, can be exported from Google products.\u003c/p\u003e\n"],["\u003cp\u003eThis data includes timestamps, content titles, and user-specific feedback or actions.\u003c/p\u003e\n"],["\u003cp\u003eExported data is organized into four categories: Thumbs, Reviews, Streaming video providers, and Watched.\u003c/p\u003e\n"],["\u003cp\u003eEach category is accessed through a specific resource group and OAuth scope.\u003c/p\u003e\n"],["\u003cp\u003eAll exported data is provided in JSON format for easy integration and analysis.\u003c/p\u003e\n"]]],[],null,["# Search Contributions Schema Reference\n\n| Data Field \\* | Field Definition | Data Field Type |\n|---------------|---------------------------------------------------------------------------------|-----------------|\n| Published | Time and date the user did the activity. Examples: 2023-08-23T03:49:28.734Z | string |\n| Search Query | Name of movie, tvshow, tv series. Examples: Game of thrones Moana | string |\n| Thumbs Rating | The value which specifies likes/dislikes. Examples: Thumbs Up Thumbs Down | string |\n| Updated | Time and date the user last did an activity. Examples: 2023-08-23T03:49:28.734Z | string |\n[Exported Object: Thumbs\nExported Object represents: Thumb ratings for movies, TV shows, music albums, etc.\nObject is exported in these formats: JSON\nExported object has the following fields:]\n\n| Data Field \\* | Field Definition | Data Field Type |\n|--------------------|---------------------------------------------------------------------------------------------|-----------------|\n| Published | Time and date the contribution was published. Examples: 2023-08-23T03:49:28.734Z | string |\n| Review Comment | The value which specifies the review. Examples: Amazing movie! Must watch. Interesting plot | string |\n| Review Star Rating | The value which specifies the star rating. Examples: Five stars | string |\n| Search Query | Name of entity (movie, tv show, video game, etc). Examples: Game of thrones Moana | string |\n| Updated | Time and date the contribution was updated. Examples: 2023-08-23T03:49:28.734Z | string |\n[Exported Object: Reviews\nExported Object represents: Reviews added to movies and other search results.\nObject is exported in these formats: JSON\nExported object has the following fields:]\n\n| | | |\n|---|---|---|\n[Exported Object: Comments on Search\nExported Object represents: Comments added in Search.\nObject is exported in these formats: JSON]\n\n| Data Field \\* | Field Definition | Data Field Type |\n|---------------|-----------------------------------------------------------------------------------|-----------------|\n| Published | Date and time of the user subscription report. Examples: 2023-08-23T03:49:28.734Z | string |\n| Provider Name | Name of the provider user is subscribed to. Examples: Hulu | string |\n[Exported Object: Streaming video providers\nExported Object represents: User-reported information about streaming providers that\nthe user is subscribed to.\nObject is exported in these formats: JSON\nExported object has the following fields:]\n\n| Data Field \\* | Field Definition | Data Field Type |\n|---------------|--------------------------------------------------------------------------|-----------------|\n| Published | Date and time of the user reaction. Examples: 2023-08-23T03:49:28.734Z | string |\n| Search Query | Name of the entity the user reported as already watched. Examples: Moana | string |\n[Exported Object: Watched\nExported Object represents: Movies and TV shows that the user reported as already\nwatched.\nObject is exported in these formats: JSON\nExported object has the following fields:]\n\n| Resource Group \\* | Description | Exported Objects |\n|--------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------|\n| 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 |\n| 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 |\n| 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 |\n| 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 |\n| search_ugc.comments | This resource group contains user comments on Google Search. | Comments on Search |\n[A table representing Resource Groups and the objects that are exported with it.]"]]