Google Things To Know API
For some searches, Google search includes a "Things to know" block. SerpApi is able to scrape, extract and make sense of this information.
API Examples
Results for: Coffee
{
...
"things_to_know": {
"web_results": [
{
"title": "Price",
"snippet": "8 ounces",
"link": "https://presto-coffee.com/blogs/coffee/how-much-ground-coffee-to-use-per-cup#:~:text=While%20using%20scoops%20or%20tablespoons,the%20correct%20ratio%20from%20there."
},
{
"title": "Ph level",
"snippet": "5",
"link": "https://www.verenastreet.com/blogs/all-about-coffee/what-is-coffee-acidity#:~:text=Black%20coffee%20generally%20lands%20around,acidic%20by%20way%20of%20dilution."
},
{
"title": "Inventor",
"snippet": "Melitta Bentz",
"link": "https://coffee.org/pages/history-of-the-coffee-maker#:~:text=Ever%20wonder%20who%20invented%20the,the%20quick%20and%20easy%20answer."
}
],
"buttons": [
{
"text": "Energy Amount",
"subtitle": "How Many Calories In Coffee",
"images": [
"https://serpapi.com/searches/640056fcd5ecf4f8807cf57e/images/99611c3fcc205f334357660c65d137aafa48a275c4c07411baacfa91f844a674.webp",
...
],
"table": [
[
"Amount Per 1 fl oz (29.6 g)100 grams6 fl oz (178 g)1 cup (8 fl oz) (237 g)1 cup (8 fl oz) (237 g)"
],
[
"Calories 1"
]
],
"search_link": "https://www.google.com/search?gl=us&q=how+many+calories+in+coffee&sa=X&ved=2ahUKEwj47feIgcn9AhVrnWoFHe8OADoQrooIegQIXBAF",
"serpapi_search_link": "https://serpapi.com/search.json?device=mobile&engine=google&gl=us&google_domain=google.com&q=how+many+calories+in+coffee"
},
{
"text": "Food Nutrition",
"subtitle": "Nutritional Value Of Coffee",
"images": [
"https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcRalPAx50vb0fI0zYgDSh70SSARWxG1T04vO6dmee-WDup4o2WSTj_o0ujM91YY26QGBz42YCrQ9fODtZT4sOco8J1wSUEkOBQBpUOj2lMIUFVEzOYlC_Rc&usqp=CAc",
...
],
"table": [
[
"% Daily Value*",
"% Daily Value*"
],
[
"Total Fat 0 g",
"0%"
],
[
"Saturated fat 0 g",
"0%"
],
[
"Trans fat regulation 0 g"
],
[
"Cholesterol 0 mg",
"0%"
],
[
"Sodium 5 mg",
"0%"
],
[
"Potassium 116 mg",
"3%"
],
[
"Total Carbohydrate 0 g",
"0%"
],
[
"Dietary fiber 0 g",
"0%"
],
[
"Sugar 0 g"
],
[
"Protein 0.3 g",
"0%"
],
[
"Caffeine 95 mg"
],
[
"Vitamin C",
"0%",
"Calcium",
"0%"
],
[
"Iron",
"0%",
"Vitamin D",
"0%"
],
[
"Vitamin B6",
"0%",
"Cobalamin",
"0%"
],
[
"Magnesium",
"1%"
],
[
"*Percent Daily Values are based on a 2,000 calorie diet. Your daily values may be higher or lower depending on your calorie needs."
]
],
"formatted": [
{
"daily_value": "0%"
},
{
"daily_value": "0%"
},
{
"daily_value": "Trans fat regulation 0 g"
},
{
"daily_value": "0%"
},
{
"daily_value": "0%"
},
{
"daily_value": "3%"
},
{
"daily_value": "0%"
},
{
"daily_value": "0%"
},
{
"daily_value": "Sugar 0 g"
},
{
"daily_value": "0%"
},
{
"daily_value": "Caffeine 95 mg"
},
{
"daily_value": "0%"
},
{
"daily_value": "0%"
},
{
"daily_value": "0%"
},
{
"daily_value": "1%"
},
{
"daily_value": "*Percent Daily Values are based on a 2,000 calorie diet. Your daily values may be higher or lower depending on your calorie needs."
}
],
"search_link": "https://www.google.com/search?gl=us&q=nutritional+value+of+coffee&sa=X&ved=2ahUKEwj47feIgcn9AhVrnWoFHe8OADoQrooIegQIXBAJ",
"serpapi_search_link": "https://serpapi.com/search.json?device=mobile&engine=google&gl=us&google_domain=google.com&q=nutritional+value+of+coffee"
},
{
"text": "Types",
"subtitle": "Coffee Drink Types",
"images": [
"https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcRalPAx50vb0fI0zYgDSh70SSARWxG1T04vO6dmee-WDup4o2WSTj_o0ujM91YY26QGBz42YCrQ9fODtZT4sOco8J1wSUEkOBQBpUOj2lMIUFVEzOYlC_Rc&usqp=CAc",
...
],
"title": "Different Types of Coffee Explained | NESCAFÉ India",
"link": "https://www.nescafe.com/in/coffee-types#:~:text=From%20the%20well%2Dknown%20cappuccino,which%20one%20is%20your%20favourite.",
"displayed_link": "https://www.nescafe.com › coffee-t...",
"snippet": "From the well-known cappuccino, espresso, and latte, to the lungo, ristretto, café au lait and cold brew, there are so many types of coffee to enjoy. Give them all a try and find out which one is your favourite.",
"snippet_highlighted_words": [
"cappuccino, espresso, and latte, to the lungo, ristretto, café au lait and cold brew"
],
"about_this_result": {
"source": {
"description": "This result comes from www.nescafe.com",
"source_info_link": "https://www.nescafe.com/in/coffee-types",
"security": "secure",
"icon": "https://serpapi.com/searches/640056fcd5ecf4f8807cf57e/images/99611c3fcc205f331d8c1eddff13431f7c19e1650e9670a36ef2745e85550a1d529bd4eeecd5c885a8881f5494aae332.png"
},
"regions": [
"search terms"
]
},
"about_page_link": "https://www.google.com/search?q=About+https://www.nescafe.com/in/coffee-types&tbm=ilp&ilps=AB_Lh3oUMfRhUIejjVEq7V1KClEb4lyU1g",
"search_link": "https://www.google.com/search?gl=us&q=coffee+drink+types&sa=X&ved=2ahUKEwj47feIgcn9AhVrnWoFHe8OADoQrooIegQIXBAN",
"serpapi_search_link": "https://serpapi.com/search.json?device=mobile&engine=google&gl=us&google_domain=google.com&q=coffee+drink+types"
},
{
"text": "Benefits",
"subtitle": "Benefits Of Coffee",
"images": [
"https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcRalPAx50vb0fI0zYgDSh70SSARWxG1T04vO6dmee-WDup4o2WSTj_o0ujM91YY26QGBz42YCrQ9fODtZT4sOco8J1wSUEkOBQBpUOj2lMIUFVEzOYlC_Rc&usqp=CAc",
...
],
"title": "9 Health Benefits of Coffee, Based on Science - Healthline",
"link": "https://www.healthline.com/nutrition/top-evidence-based-health-benefits-of-coffee",
"displayed_link": "https://www.healthline.com › top-ev...",
"snippet": "9 Unique Benefits of Coffee",
"snippet_highlighted_words": [
"9 Unique Benefits of Coffee"
],
"list": [
"Boosts energy levels. ... ",
"May be linked to a lower risk of type 2 diabetes. ... ",
"Could support brain health. ... ",
"May promote weight management. ... ",
"Linked to a lower risk of depression. ... ",
"Could protect against liver conditions. ... ",
"Supports heart health. ... ",
"Could increase longevity."
],
"about_this_result": {
"source": {
"description": "Healthline Media, Inc. is an American website and provider of health information headquartered in San Francisco, California. It was founded in 1999, relaunched in 2006, and established as a standalone entity in January 2016.",
"source_info_link": "https://www.healthline.com/nutrition/top-evidence-based-health-benefits-of-coffee",
"security": "secure",
"icon": "https://serpapi.com/searches/640056fcd5ecf4f8807cf57e/images/99611c3fcc205f3346075eca3566aaf4d82cfd506811ba5438ba1a41f9dd9c31ba9579a1507223ebbe5b6bd4fb220f55.png"
},
"regions": [
"Terms"
]
},
"about_page_link": "https://www.google.com/search?q=About+https://www.healthline.com/nutrition/top-evidence-based-health-benefits-of-coffee&tbm=ilp&ilps=AB_Lh3qfGaP-aQfnaKJgNlx7nDttVz3SWw",
"search_link": "https://www.google.com/search?gl=us&q=benefits+of+coffee&sa=X&ved=2ahUKEwj47feIgcn9AhVrnWoFHe8OADoQrooIegQIXBAU",
"serpapi_search_link": "https://serpapi.com/search.json?device=mobile&engine=google&gl=us&google_domain=google.com&q=benefits+of+coffee"
},
{
"text": "Protein content",
"subtitle": "How Much Protein Is In Coffee",
"images": [
"https://serpapi.com/searches/640056fcd5ecf4f8807cf57e/images/99611c3fcc205f33cf91a62f4c6af9cce5988eaaae656d604c42e66244b965f6.webp",
...
],
"title": "Protein Coffee (Proffee Recipe) - Healthy With a Chance of Sprinkles",
"link": "https://healthywithachanceofsprinkles.com/protein-coffee/#:~:text=WHAT%20IS%20PROTEIN%20COFFEE%3F,or%20post%20workout%20muscle%20recovery.",
"displayed_link": "https://healthywithachanceofsprinkles.com › ...",
"date": "Sep 27, 2021",
"snippet": "WHAT IS PROTEIN COFFEE? Proffee is exactly what it sounds like. Coffee that is combined with protein powder or a prepared protein shake, usually served over ice, and sometimes flavored syrups are added. It's a delicious drink for anyone who wants to up their protein intake or post workout muscle recovery.",
"snippet_highlighted_words": [
"Coffee that is combined with protein powder or a prepared protein shake, usually served over ice, and sometimes flavored syrups are added"
],
"about_this_result": {
"source": {
"description": "This result comes from healthywithachanceofsprinkles.com",
"source_info_link": "https://healthywithachanceofsprinkles.com/protein-coffee/",
"security": "secure",
"icon": "https://serpapi.com/searches/640056fcd5ecf4f8807cf57e/images/99611c3fcc205f33cf91a62f4c6af9cc79793e313649617f4d6580a29d591b882ebfb9225b0221477c8e9d924f1bb2dc.jpeg"
},
"regions": [
"search terms"
]
},
"about_page_link": "https://www.google.com/search?q=About+https://healthywithachanceofsprinkles.com/protein-coffee/&tbm=ilp&ilps=AB_Lh3qhlC5JQzJ21xD7msFBLF9_n-FyEQ",
"search_link": "https://www.google.com/search?gl=us&q=how+much+protein+is+in+coffee&sa=X&ved=2ahUKEwj47feIgcn9AhVrnWoFHe8OADoQrooIegQIXBAZ",
"serpapi_search_link": "https://serpapi.com/search.json?device=mobile&engine=google&gl=us&google_domain=google.com&q=how+much+protein+is+in+coffee"
},
{
"text": "Brands",
"subtitle": "Coffee Brands",
"images": [
"https://serpapi.com/searches/640056fcd5ecf4f8807cf57e/images/99611c3fcc205f33012f60154e0e8720acbe9b967a6bff04b319bf8688999658.webp",
...
],
"title": "Top 10 Coffee Brands In The World",
"link": "https://www.feedough.com/top-10-coffee-brands-in-the-world/",
"displayed_link": "https://www.feedough.com › top-10...",
"about_this_result": {
"source": {
"description": "This result comes from www.feedough.com",
"source_info_link": "https://www.feedough.com/top-10-coffee-brands-in-the-world/",
"security": "secure",
"icon": "https://serpapi.com/searches/640056fcd5ecf4f8807cf57e/images/99611c3fcc205f33012f60154e0e872011c0cf663135b1537c0e6e13787d97af99530b0ee57c9daba019a9ef3a048e20.png"
},
"regions": [
"search terms"
]
},
"about_page_link": "https://www.google.com/search?q=About+https://www.feedough.com/top-10-coffee-brands-in-the-world/&tbm=ilp&ilps=AB_Lh3oelTyJ-9ALug6NI1NcJ-4fpF-lAg",
"table": [
[
"Brand",
"Revenue (in Billion USD)"
],
[
"Starbucks",
"23.52"
],
[
"Keurig Dr Pepper",
"11.62"
],
[
"Nescafé",
"9.2"
],
[
"Peet's Coffee",
"7.6"
]
],
"formatted": [
{
"brand": "Starbucks",
"revenue_in_billion_usd": "23.52"
},
{
"brand": "Keurig Dr Pepper",
"revenue_in_billion_usd": "11.62"
},
{
"brand": "Nescafé",
"revenue_in_billion_usd": "9.2"
},
{
"brand": "Peet's Coffee",
"revenue_in_billion_usd": "7.6"
}
],
"search_link": "https://www.google.com/search?gl=us&q=coffee+brands&sa=X&ved=2ahUKEwj47feIgcn9AhVrnWoFHe8OADoQrooIegQIXBAd",
"serpapi_search_link": "https://serpapi.com/search.json?device=mobile&engine=google&gl=us&google_domain=google.com&q=coffee+brands"
}
]
},
...
}
Example with AI Overview: Coffee
Some buttons within Things to Know may contain AI-generated overviews that provide comprehensive answers to related queries.
For detailed information about AI Overview structure and content types, please refer to our AI Overview documentation.
{
"things_to_know": {
"buttons": [
{
"text": "Types",
"subtitle": "What Are The Different Types Of Coffee?",
"title": "Types of Coffee Drinks",
"link": "https://www.folgerscoffee.com/coffee/articles/types-of-coffee",
"displayed_link": "https://www.folgerscoffee.com › coffee › articles › types...",
"snippet": "Types of Coffee Drinks",
"snippet_highlighted_words": [
"Types of Coffee Drinks"
],
"list": [
"Espresso.",
"Espresso & Coffee.",
"Cold Brew.",
"Cappuccino.",
"Mocha.",
"Iced Coffees.",
"Lattes.",
"Breve."
],
"favicon": "http://localhost:3000/searches/68ac0cadfe1c6b090f2e8c13/images/a832fc7f89f4b1af0499430179774bea90ed8e22fd3b75bba7316846b9b666394fe6f3e3b38ac45d.png",
"source": "folgerscoffee.com",
"search_link": "https://www.google.com/search?sca_esv=eca8c9f14481773e&hl=en&gl=us&q=types+of+coffee&sa=X&ved=2ahUKEwi7joGktKWPAxVCIUQIHdOlBAkQrooIegQIRhAG",
"serpapi_search_link": "http://localhost:3000/search.json?device=desktop&engine=google&gl=us&google_domain=google.com&hl=en&location=Austin%2C+Texas%2C+United+States&q=types+of+coffee"
},
{
"text": "Origin",
"subtitle": "Where Does Coffee Come From?",
"search_link": "https://www.google.com/search?sca_esv=eca8c9f14481773e&hl=en&gl=us&q=where+does+coffee+come+from&sa=X&ved=2ahUKEwi7joGktKWPAxVCIUQIHdOlBAkQrooIegQIRhAP",
"serpapi_search_link": "http://localhost:3000/search.json?device=desktop&engine=google&gl=us&google_domain=google.com&hl=en&location=Austin%2C+Texas%2C+United+States&q=where+does+coffee+come+from",
"ai_overview": {
"text_blocks": [
{
"type": "paragraph",
"snippet": "Coffee comes from the coffee plant (Coffea), which is native to Ethiopia, with the world's coffee now primarily grown in the \"coffee belt\" around the equator, a region encompassing parts of Africa, Asia, and Latin America. The edible part of the coffee plant is the \"bean,\" which is actually the seed of the coffee cherry fruit. After harvesting the ripe, red cherries, the seeds (beans) are extracted, processed, roasted, and ground into the coffee we drink.",
"snippet_highlighted_words": [
"Coffee comes from the coffee plant (Coffea), which is native to Ethiopia"
],
"reference_indexes": [
0,
1,
2,
3,
5
]
},
{
"type": "paragraph",
"snippet": "The Coffee Plant"
},
{
"type": "list",
"list": [
{
"snippet": "Origin: The coffee plant is native to the tropical regions of Ethiopia in Africa.",
"reference_indexes": [
3,
5
]
},
{
"snippet": "Growth: Coffee plants are woody evergreens that grow on shrubs or trees.",
"reference_indexes": [
2,
6
]
},
{
"snippet": "The \"Bean\": The \"coffee bean\" is the seed of the coffee fruit, called a coffee cherry, which is picked from the plant when it ripens to a bright red color.",
"reference_indexes": [
2,
3,
4
]
}
]
},
...
],
"references": [
{
"title": "How Coffee is Made from Seed to Cup",
"link": "https://www.youtube.com/watch?v=pdYcFcbUtng&t=11",
"snippet": "Sep 24, 2024 — steve Hoffman senior manager of R&D for coffee at L Colalom we're here in the roastery in Philadelphia. and we're goin...",
"source": "YouTube · La Colombe Coffee",
"index": 0
},
{
"title": "Where Does Coffee Come From? The Geography of Coffee | Peet's Coffee",
"link": "https://www.peets.com/blogs/peets/the-geography-of-coffee",
"source": "Peet's Coffee",
"index": 1
},
{
"title": "Coffee 101: What Does a Coffee Plant Look Like? - The Roasterie",
"link": "https://theroasterie.com/blogs/news/coffee-101-what-does-a-coffee-plant-look-like#:~:text=Where%20Does%20Coffee%20Come%20From,fruit%20and%2C%20eventually%2C%20roasted.",
"snippet": "May 11, 2020 — Where Does Coffee Come From? Coffee comes from a plant! Coffee plants are woody evergreens that can grow up to 10 mete...",
"source": "The Roasterie",
"index": 2
},
...
]
}
},
...
]
}
}
JSON structure overview
{
...
"things_to_know": {
"web_results": [
{
"title": "String - Title of the item",
"link": "String - Link to the item",
"snippet": "String - Snippet of the item",
}
],
"buttons": [
{
"text": "String - Main text of the entry",
"subtitle": "String - Subtitle of the entry",
"search_link": "String - Search link at the bottom of the entry",
"serpapi_search_link": "String - Link to the search results of the entry in JSON by SerpApi",
"title": "String - Optional title of the extended content",
"link": "String - Optional link of the extended content",
"displayed_link": "String - Optional displayed link of the extended content",
"snippet": "String - Optional snippet of the extended content",
"snippet_highlighted_words": "Array - Optional array of the highlighted words of the snippet",
"date": "String - Optional date of the extended content",
"list": "Array - Optional list of the extended content",
"table": "Array - Optional table items of the extended content",
"formatted": "Array - Optional formatted structure of the table",
"images": "Array - Optional URLs to the images of the extended content",
"ai_overview": "Hash - Optional AI-generated overview content",
},
],
}
...
}