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

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",
      },
    ],
  }
  ...
}

Results for: Coffee

Results for: Coffee

JSON Example

{
  ...
  "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"
      }
    ]
  },
  ...
}