> ## Documentation Index
> Fetch the complete documentation index at: https://cloro.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Weather schema

> Schema for Google's weather card returned by the Google Search endpoint: location, unit, current conditions, hourly forecast and daily forecast.

The [Google Search endpoint](https://cloro.dev/docs/api-reference/endpoint/monitor-google.md) returns Google's weather card as `result.weather`, on desktop and mobile, with no flag and at no extra cost. The card shows on weather queries ("weather new york", "météo lyon demain") and in the header of some places. `weather` is omitted when the SERP has no weather card.

![Weather card in Google Search](https://mintcdn.com/cloro/4HCNLgMmIWi6c4Xq/images/google/search-weather.webp?fit=max\&auto=format\&n=4HCNLgMmIWi6c4Xq\&q=85\&s=cf8516802398ee86aa02a55b97e54069)

Weather in Google Search

The one-line current weather of a city or region's knowledge panel is in [`result.knowledgeGraph.weather`](https://cloro.dev/docs/api-reference/endpoint/google/knowledge-graph#weather), not here.

Values are as Google shows them, in the language of the SERP. Temperatures are whole numbers in `unit`.

## Weather structure

Every field is included only when the card shows it.

| Field | Type | Description |
| - | - | - |
| `location` | string | The place the forecast is for, as shown |
| `unit` | string | Temperature unit (`°C` or `°F`). Absent when the card does not show it, as on most mobile cards |
| `current` | object | The top of the card: the conditions now, or the day or hour the query asks for ("weather tomorrow"). See below |
| `hourly` | array | The hourly forecast, in order. See below |
| `daily` | array | The daily forecast, in order, starting today. See below |

### Order of hours and days

`time` is the label Google shows, so how much it says depends on the card:

* On the desktop card, an hour names its day (`Wednesday 9:00 AM`), and `hourly` covers the days of the forecast.
* On the mobile card and the card inside the AI Overview, `hourly` is the next 24 hours, starting now (`Now`, `2 AM`, …). An hour shows the time alone, so the day changes after midnight without a label.
* A day shows its weekday (`Thu`), not a date. Over 10 days a weekday can appear twice, so read `daily` by position: the first item is today.

### Conditions

`current`, each hour and each day share one shape.

| Field | Type | Description |
| - | - | - |
| `time` | string | The time or day, as shown (`Wednesday 9:00 AM`, `Now`, `Thu`) |
| `condition` | string | The sky, as shown (`Partly sunny`) |
| `temperature` | number | Temperature. On `current` and each hour |
| `feelsLike` | number | Felt temperature, when the card shows it |
| `high` | number | Day's high. On each day, and on `current` when it shows a day |
| `low` | number | Day's low. On each day, and on `current` when it shows a day |
| `precipitation` | string | Chance of precipitation, as shown (`4%`) |
| `humidity` | string | Humidity, as shown (`58%`) |
| `wind` | string | Wind speed, as shown (`5 mph`) |

## Response example

A response to `weather new york` in the United States, on desktop:

```json theme={null}
{
  "success": true,
  "result": {
    "weather": {
      "location": "New York, NY",
      "unit": "°F",
      "current": {
        "time": "Wednesday 9:00 AM",
        "condition": "Partly sunny",
        "temperature": 57,
        "precipitation": "4%",
        "humidity": "58%",
        "wind": "5 mph"
      },
      "hourly": [
        {
          "time": "Wednesday 9:00 AM",
          "condition": "Partly sunny",
          "temperature": 57,
          "precipitation": "4%",
          "humidity": "58%",
          "wind": "5 mph"
        }
        // …
      ],
      "daily": [
        {
          "time": "Wed",
          "condition": "Partly sunny",
          "high": 62,
          "low": 51
        },
        {
          "time": "Thu",
          "condition": "Heavy rain",
          "high": 59,
          "low": 42
        }
        // …
      ]
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.