Find the Weather

Overview

This is a description of one of the six use cases for the AI Search Engine—retrieving a weather forecast for the requested location based on information from the internet.

Provides only an 8-day weather forecast (daily and hourly).

An output example (a fragment)
{
  "type": "weather_result",
  "temperature": "77",
  "unit": "Fahrenheit",
  "precipitation": "10%",
  "humidity": "61%",
  "wind": "6 mph",
  "location": "Delhi, India",
  "date": "Friday",
  "weather": "Partly cloudy",
  "thumbnail": "https://serpapi.com/searches/67b753af5f068c54e9730a02/images/bfaadf278c5af1fdc545ed9c61f19c827f0c61fdfb6829e6.png",
  "forecast": [
    {
      "day": "Thursday",
      "temperature": {
        "high": "79",
        "low": "53"
      },
      "thumbnail": "https://serpapi.com/searches/67b753af5f068c54e9730a02/images/bfaadf278c5af1fdfcd2f19c8fed7ea29a6d5d11c931cb1c6b8961c5a701ac4a.png",
      "weather": "Light rain",
      "humidity": "94%",
      "precipitation": "45%",
      "wind": "8 mph"
    },
    {
      "day": "Friday",
      "temperature": {
        "high": "77",
        "low": "53"
      },
      "thumbnail": "https://serpapi.com/searches/67b753af5f068c54e9730a02/images/bfaadf278c5af1fdfcd2f19c8fed7ea2db13b12386fa4894bed175a78b1a73d4.png",
      "weather": "Partly cloudy",
      "humidity": "61%",
      "precipitation": "10%",
      "wind": "6 mph"
    },
    {
      "day": "Saturday",
      "temperature": {
        "high": "75",
        "low": "52"
      },
      "thumbnail": "https://serpapi.com/searches/67b753af5f068c54e9730a02/images/bfaadf278c5af1fdfcd2f19c8fed7ea237f4cdb1738823c11db9661a9008b26b.png",
      "weather": "Partly cloudy",
      "humidity": "61%",
      "precipitation": "10%",
      "wind": "8 mph"
    },
    {
      "day": "Sunday",
      "temperature": {
        "high": "78",
        "low": "51"
      },
      "thumbnail": "https://serpapi.com/searches/67b753af5f068c54e9730a02/images/bfaadf278c5af1fdfcd2f19c8fed7ea231f7bed0f82344fc6f02aff2997c4fbf.png",
      "weather": "Sunny",
      "humidity": "57%",
      "precipitation": "0%",
      "wind": "7 mph"
    },
    {
      "day": "Monday",
      "temperature": {
        "high": "81",
        "low": "54"
      },
      "thumbnail": "https://serpapi.com/searches/67b753af5f068c54e9730a02/images/bfaadf278c5af1fdfcd2f19c8fed7ea2487fa0071c8c05c5d8cab80602121baf.png",
      "weather": "Mostly sunny",
      "humidity": "53%",
      "precipitation": "0%",
      "wind": "6 mph"
    },
    {
      "day": "Tuesday",
      "temperature": {
        "high": "83",
        "low": "58"
      },
      "thumbnail": "https://serpapi.com/searches/67b753af5f068c54e9730a02/images/bfaadf278c5af1fdfcd2f19c8fed7ea2672ffbd0b88fdead232eb139fe4be010.png",
      "weather": "Partly cloudy",
      "humidity": "52%",
      "precipitation": "10%",
      "wind": "7 mph"
    },
    {
      "day": "Wednesday",
      "temperature": {
        "high": "89",
        "low": "64"
      },
      "thumbnail": "https://serpapi.com/searches/67b753af5f068c54e9730a02/images/bfaadf278c5af1fdfcd2f19c8fed7ea24e9a609cde5258c4721caaca9f044f2b.png",
      "weather": "Mostly cloudy",
      "humidity": "40%",
      "precipitation": "10%",
      "wind": "5 mph"
    },
    {
      "day": "Thursday",
      "temperature": {
        "high": "87",
        "low": "65"
      },
      "thumbnail": "https://serpapi.com/searches/67b753af5f068c54e9730a02/images/bfaadf278c5af1fdfcd2f19c8fed7ea2bf3a11e7710bbb1110889fa0b00f8ffd.png",
      "weather": "Cloudy",
      "humidity": "46%",
      "precipitation": "10%",
      "wind": "7 mph"
    }
  ],
  "hourly_forecast": [
    {
      "time": "Thursday 9:00 PM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/partly_cloudy.png",
      "weather": "Partly cloudy",
      "temperature": "62",
      "precipitation": "5%",
      "humidity": "94%",
      "wind": "8 mph"
    },
    {
      "time": "Thursday 10:00 PM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/partly_cloudy.png",
      "weather": "Partly cloudy",
      "temperature": "61",
      "precipitation": "15%",
      "humidity": "96%",
      "wind": "8 mph"
    },
    {
      "time": "Thursday 11:00 PM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/sunny_s_cloudy.png",
      "weather": "Clear with periodic clouds",
      "temperature": "60",
      "precipitation": "15%",
      "humidity": "95%",
      "wind": "8 mph"
    },
    {
      "time": "Friday 12:00 AM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/sunny_s_cloudy.png",
      "weather": "Clear with periodic clouds",
      "temperature": "59",
      "precipitation": "0%",
      "humidity": "95%",
      "wind": "7 mph"
    },
    {
      "time": "Friday 1:00 AM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/sunny_s_cloudy.png",
      "weather": "Clear with periodic clouds",
      "temperature": "58",
      "precipitation": "0%",
      "humidity": "96%",
      "wind": "6 mph"
    },
    {
      "time": "Friday 2:00 AM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/sunny.png",
      "weather": "Clear",
      "temperature": "57",
      "precipitation": "0%",
      "humidity": "98%",
      "wind": "5 mph"
    },
    {
      "time": "Friday 3:00 AM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/sunny.png",
      "weather": "Clear",
      "temperature": "56",
      "precipitation": "0%",
      "humidity": "97%",
      "wind": "5 mph"
    },
    {
      "time": "Friday 4:00 AM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/sunny.png",
      "weather": "Clear",
      "temperature": "55",
      "precipitation": "0%",
      "humidity": "96%",
      "wind": "4 mph"
    },
    {
      "time": "Friday 5:00 AM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/sunny.png",
      "weather": "Clear",
      "temperature": "54",
      "precipitation": "0%",
      "humidity": "96%",
      "wind": "4 mph"
    },
    {
      "time": "Friday 6:00 AM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/sunny.png",
      "weather": "Clear",
      "temperature": "53",
      "precipitation": "0%",
      "humidity": "100%",
      "wind": "4 mph"
    },
    {
      "time": "Friday 7:00 AM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/sunny.png",
      "weather": "Sunny",
      "temperature": "54",
      "precipitation": "0%",
      "humidity": "99%",
      "wind": "3 mph"
    },
    {
      "time": "Friday 8:00 AM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/sunny.png",
      "weather": "Sunny",
      "temperature": "56",
      "precipitation": "0%",
      "humidity": "99%",
      "wind": "2 mph"
    },
    {
      "time": "Friday 9:00 AM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/sunny.png",
      "weather": "Sunny",
      "temperature": "61",
      "precipitation": "0%",
      "humidity": "86%",
      "wind": "2 mph"
    },
    {
      "time": "Friday 10:00 AM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/sunny.png",
      "weather": "Sunny",
      "temperature": "67",
      "precipitation": "0%",
      "humidity": "71%",
      "wind": "2 mph"
    },
    {
      "time": "Friday 11:00 AM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/sunny.png",
      "weather": "Sunny",
      "temperature": "73",
      "precipitation": "0%",
      "humidity": "57%",
      "wind": "2 mph"
    },
    {
      "time": "Friday 12:00 PM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/partly_cloudy.png",
      "weather": "Partly cloudy",
      "temperature": "76",
      "precipitation": "0%",
      "humidity": "47%",
      "wind": "3 mph"
    },
    {
      "time": "Friday 1:00 PM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/partly_cloudy.png",
      "weather": "Partly cloudy",
      "temperature": "77",
      "precipitation": "5%",
      "humidity": "46%",
      "wind": "3 mph"
    },
    {
      "time": "Friday 2:00 PM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/partly_cloudy.png",
      "weather": "Mostly cloudy",
      "temperature": "77",
      "precipitation": "10%",
      "humidity": "46%",
      "wind": "4 mph"
    },
    {
      "time": "Friday 3:00 PM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/partly_cloudy.png",
      "weather": "Partly cloudy",
      "temperature": "77",
      "precipitation": "5%",
      "humidity": "46%",
      "wind": "5 mph"
    },
    {
      "time": "Friday 4:00 PM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/partly_cloudy.png",
      "weather": "Partly cloudy",
      "temperature": "76",
      "precipitation": "5%",
      "humidity": "47%",
      "wind": "6 mph"
    },
    {
      "time": "Friday 5:00 PM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/partly_cloudy.png",
      "weather": "Mostly sunny",
      "temperature": "75",
      "precipitation": "0%",
      "humidity": "52%",
      "wind": "6 mph"
    },
    {
      "time": "Friday 6:00 PM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/partly_cloudy.png",
      "weather": "Partly cloudy",
      "temperature": "71",
      "precipitation": "5%",
      "humidity": "60%",
      "wind": "6 mph"
    },
    {
      "time": "Friday 7:00 PM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/partly_cloudy.png",
      "weather": "Mostly cloudy",
      "temperature": "67",
      "precipitation": "10%",
      "humidity": "72%",
      "wind": "6 mph"
    },
    {
      "time": "Friday 8:00 PM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/cloudy.png",
      "weather": "Cloudy",
      "temperature": "63",
      "precipitation": "10%",
      "humidity": "84%",
      "wind": "6 mph"
    },
    {
      "time": "Friday 9:00 PM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/cloudy.png",
      "weather": "Cloudy",
      "temperature": "61",
      "precipitation": "10%",
      "humidity": "91%",
      "wind": "6 mph"
    },
    {
      "time": "Friday 10:00 PM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/cloudy.png",
      "weather": "Cloudy",
      "temperature": "60",
      "precipitation": "10%",
      "humidity": "95%",
      "wind": "6 mph"
    },
    {
      "time": "Friday 11:00 PM",
      "thumbnail": "https://ssl.gstatic.com/onebox/weather/64/cloudy.png",
      "weather": "Cloudy",
      "temperature": "59",
      "precipitation": "10%",
      "humidity": "96%",
      "wind": "6 mph"
    },

The output will be the requested information retrieved from the internet—or empty brackets {} if nothing was found or if the entered query does not match the selected search type (for example, querying 'How to get to Mars?' instead of requesting a weather forecast for a specific location).

How to make a call

Check how this call is made in the example below.

Note that queries can include advanced search syntax:

  • Search for an exact match: Enter a word or phrase using \" before and after it. For example, \"tallest building\".

  • Search for a specific site: Enter site: in front of a site or domain. For example, site:youtube.com cat videos.

  • Exclude words from your search: Enter - in front of a word that you want to leave out. For example, jaguar speed -car.

API Schema

Example

First, the standard chat completion endpoint with your query is called. It returns an ID, which must then be passed as the sole input parameter followup_id to the specific second endpoint:

Model Response:

An output fragment
PreviousFind VideosNextFind a Local Map

Last updated