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
Bearer key
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:
Last updated
Was this helpful?