Google Knowledge Graph schema - cloro
Google Knowledge Graph schema
Schema for the Knowledge Graph panel returned by the Google Search endpoint: entity details, attributes, ratings, profiles, and panel-specific fields.
Google’s Knowledge Graph panel surfaces structured information about a queried entity — a person, place, organization, film, product, or other well-known subject. When a panel appears, the
Google Search endpoint
includes a
knowledgeGraph
object in the same response; when none appears the field is omitted, so treat it as optional rather than expecting
null
. For use cases, pricing context, and copy-paste examples, see the
Google Knowledge Graph API
page on the product site.
Knowledge Graph panel in Google Search
Layout and sub-fields vary by entity type — an artist panel may carry
listenOn
and
socialPosts
, a restaurant
contact
and
webRatings
. Every sub-field is optional and appears only when Google includes it.
Navigate to header: Top-level fields Top-level fields
| Field | Type | Description |
|---|---|---|
| title | string | Entity name as shown in the panel header |
| type | string | Entity category label (e.g. "American rapper" , "French museum" ). Free-form string — not an enum |
| kgmid | string | Google Knowledge Graph ID for the entity |
| description | string | Short entity description (sourced from Wikipedia or Google’s knowledge base) |
| imageUrl | string | Entity image URL as served by Google |
| website | string | Official website URL |
| menu | string | Menu URL — present for restaurants and food businesses |
| trailer | string | Trailer URL — present for films and TV shows |
| source | object | Attribution source for the description (see source ) |
| attributes | array | Factual key-value pairs (see attributes ) |
| profiles | array | Social media and external profile links (see profiles ) |
| peopleAlsoSearchFor | array | Related entities users also search for (see peopleAlsoSearchFor ) |
| thingsToKnow | array | Topic clusters from the “Things to know” section (see thingsToKnow ) |
| ratings | array | Review platform ratings for films, TV shows, and similar entities, e.g. Rotten Tomatoes, IMDb (see ratings ) |
| streamingOptions | array | Streaming links for films and shows (see streamingOptions ) |
| webRatings | array | Local business ratings from Google, Tripadvisor, Yelp, etc. (see webRatings ) |
| statsCard | object | Statistics card for sports teams, athletes, and organizations (see statsCard ) |
| socialPosts | array | Recent posts from the entity’s official social accounts (see socialPosts ) |
| notableAlumni | array | Notable alumni — present for universities and educational institutions (see notableAlumni ) |
| contact | array | Contact and ordering links for local businesses (see contact ) |
| weather | object | Current weather — present for geographic entities such as cities, regions, and countries (see weather ) |
| rating | object | Aggregate star rating for local businesses (see rating ) |
| admission | array | Admission options for museums, parks, and ticketed venues (see admission ) |
| artworks | array | Notable artworks for artists and art institutions (see artworks ) |
| has3dModel | boolean | true when Google surfaces a 3D model viewer for the entity |
| hotelOptions | array | Hotel booking options — present for hotel entities (see hotelOptions ) |
| trendingProducts | array | Trending products for retail brands (see trendingProducts ) |
| merchantVideos | array | Brand or merchant video content — present for retail businesses (see merchantVideos ) |
| listenOn | array | Music streaming links for musicians and musical acts (see listenOn ) |
Navigate to header: Sub-type schemas Sub-type schemas
Navigate to header: source source
| Field | Type | Description |
|---|---|---|
| name | string | Display name of the source (e.g. "Wikipedia" ) |
| link | string | URL of the source page |
Navigate to header: attributes attributes
Factual key-value pairs extracted from the panel (born date, genre, headquarters, founding year, etc.). Keys are free-form strings as rendered by Google.
| Field | Type | Description |
|---|---|---|
| key | string | Attribute label (e.g. "Born" , "Genre" , "Headquarters" ) |
| value | string | Attribute value |
Navigate to header: profiles profiles
| Field | Type | Description |
|---|---|---|
| name | string | Platform or profile name (e.g. "Instagram" , "X" ) |
| link | string | Profile URL |
Navigate to header: peopleAlsoSearchFor peopleAlsoSearchFor
| Field | Type | Description |
|---|---|---|
| name | string | Related entity name |
| link | string | Google search URL for the related entity |
Navigate to header: thingsToKnow thingsToKnow
| Field | Type | Description |
|---|---|---|
| label | string | Topic cluster label (e.g. "Albums" , "Awards" ) |
| subtitle | string | Supporting text for the topic |
Navigate to header: ratings ratings
| Field | Type | Description |
|---|---|---|
| platform | string | Review platform name (e.g. "Rotten Tomatoes" , "IMDb" ) |
| rating | string | Rating value as displayed (e.g. "88%" , "7.5/10" ) |
| link | string | URL to the review page |
Navigate to header: streamingOptions streamingOptions
| Field | Type | Description |
|---|---|---|
| platform | string | Streaming platform name (e.g. "Netflix" , "Max" ) |
| link | string | Link to the content on the platform |
Navigate to header: webRatings webRatings
Local business ratings from review platforms. Different from
ratings
— these appear on local business panels (restaurants, hotels, attractions) rather than film/show panels.
| Field | Type | Description |
|---|---|---|
| platform | string | Rating platform name (e.g. "Google" , "Tripadvisor" , "Yelp" ) |
| rating | string | Rating value as displayed |
| link | string | URL to the platform’s review page |
| votes | string | Number of reviews (omitted when not available) |
Navigate to header: statsCard statsCard
| Field | Type | Description |
|---|---|---|
| context | string | Context label for the stats (e.g. "2023-24 NBA season" ) |
| stats | array | Individual stat items ( label string, value string) |
Navigate to header: socialPosts socialPosts
| Field | Type | Description |
|---|---|---|
| platform | string | Social platform name (e.g. "X" , "Instagram" ) |
| text | string | Post text content |
| link | string | URL to the post |
| date | string | Post date as displayed by Google (e.g. "2 days ago" ) |
Navigate to header: notableAlumni notableAlumni
| Field | Type | Description |
|---|---|---|
| name | string | Alumni name |
| link | string | Google search URL for this person |
Navigate to header: contact contact
| Field | Type | Description |
|---|---|---|
| label | string | Link label (e.g. "Order online" , "Reserve a table" ) |
| url | string | Link URL |
Navigate to header: weather weather
| Field | Type | Description |
|---|---|---|
| temperature | string | Temperature as displayed (e.g. "72°F" ) |
| condition | string | Weather condition (e.g. "Sunny" , "Partly cloudy" ) |
Navigate to header: rating rating
| Field | Type | Description |
|---|---|---|
| rating | string | Star rating value (e.g. "4.5" ) |
| count | string | Number of reviews (e.g. "2,847" ) |
Navigate to header: admission admission
| Field | Type | Description |
|---|---|---|
| provider | string | Ticket provider name (e.g. "Official website" , "GetYourGuide" ) |
| price | string | Admission price as displayed |
| link | string | URL to purchase tickets |
| badge | string | Optional badge text (e.g. "Free" , "Best price" ) — omitted when not present |
Navigate to header: artworks artworks
| Field | Type | Description |
|---|---|---|
| title | string | Artwork title |
| link | string | Link to more information about the artwork |
| author | string | Author or creator name — omitted when not present |
Navigate to header: hotelOptions hotelOptions
| Field | Type | Description |
|---|---|---|
| provider | string | Booking provider name (e.g. "Booking.com" , "Hotels.com" ) |
| price | string | Price as displayed (e.g. "$189/night" ) |
| link | string | URL to book on this provider |
| note | string | Optional note (e.g. "Includes breakfast" ) — omitted when not present |
Navigate to header: trendingProducts trendingProducts
| Field | Type | Description |
|---|---|---|
| title | string | Product title |
| price | string | Price as displayed |
| link | string | Link to the product |
Navigate to header: merchantVideos merchantVideos
| Field | Type | Description |
|---|---|---|
| title | string | Video title |
| link | string | Video URL |
| platform | string | Video platform (e.g. "YouTube" ) — omitted when not available |
| duration | string | Video duration as displayed (e.g. "2:34" ) — omitted when not available |
Navigate to header: listenOn listenOn
| Field | Type | Description |
|---|---|---|
| platform | string | Streaming platform name (e.g. "Spotify" , "Apple Music" ) |
| link | string | Link to the artist on the platform |
Navigate to header: Response example Response example
Musician panel
{
"success"
:
true
,
"result"
: {
"knowledgeGraph"
: {
"title"
:
"Eminem"
,
"type"
:
"American rapper"
,
"kgmid"
:
"/m/01vs_v8"
,
"description"
:
"Marshall Bruce Mathers III, known professionally as Eminem, is an American rapper, songwriter, and record producer."
,
"imageUrl"
:
"https://encrypted-tbn0.gstatic.com/images?q=tbn:..."
,
"website"
:
,
"source"
: {
"name"
:
"Wikipedia"
,
"link"
:
"https://en.wikipedia.org/wiki/Eminem"
},
"attributes"
: [
{
"key"
:
"Born"
,
"value"
:
"October 17, 1972"
},
{
"key"
:
"Genre"
,
"value"
:
"Hip hop"
},
{
"key"
:
"Labels"
,
"value"
:
"Aftermath, Interscope, Shady"
}
],
"profiles"
: [
{
"name"
:
"Instagram"
,
"link"
:
"https://www.instagram.com/eminem/"
},
{
"name"
:
"X"
,
"link"
:
}
],
"peopleAlsoSearchFor"
: [
{
"name"
:
"Jay-Z"
,
"link"
:
"https://www.google.com/search?q=Jay-Z"
},
{
"name"
:
"Dr. Dre"
,
"link"
:
"https://www.google.com/search?q=Dr.\+Dre"
}
],
"thingsToKnow"
: [
{
"label"
:
"Albums"
,
"subtitle"
:
"The Slim Shady LP, The Marshall Mathers LP, Recovery, ..."
},
{
"label"
:
"Awards"
,
"subtitle"
:
"15 Grammy Awards, Academy Award for Best Original Song"
}
],
"socialPosts"
: [
{
"platform"
:
"X"
,
"text"
:
"The Death of Slim Shady out now everywhere 🎤"
,
"link"
:
"https://x.com/Eminem/status/..."
,
"date"
:
"3 days ago"
}
],
"listenOn"
: [
{
"platform"
:
"Spotify"
,
"link"
:
"https://open.spotify.com/artist/7dGJo4pcD2V6oG8kP0tJRR"
},
{
"platform"
:
"Apple Music"
,
"link"
:
"https://music.apple.com/us/artist/eminem/111051"
}
]
}
}
}
Was this page helpful?
Ask a question...
Navigate to header: attributes
Navigate to header: peopleAlsoSearchFor
Navigate to header: thingsToKnow
Navigate to header: streamingOptions
Navigate to header: webRatings
Navigate to header: socialPosts
Navigate to header: notableAlumni
Navigate to header: hotelOptions
Navigate to header: trendingProducts
Navigate to header: merchantVideos
Navigate to header: Top-level fields