# NOAA NCEI Climate Data

> Get historical weather and climate data from NOAA's National Centers for Environmental Information (NCEI), the US archive of weather observations: daily weather from over 100,000 stations worldwide, hourly reports from US airports, monthly and yearly summaries, and 30-year climate normals with frost dates. Find stations near a place or in an area, and look up NCEI's datasets. No account or API key required.

App · 12 actions. Web page: https://docs.lodol.com/docs/integrations/noaa-ncei

## Actions

### Find stations in an area

Find the weather stations inside a box drawn by its north, south, east and west edges, those keeping the most kinds of data first, with their IDs and the dates they have data for. Choose the data they must have, and optionally a period or temperature. No API key required.

**Inputs**

- North (`north`, number, required): The area's northern edge, as a latitude. From -90 to 90.
- South (`south`, number, required): The area's southern edge, as a latitude. From -90 to 90.
- East (`east`, number, required): The area's eastern edge, as a longitude (west is negative). From -180 to 180.
- West (`west`, number, required): The area's western edge, as a longitude. From -180 to 180.
- Dataset (`dataset`, text): Which data the stations must have: daily weather has the most stations worldwide; hourly observations and normals cover the U.S. only. One of: `daily-summaries` (Daily weather (GHCN-Daily)), `global-summary-of-the-month` (Monthly summaries (GSOM)), `global-summary-of-the-year` (Yearly summaries (GSOY)), `local-climatological-data-v2` (Hourly observations (Local Climatological Data)), `normals-daily-1991-2020` (Daily climate normals, 1991 to 2020), `normals-monthly-1991-2020` (Monthly climate normals, 1991 to 2020), `normals-annualseasonal-1991-2020` (Annual and seasonal climate normals, 1991 to 2020). Default: `daily-summaries`.
- With data from (`with_data_from`, date): Only stations with data on or after this day. Set it to a recent date to leave out stations that have closed.
- With data until (`with_data_until`, date): Only stations with data on or before this day.
- Only stations that measure temperature (`temperature_only`, true/false): Leave out stations that only measure rain and snow, which are most stations in towns. Default: `false`.
- How many to return (`limit`, number): How many stations to list, up to 100. From 1 to 100. Default: `25`.

**Outputs**

- `count` (number): How many are listed.
- `dataset` (text): The dataset searched, such as 'daily-summaries'.
- `dataset_name` (text): What the dataset holds, in words.
- `east` (number): The area's eastern edge (longitude).
- `north` (number): The area's northern edge (latitude).
- `note` (text): A warning when NCEI holds too many entries in the area to read them all, so stations may be missing. Empty otherwise.
- `south` (number): The area's southern edge (latitude).
- `stations` (list): The stations, those keeping the most kinds of data first.
- `total` (number): How many stations NCEI found in the area.
- `west` (number): The area's western edge (longitude).

**Example output**

```json
{
  "count": 2,
  "dataset": "local-climatological-data-v2",
  "dataset_name": "Hourly observations (Local Climatological Data)",
  "east": -87.5,
  "north": 42.1,
  "note": null,
  "south": 41.6,
  "stations": [
    {
      "data_types": [
        "CoolingDegreeDaysSeasonToDate",
        "DailyAverageDryBulbTemperature",
        "DailyAverageWindSpeed",
        "DailyCoolingDegreeDays"
      ],
      "data_types_count": 70,
      "distance_km": null,
      "first_date": "2026-01-01",
      "id": "USW00094846",
      "last_date": "2026-10-31",
      "latitude": 41.96019,
      "longitude": -87.93162,
      "name": "CHICAGO OHARE INTERNATIONAL AIRPORT, IL US",
      "page_url": "https://www.ncei.noaa.gov/cdo-web/datasets/GHCND/stations/GHCND:USW00094846/detail"
    },
    {
      "data_types": [
        "CoolingDegreeDaysSeasonToDate",
        "DailyAverageDryBulbTemperature",
        "DailyAverageWindSpeed",
        "DailyCoolingDegreeDays"
      ],
      "data_types_count": 65,
      "distance_km": null,
      "first_date": "2026-01-01",
      "id": "USW00014819",
      "last_date": "2026-10-31",
      "latitude": 41.78611,
      "longitude": -87.75222,
      "name": "CHICAGO MIDWAY AIRPORT, IL US",
      "page_url": "https://www.ncei.noaa.gov/cdo-web/datasets/GHCND/stations/GHCND:USW00014819/detail"
    }
  ],
  "total": 6,
  "west": -88.0
}
```

### Find stations near a place

Find the weather stations around a point, nearest first, with their IDs, distance and the dates they have data for. Choose the data they must have (daily, hourly, monthly, normals), and optionally only stations reporting in a period or measuring temperature. No API key required.

**Inputs**

- Latitude (`latitude`, number, required): The point's latitude, such as 40.78 for New York. From -90 to 90.
- Longitude (`longitude`, number, required): The point's longitude, such as -73.97 for New York (west is negative). From -180 to 180.
- Radius (km) (`radius_km`, number): How far from the point to look, in kilometres, up to 500. From 1 to 500. Default: `25`.
- Dataset (`dataset`, text): Which data the stations must have: daily weather has the most stations worldwide; hourly observations and normals cover the U.S. only. One of: `daily-summaries` (Daily weather (GHCN-Daily)), `global-summary-of-the-month` (Monthly summaries (GSOM)), `global-summary-of-the-year` (Yearly summaries (GSOY)), `local-climatological-data-v2` (Hourly observations (Local Climatological Data)), `normals-daily-1991-2020` (Daily climate normals, 1991 to 2020), `normals-monthly-1991-2020` (Monthly climate normals, 1991 to 2020), `normals-annualseasonal-1991-2020` (Annual and seasonal climate normals, 1991 to 2020). Default: `daily-summaries`.
- With data from (`with_data_from`, date): Only stations with data on or after this day. Set it to a recent date to leave out stations that have closed.
- With data until (`with_data_until`, date): Only stations with data on or before this day.
- Only stations that measure temperature (`temperature_only`, true/false): Leave out stations that only measure rain and snow, which are most stations in towns. Default: `false`.
- How many to return (`limit`, number): How many stations to list, up to 100. From 1 to 100. Default: `10`.

**Outputs**

- `count` (number): How many are listed.
- `dataset` (text): The dataset searched, such as 'daily-summaries'.
- `dataset_name` (text): What the dataset holds, in words.
- `latitude` (number): The point's latitude.
- `longitude` (number): The point's longitude.
- `note` (text): A warning when NCEI holds too many entries in the area to read them all, so stations may be missing. Empty otherwise.
- `radius_km` (number): How far around the point was searched, in kilometres.
- `stations` (list): The stations, nearest first.
- `total` (number): How many stations are within the radius.

**Example output**

```json
{
  "count": 2,
  "dataset": "daily-summaries",
  "dataset_name": "Daily weather (GHCN-Daily)",
  "latitude": 40.78,
  "longitude": -73.97,
  "note": null,
  "radius_km": 10.0,
  "stations": [
    {
      "data_types": [
        "ACMH",
        "ACSH",
        "ADPT",
        "ASLP"
      ],
      "data_types_count": 59,
      "distance_km": 0.1,
      "first_date": "1869-01-01",
      "id": "USW00094728",
      "last_date": "2026-10-18",
      "latitude": 40.77898,
      "longitude": -73.96925,
      "name": "NY CITY CENTRAL PARK, NY US",
      "page_url": "https://www.ncei.noaa.gov/cdo-web/datasets/GHCND/stations/GHCND:USW00094728/detail"
    },
    {
      "data_types": [
        "ACMH",
        "ACSH",
        "ADPT",
        "ASLP"
      ],
      "data_types_count": 52,
      "distance_km": 7.6,
      "first_date": "1939-10-07",
      "id": "USW00014732",
      "last_date": "2026-10-18",
      "latitude": 40.77945,
      "longitude": -73.88027,
      "name": "LAGUARDIA AIRPORT, NY US",
      "page_url": "https://www.ncei.noaa.gov/cdo-web/datasets/GHCND/stations/GHCND:USW00014732/detail"
    }
  ],
  "total": 2
}
```

### Get a dataset

Get one NCEI dataset's description, the years it covers, its DOI to cite, its keywords and every kind of data it holds, with units where NCEI gives them. No API key required.

**Inputs**

- Dataset (`dataset`, text, required): The dataset: pick one, or type its ID, such as daily-summaries.

**Outputs**

- `data_types` (list): Each kind of data the dataset holds.
- `dataset` (object): The dataset.
- `found` (true/false): True when NCEI has the dataset.
- `keywords` (list): The science keywords NCEI files it under.
- `note` (text): What to check when the dataset was not found. Empty otherwise.

**Example output**

```json
{
  "data_types": [
    {
      "code": "EMXT",
      "metric_unit": "celsius",
      "name": "Extreme maximum temperature",
      "standard_unit": "fahrenheit"
    },
    {
      "code": "PRCP",
      "metric_unit": "millimeters",
      "name": "Precipitation",
      "standard_unit": "inches"
    },
    {
      "code": "TAVG",
      "metric_unit": "celsius",
      "name": "Average Average Temperature",
      "standard_unit": "fahrenheit"
    }
  ],
  "dataset": {
    "data_types_count": 146,
    "description": "This Global Summaries dataset, known as GSOY for Yearly, contains a yearly resolution of meteorological elements from 1763 to present with updates applied weekly.",
    "doi_url": "https://doi.org/10.7289/JWPF-Y430",
    "end_date": "2026-10-23",
    "frequency": "weekly",
    "id": "global-summary-of-the-year",
    "name": "Global Summary of the Year (GSOY), Version 1",
    "observation_types": [],
    "page_url": "https://www.ncei.noaa.gov/access/search/data-search/global-summary-of-the-year/",
    "read_by_step": "Get yearly summaries",
    "start_date": "1763-01-01"
  },
  "found": true,
  "keywords": [
    "PRECIPITATION AMOUNT",
    "RAIN",
    "SNOW",
    "SURFACE PRESSURE",
    "MAXIMUM/MINIMUM TEMPERATURE",
    "HEATING DEGREE DAYS",
    "COOLING DEGREE DAYS",
    "FREEZING INDEX",
    "SURFACE WINDS",
    "FOG",
    "RAIN STORMS"
  ],
  "note": null
}
```

### Get a station

Get a weather station's name, location and the dates it has data for in a dataset, with every kind of data it keeps, when each starts and ends, and how complete it is. Check a station before reading it. No API key required.

**Inputs**

- Station (`station`, text, required): The weather station: pick a major airport or city, or type any NCEI station ID, such as USW00094728 for New York's Central Park. 'Find stations near a place' gives the ID of any station.
- Dataset (`dataset`, text): Which data the stations must have: daily weather has the most stations worldwide; hourly observations and normals cover the U.S. only. One of: `daily-summaries` (Daily weather (GHCN-Daily)), `global-summary-of-the-month` (Monthly summaries (GSOM)), `global-summary-of-the-year` (Yearly summaries (GSOY)), `local-climatological-data-v2` (Hourly observations (Local Climatological Data)), `normals-daily-1991-2020` (Daily climate normals, 1991 to 2020), `normals-monthly-1991-2020` (Monthly climate normals, 1991 to 2020), `normals-annualseasonal-1991-2020` (Annual and seasonal climate normals, 1991 to 2020). Default: `daily-summaries`.

**Outputs**

- `data_types` (list): Each kind of data the station has, by code.
- `data_types_count` (number): How many kinds of data the station has.
- `dataset` (text): The dataset searched, such as 'daily-summaries'.
- `dataset_name` (text): What the dataset holds, in words.
- `first_date` (text): The first day the station has data for, as YYYY-MM-DD.
- `found` (true/false): True when NCEI has the station in the dataset.
- `last_date` (text): The last day the station has data for, as YYYY-MM-DD.
- `note` (text): What to check when the station was not found. Empty otherwise.
- `station` (object): The station.

**Example output**

```json
{
  "data_types": [
    {
      "code": "PRCP",
      "coverage_percent": 100.0,
      "first_date": "1869-01-01",
      "last_date": "2025-12-31",
      "name": "Precipitation"
    },
    {
      "code": "SNOW",
      "coverage_percent": 100.0,
      "first_date": "1869-01-01",
      "last_date": "2025-12-31",
      "name": "Total Monthly Snowfall"
    },
    {
      "code": "TAVG",
      "coverage_percent": 100.0,
      "first_date": "1870-01-01",
      "last_date": "2025-12-31",
      "name": "Average Average Temperature"
    }
  ],
  "data_types_count": 50,
  "dataset": "global-summary-of-the-year",
  "dataset_name": "Yearly summaries (GSOY)",
  "first_date": "1869-01-01",
  "found": true,
  "last_date": "2026-12-31",
  "note": null,
  "station": {
    "id": "USW00094728",
    "latitude": 40.77898,
    "longitude": -73.96925,
    "name": "NY CITY CENTRAL PARK, NY US",
    "page_url": "https://www.ncei.noaa.gov/cdo-web/datasets/GHCND/stations/GHCND:USW00094728/detail"
  }
}
```

### Get annual climate normals

Get a U.S. station's normal year and seasons: average temperatures, precipitation and snowfall, hot and frosty days, degree days, and the usual dates of the last spring frost and first autumn frost with the length of the growing season. No API key required.

**Inputs**

- Station (`station`, text, required): The U.S. weather station: pick a major airport, or type any NCEI station ID, such as USW00094846 for Chicago O'Hare. NCEI keeps this data for U.S. stations only.
- Normals period (`period`, text): The official 30-year normals (1991 to 2020), or the 15-year normals (2006 to 2020) that show the more recent climate. One of: `1991-2020` (1991 to 2020 (official 30-year normals)), `2006-2020` (2006 to 2020 (15-year supplemental normals)). Default: `1991-2020`.
- Units (`units`, text): Metric (°C, mm, m/s) or US standard units (°F, inches, mph). One of: `metric` (Metric (°C, mm, m/s)), `standard` (US standard (°F, inches, mph)). Default: `metric`.

**Outputs**

- `annual` (object): The year's normals. Empty when the station has none.
- `download_url` (text): A link that downloads the same data from NCEI as a CSV file, to open in a spreadsheet or attach to an email.
- `found` (true/false): True when NCEI has annual normals for the station.
- `freezes` (list): When the last spring and first autumn frosts and freezes usually come, mildest first. Dates are empty where they are too rare to date.
- `note` (text): Why nothing came back, and what to check, when NCEI had no data for the request. Empty otherwise.
- `period` (text): The normals period, '1991-2020' or '2006-2020'.
- `seasons` (list): The four seasons' normals, winter first.
- `station` (object): The station the normals are for.
- `units` (object): The units the values are in.

**Example output**

```json
{
  "annual": {
    "avg_temperature": 13.2,
    "cooling_degree_days": 678.6,
    "days_with_heavy_precipitation": 13.6,
    "days_with_precipitation": 125.4,
    "days_with_snow_cover": 24.2,
    "days_with_snowfall": 7.0,
    "frost_days": 67.3,
    "growing_degree_days": 2148.5,
    "heating_degree_days": 2529.6,
    "hot_days": 17.4,
    "max_temperature": 17.0,
    "min_temperature": 9.4,
    "precipitation": 1257.8,
    "snowfall": 756.9
  },
  "download_url": "https://www.ncei.noaa.gov/access/services/data/v1?dataset=normals-annualseasonal-1991-2020&stations=USW00094728&dataTypes=ANN-TMAX-NORMAL%2CANN-TMIN-NORMAL%2CANN-TAVG-NORMAL%2CANN-PRCP-NORMAL%2CANN-SNOW-NORMAL%2CANN-HTDD-NORMAL%2CANN-CLDD-NORMAL%2CANN-GRDD-BASE50%2CANN-PRCP-AVGNDS-GE001HI%2CANN-PRCP-AVGNDS-GE100HI%2CANN-SNOW-AVGNDS-GE010TI%2CANN-SNWD-AVGNDS-GE001WI%2CANN-TMAX-AVGNDS-GRTH090%2CANN-TMIN-AVGNDS-LSTH032%2CDJF-TMAX-NORMAL%2CDJF-TMIN-NORMAL%2CDJF-TAVG-NORMAL%2CDJF-PRCP-NORMAL%2CDJF-SNOW-NORMAL%2CMAM-TMAX-NORMAL%2CMAM-TMIN-NORMAL%2CMAM-TAVG-NORMAL%2CMAM-PRCP-NORMAL%2CMAM-SNOW-NORMAL%2CJJA-TMAX-NORMAL%2CJJA-TMIN-NORMAL%2CJJA-TAVG-NORMAL%2CJJA-PRCP-NORMAL%2CJJA-SNOW-NORMAL%2CSON-TMAX-NORMAL%2CSON-TMIN-NORMAL%2CSON-TAVG-NORMAL%2CSON-PRCP-NORMAL%2CSON-SNOW-NORMAL%2CANN-TMIN-PRBLST-T36FP50%2CANN-TMIN-PRBLST-T36FP10%2CANN-TMIN-PRBFST-T36FP50%2CANN-TMIN-PRBFST-T36FP10%2CANN-TMIN-PRBGSL-T36FP50%2CANN-TMIN-PRBGSL-T36FP90%2CANN-TMIN-PRBLST-T32FP50%2CANN-TMIN-PRBLST-T32FP10%2CANN-TMIN-PRBFST-T32FP50%2CANN-TMIN-PRBFST-T32FP10%2CANN-TMIN-PRBGSL-T32FP50%2CANN-TMIN-PRBGSL-T32FP90%2CANN-TMIN-PRBLST-T28FP50%2CANN-TMIN-PRBLST-T28FP10%2CANN-TMIN-PRBFST-T28FP50%2CANN-TMIN-PRBFST-T28FP10%2CANN-TMIN-PRBGSL-T28FP50%2CANN-TMIN-PRBGSL-T28FP90&units=standard&includeStationName=true&includeStationLocation=true&startDate=2024-01-01&endDate=2024-12-31&format=csv",
  "found": true,
  "freezes": [
    {
      "first_fall_early": "10-27",
      "first_fall_median": "11-08",
      "growing_season_days_median": 215,
      "growing_season_days_short": 196,
      "last_spring_late": "04-20",
      "last_spring_median": "04-07",
      "name": "Light frost",
      "threshold": 2.2
    },
    {
      "first_fall_early": "11-06",
      "first_fall_median": "11-20",
      "growing_season_days_median": 236,
      "growing_season_days_short": 217,
      "last_spring_late": "04-09",
      "last_spring_median": "03-30",
      "name": "Freeze",
      "threshold": 0.0
    },
    {
      "first_fall_early": "11-15",
      "first_fall_median": "12-01",
      "growing_season_days_median": 257,
      "growing_season_days_short": 236,
      "last_spring_late": "04-02",
      "last_spring_median": "03-19",
      "name": "Hard freeze",
      "threshold": -2.2
    }
  ],
  "note": null,
  "period": "1991-2020",
  "seasons": [
    {
      "avg_temperature": 2.3,
      "max_temperature": 5.6,
      "min_temperature": -0.9,
      "months": "December to February",
      "precipitation": 284.7,
      "season": "winter",
      "snowfall": 604.5
    },
    {
      "avg_temperature": 11.8,
      "max_temperature": 16.1,
      "min_temperature": 7.4,
      "months": "March to May",
      "precipitation": 313.4,
      "season": "spring",
      "snowfall": 137.2
    },
    {
      "avg_temperature": 24.0,
      "max_temperature": 28.1,
      "min_temperature": 19.9,
      "months": "June to August",
      "precipitation": 348.0,
      "season": "summer",
      "snowfall": 0.0
    },
    {
      "avg_temperature": 14.7,
      "max_temperature": 18.3,
      "min_temperature": 11.1,
      "months": "September to November",
      "precipitation": 311.7,
      "season": "autumn",
      "snowfall": 15.2
    }
  ],
  "station": {
    "elevation_m": 39.6,
    "id": "USW00094728",
    "latitude": 40.7789,
    "longitude": -73.9692,
    "name": "NEW YORK CNTRL PK TWR, NY US",
    "page_url": "https://www.ncei.noaa.gov/cdo-web/datasets/GHCND/stations/GHCND:USW00094728/detail"
  },
  "units": {
    "degree_days": "\u00b0C degree days",
    "precipitation": "mm",
    "snow": "mm",
    "system": "metric",
    "temperature": "\u00b0C"
  }
}
```

### Get daily climate normals

Get what is normal at a U.S. station for each calendar day: the 30-year average high, low and mean temperature, the chance of rain and snow, precipitation and snowfall so far that month and year, and heating, cooling and growing degree days. Compare a day's weather with normal. No API key required.

**Inputs**

- Station (`station`, text, required): The U.S. weather station: pick a major airport, or type any NCEI station ID, such as USW00094846 for Chicago O'Hare. NCEI keeps this data for U.S. stations only.
- Start date (`start_date`, date): The first calendar day to get; its year is ignored. Leave empty for the whole year.
- End date (`end_date`, date): The last calendar day to get; its year is ignored, so 20 December to 5 January works. Leave empty for the start day alone.
- Normals period (`period`, text): The official 30-year normals (1991 to 2020), or the 15-year normals (2006 to 2020) that show the more recent climate. One of: `1991-2020` (1991 to 2020 (official 30-year normals)), `2006-2020` (2006 to 2020 (15-year supplemental normals)). Default: `1991-2020`.
- Units (`units`, text): Metric (°C, mm, m/s) or US standard units (°F, inches, mph). One of: `metric` (Metric (°C, mm, m/s)), `standard` (US standard (°F, inches, mph)). Default: `metric`.

**Outputs**

- `count` (number): How many days came back.
- `days` (list): One row per calendar day, in the order asked for. A value is empty when the station has too short a record for it.
- `download_url` (text): A link that downloads the same data from NCEI as a CSV file, to open in a spreadsheet or attach to an email.
- `note` (text): Why nothing came back, and what to check, when NCEI had no data for the request. Empty otherwise.
- `period` (text): The normals period, '1991-2020' or '2006-2020'.
- `station` (object): The station the normals are for.
- `units` (object): The units the values are in.

**Example output**

```json
{
  "count": 2,
  "days": [
    {
      "avg_temperature": 1.9,
      "chance_of_heavy_precipitation": 9.8,
      "chance_of_precipitation": 35.8,
      "chance_of_snow_cover": 15.5,
      "chance_of_snowfall": 8.8,
      "cooling_degree_days": 0.0,
      "date": "12-31",
      "day": 31,
      "growing_degree_days": 0.1,
      "heating_degree_days": 16.4,
      "max_temperature": 4.8,
      "min_temperature": -1.1,
      "month": 12,
      "precipitation_month_to_date": 111.3,
      "precipitation_year_to_date": 1257.8,
      "snowfall_month_to_date": 124.5,
      "snowfall_year_to_date": 756.9
    },
    {
      "avg_temperature": 1.8,
      "chance_of_heavy_precipitation": 9.7,
      "chance_of_precipitation": 35.8,
      "chance_of_snow_cover": 16.0,
      "chance_of_snowfall": 9.0,
      "cooling_degree_days": 0.0,
      "date": "01-01",
      "day": 1,
      "growing_degree_days": 0.1,
      "heating_degree_days": 16.6,
      "max_temperature": 4.8,
      "min_temperature": -1.2,
      "month": 1,
      "precipitation_month_to_date": 3.0,
      "precipitation_year_to_date": 3.0,
      "snowfall_month_to_date": 5.1,
      "snowfall_year_to_date": 5.1
    }
  ],
  "download_url": "https://www.ncei.noaa.gov/access/services/data/v1?dataset=normals-daily-1991-2020&stations=USW00094728&dataTypes=DLY-TMAX-NORMAL%2CDLY-TMIN-NORMAL%2CDLY-TAVG-NORMAL%2CDLY-HTDD-NORMAL%2CDLY-CLDD-NORMAL%2CDLY-GRDD-BASE50%2CMTD-PRCP-NORMAL%2CYTD-PRCP-NORMAL%2CMTD-SNOW-NORMAL%2CYTD-SNOW-NORMAL%2CDLY-PRCP-PCTALL-GE001HI%2CDLY-PRCP-PCTALL-GE050HI%2CDLY-SNOW-PCTALL-GE001TI%2CDLY-SNWD-PCTALL-GE001WI&units=standard&includeStationName=true&includeStationLocation=true&startDate=2024-01-01&endDate=2024-12-31&format=csv",
  "note": null,
  "period": "1991-2020",
  "station": {
    "elevation_m": 39.6,
    "id": "USW00094728",
    "latitude": 40.7789,
    "longitude": -73.9692,
    "name": "NEW YORK CNTRL PK TWR, NY US",
    "page_url": "https://www.ncei.noaa.gov/cdo-web/datasets/GHCND/stations/GHCND:USW00094728/detail"
  },
  "units": {
    "degree_days": "\u00b0C degree days",
    "precipitation": "mm",
    "snow": "mm",
    "system": "metric",
    "temperature": "\u00b0C"
  }
}
```

### Get daily weather

Get a station's weather for each day between two dates, up to a year: high and low temperature, precipitation, snowfall, snow depth, wind, sunshine and humidity where recorded, and what happened (fog, thunder, hail), with NCEI's quality flags in words. From GHCN-Daily, which covers over 100,000 stations worldwide; data arrives 2 to 5 days late. No API key required.

**Inputs**

- Station (`station`, text, required): The weather station: pick a major airport or city, or type any NCEI station ID, such as USW00094728 for New York's Central Park. 'Find stations near a place' gives the ID of any station.
- Start date (`start_date`, date, required): The first day to get.
- End date (`end_date`, date): The last day to get, up to 366 days after the start. Leave empty for the start date alone.
- Data types (`data_types`, list): Which values to get. Leave empty for everything the station records, including rarer values such as soil temperatures. One or more of: `TMAX` (Maximum temperature), `TMIN` (Minimum temperature), `TAVG` (Average temperature), `TOBS` (Temperature at observation time), `PRCP` (Precipitation (rain and melted snow)), `SNOW` (Snowfall), `SNWD` (Snow depth), `WESD` (Water held in the snow cover), `AWND` (Average wind speed), `WSF2` (Fastest 2-minute wind speed), and 15 more.
- Units (`units`, text): Metric (°C, mm, m/s) or US standard units (°F, inches, mph). One of: `metric` (Metric (°C, mm, m/s)), `standard` (US standard (°F, inches, mph)). Default: `metric`.

**Outputs**

- `count` (number): How many days NCEI has data for.
- `days` (list): One row per day, oldest first.
- `download_url` (text): A link that downloads the same data from NCEI as a CSV file, to open in a spreadsheet or attach to an email.
- `end_date` (text): The last day asked for, as YYYY-MM-DD.
- `note` (text): Why nothing came back, and what to check, when NCEI had no data for the request. Empty otherwise.
- `start_date` (text): The first day asked for, as YYYY-MM-DD.
- `station` (object): The station the days come from.
- `units` (object): The units the values are in.

**Example output**

```json
{
  "count": 2,
  "days": [
    {
      "avg_dew_point": null,
      "avg_relative_humidity": null,
      "avg_sea_level_pressure": null,
      "avg_temperature": null,
      "avg_wind_speed": 4.4,
      "date": "2026-01-25",
      "evaporation": null,
      "fastest_2min_wind_direction": 70,
      "fastest_2min_wind_speed": 9.4,
      "fastest_5sec_wind_direction": 60,
      "fastest_5sec_wind_speed": 13.9,
      "flags": [],
      "max_relative_humidity": null,
      "max_temperature": -5.6,
      "min_relative_humidity": null,
      "min_temperature": -12.2,
      "other_values": [],
      "peak_gust_direction": null,
      "peak_gust_speed": null,
      "peak_gust_time": null,
      "precipitation": 45.7,
      "snow_depth": 25.0,
      "snow_water_equivalent": null,
      "snowfall": 290.0,
      "sunshine_minutes": null,
      "sunshine_percent": null,
      "temperature_at_observation": null,
      "weather": [
        "Fog, ice fog or freezing fog",
        "Heavy fog or heavy freezing fog",
        "Glaze or rime",
        "Smoke or haze",
        "Blowing or drifting snow"
      ]
    },
    {
      "avg_dew_point": null,
      "avg_relative_humidity": null,
      "avg_sea_level_pressure": null,
      "avg_temperature": null,
      "avg_wind_speed": 2.8,
      "date": "2026-01-26",
      "evaporation": null,
      "fastest_2min_wind_direction": 300,
      "fastest_2min_wind_speed": 8.9,
      "fastest_5sec_wind_direction": 290,
      "fastest_5sec_wind_speed": 16.5,
      "flags": [
        {
          "code": "T",
          "field": "snowfall",
          "kind": "measurement",
          "meaning": "Trace: too small to measure"
        }
      ],
      "max_relative_humidity": null,
      "max_temperature": -2.8,
      "min_relative_humidity": null,
      "min_temperature": -8.3,
      "other_values": [],
      "peak_gust_direction": null,
      "peak_gust_speed": null,
      "peak_gust_time": null,
      "precipitation": 0.5,
      "snow_depth": 229.0,
      "snow_water_equivalent": null,
      "snowfall": 0.0,
      "sunshine_minutes": null,
      "sunshine_percent": null,
      "temperature_at_observation": null,
      "weather": [
        "Fog, ice fog or freezing fog",
        "Smoke or haze"
      ]
    }
  ],
  "download_url": "https://www.ncei.noaa.gov/access/services/data/v1?dataset=daily-summaries&stations=USW00094728&startDate=2026-01-25&endDate=2026-01-26&units=metric&includeAttributes=true&includeStationName=true&includeStationLocation=true&format=csv",
  "end_date": "2026-01-26",
  "note": null,
  "start_date": "2026-01-25",
  "station": {
    "elevation_m": 42.7,
    "id": "USW00094728",
    "latitude": 40.77898,
    "longitude": -73.96925,
    "name": "NY CITY CENTRAL PARK, NY US",
    "page_url": "https://www.ncei.noaa.gov/cdo-web/datasets/GHCND/stations/GHCND:USW00094728/detail"
  },
  "units": {
    "precipitation": "mm",
    "pressure": "hPa",
    "snow": "mm",
    "system": "metric",
    "temperature": "\u00b0C",
    "wind_speed": "m/s"
  }
}
```

### Get hourly observations

Get the hourly weather reports from a U.S. airport or weather office between two dates, up to 31 days: temperature, dew point, humidity, wind and gusts, visibility, pressure, precipitation, clouds and the weather reported (rain, snow, thunderstorm), in local standard time. From NCEI's Local Climatological Data, usually a day or two behind. No API key required.

**Inputs**

- Station (`station`, text, required): The U.S. weather station: pick a major airport, or type any NCEI station ID, such as USW00094846 for Chicago O'Hare. NCEI keeps this data for U.S. stations only.
- Start date (`start_date`, date, required): The first day to get.
- End date (`end_date`, date): The last day to get, up to 31 days after the start. Leave empty for the start date alone.
- Include special reports (`include_special_reports`, true/false): Also list the extra reports a station sends between hours when the weather changes quickly. Off gives one report an hour. Default: `false`.
- Units (`units`, text): Metric (°C, mm, m/s) or US standard units (°F, inches, mph). One of: `metric` (Metric (°C, mm, m/s)), `standard` (US standard (°F, inches, mph)). Default: `metric`.

**Outputs**

- `count` (number): How many observations came back.
- `download_url` (text): A link that downloads the same data from NCEI as a CSV file, to open in a spreadsheet or attach to an email.
- `end_date` (text): The last day asked for, as YYYY-MM-DD.
- `note` (text): Why nothing came back, and what to check, when NCEI had no data for the request. Empty otherwise.
- `observations` (list): One row per report, oldest first.
- `start_date` (text): The first day asked for, as YYYY-MM-DD.
- `station` (object): The station the observations come from.
- `time_zone` (text): The time the observations are dated in.
- `units` (object): The units the values are in.

**Example output**

```json
{
  "count": 2,
  "download_url": "https://www.ncei.noaa.gov/access/services/data/v1?dataset=local-climatological-data-v2&stations=USW00094846&startDate=2024-07-15T00%3A00%3A00&endDate=2024-07-15T23%3A59%3A59&units=metric&includeStationName=true&includeStationLocation=true&format=csv",
  "end_date": "2024-07-15",
  "note": null,
  "observations": [
    {
      "altimeter_setting": 1011.5,
      "cloud_cover": "Scattered clouds",
      "cloud_layers": [
        {
          "base_height": 152,
          "code": "FEW",
          "cover": "Few clouds",
          "oktas": 2
        },
        {
          "base_height": 7620,
          "code": "SCT",
          "cover": "Scattered clouds",
          "oktas": 4
        }
      ],
      "dew_point": 20.6,
      "local_time": "2024-07-15T06:51:00",
      "precipitation": 0.0,
      "precipitation_trace": false,
      "pressure_change_3h": null,
      "raw_report": "MET10507/15/24 06:51:02 METAR KORD 151251Z VRB04KT 10SM FEW005 SCT250 22/21 A2987 RMK AO2 SLP107 T02220206 (JD)",
      "relative_humidity": 91,
      "report_type": "FM-15",
      "report_type_name": "Routine hourly report (METAR)",
      "sea_level_pressure": 1010.7,
      "station_pressure": 987.1,
      "temperature": 22.2,
      "visibility": 16.093,
      "weather": [],
      "wet_bulb_temperature": 21.1,
      "wind_direction": null,
      "wind_direction_variable": true,
      "wind_gust": null,
      "wind_speed": 2.1
    },
    {
      "altimeter_setting": 1006.4,
      "cloud_cover": "Overcast",
      "cloud_layers": [
        {
          "base_height": 579,
          "code": "BKN",
          "cover": "Broken clouds",
          "oktas": 7
        },
        {
          "base_height": 1219,
          "code": "BKN",
          "cover": "Broken clouds",
          "oktas": 7
        },
        {
          "base_height": 4267,
          "code": "OVC",
          "cover": "Overcast",
          "oktas": 8
        }
      ],
      "dew_point": 20.6,
      "local_time": "2024-07-15T20:51:00",
      "precipitation": 2.5,
      "precipitation_trace": false,
      "pressure_change_3h": 2.0,
      "raw_report": "MET23207/15/24 20:51:01 METAR KORD 160251Z 32024G50KT 1 1/2SM R10L/3500VP6000FT +TSRA BR SQ BKN019CB BKN040 OVC140 22/21 A2972 RMK AO2 PK WND 26065/0239 RAB38 TSB26 PRESRR SLP060 CONS LTGCGIC OHD TS O",
      "relative_humidity": 94,
      "report_type": "FM-15",
      "report_type_name": "Routine hourly report (METAR)",
      "sea_level_pressure": 1006.0,
      "station_pressure": 982.2,
      "temperature": 21.7,
      "visibility": 2.414,
      "weather": [
        "Thunderstorm",
        "Heavy rain",
        "Mist"
      ],
      "wet_bulb_temperature": 20.9,
      "wind_direction": 320,
      "wind_direction_variable": false,
      "wind_gust": 25.7,
      "wind_speed": 12.4
    }
  ],
  "start_date": "2024-07-15",
  "station": {
    "elevation_m": 201.8,
    "id": "USW00094846",
    "latitude": 41.96019,
    "longitude": -87.93162,
    "name": "CHICAGO OHARE INTERNATIONAL AIRPORT, IL US",
    "page_url": "https://www.ncei.noaa.gov/cdo-web/datasets/GHCND/stations/GHCND:USW00094846/detail"
  },
  "time_zone": "Local standard time at the station (no daylight saving)",
  "units": {
    "cloud_height": "m",
    "precipitation": "mm",
    "pressure": "hPa",
    "system": "metric",
    "temperature": "\u00b0C",
    "visibility": "km",
    "wind_speed": "m/s"
  }
}
```

### Get monthly climate normals

Get a U.S. station's normal weather for each month: the 30-year average high, low and mean temperature, precipitation, snowfall, rainy, snowy, hot and frosty days, the chance of a frost, and degree days. No API key required.

**Inputs**

- Station (`station`, text, required): The U.S. weather station: pick a major airport, or type any NCEI station ID, such as USW00094846 for Chicago O'Hare. NCEI keeps this data for U.S. stations only.
- Normals period (`period`, text): The official 30-year normals (1991 to 2020), or the 15-year normals (2006 to 2020) that show the more recent climate. One of: `1991-2020` (1991 to 2020 (official 30-year normals)), `2006-2020` (2006 to 2020 (15-year supplemental normals)). Default: `1991-2020`.
- Units (`units`, text): Metric (°C, mm, m/s) or US standard units (°F, inches, mph). One of: `metric` (Metric (°C, mm, m/s)), `standard` (US standard (°F, inches, mph)). Default: `metric`.

**Outputs**

- `count` (number): How many months came back (12 when the station has normals).
- `download_url` (text): A link that downloads the same data from NCEI as a CSV file, to open in a spreadsheet or attach to an email.
- `months` (list): One row per month, January first.
- `note` (text): Why nothing came back, and what to check, when NCEI had no data for the request. Empty otherwise.
- `period` (text): The normals period, '1991-2020' or '2006-2020'.
- `station` (object): The station the normals are for.
- `units` (object): The units the values are in.

**Example output**

```json
{
  "count": 2,
  "download_url": "https://www.ncei.noaa.gov/access/services/data/v1?dataset=normals-monthly-1991-2020&stations=USW00094728&dataTypes=MLY-TMAX-NORMAL%2CMLY-TMIN-NORMAL%2CMLY-TAVG-NORMAL%2CMLY-PRCP-NORMAL%2CMLY-SNOW-NORMAL%2CMLY-HTDD-NORMAL%2CMLY-CLDD-NORMAL%2CMLY-GRDD-BASE50%2CMLY-PRCP-AVGNDS-GE001HI%2CMLY-PRCP-AVGNDS-GE100HI%2CMLY-SNOW-AVGNDS-GE010TI%2CMLY-SNWD-AVGNDS-GE001WI%2CMLY-TMAX-AVGNDS-GRTH090%2CMLY-TMIN-AVGNDS-LSTH032%2CMLY-TMIN-PRBOCC-LSTH032&units=standard&includeStationName=true&includeStationLocation=true&startDate=2024-01-01&endDate=2024-12-31&format=csv",
  "months": [
    {
      "avg_temperature": 0.9,
      "chance_of_frost": 100.0,
      "cooling_degree_days": 0.0,
      "days_with_heavy_precipitation": 0.9,
      "days_with_precipitation": 10.8,
      "days_with_snow_cover": 7.9,
      "days_with_snowfall": 2.1,
      "frost_days": 20.5,
      "growing_degree_days": 2.4,
      "heating_degree_days": 538.9,
      "hot_days": 0.0,
      "max_temperature": 4.2,
      "min_temperature": -2.3,
      "month": 1,
      "month_name": "January",
      "precipitation": 92.5,
      "snowfall": 223.5
    },
    {
      "avg_temperature": 2.2,
      "chance_of_frost": 100.0,
      "cooling_degree_days": 0.0,
      "days_with_heavy_precipitation": 1.0,
      "days_with_precipitation": 10.0,
      "days_with_snow_cover": 9.1,
      "days_with_snowfall": 2.2,
      "frost_days": 17.7,
      "growing_degree_days": 3.5,
      "heating_degree_days": 453.4,
      "hot_days": 0.0,
      "max_temperature": 5.7,
      "min_temperature": -1.4,
      "month": 2,
      "month_name": "February",
      "precipitation": 81.0,
      "snowfall": 256.5
    }
  ],
  "note": null,
  "period": "1991-2020",
  "station": {
    "elevation_m": 39.6,
    "id": "USW00094728",
    "latitude": 40.7789,
    "longitude": -73.9692,
    "name": "NEW YORK CNTRL PK TWR, NY US",
    "page_url": "https://www.ncei.noaa.gov/cdo-web/datasets/GHCND/stations/GHCND:USW00094728/detail"
  },
  "units": {
    "degree_days": "\u00b0C degree days",
    "precipitation": "mm",
    "snow": "mm",
    "system": "metric",
    "temperature": "\u00b0C"
  }
}
```

### Get monthly summaries

Get a station's weather month by month, up to 30 years: average, highest and lowest temperatures and the day each happened, total precipitation and snowfall, the wettest day, days of rain, snow, heat and frost, and heating and cooling degree days. From NCEI's Global Summary of the Month. No API key required.

**Inputs**

- Station (`station`, text, required): The weather station: pick a major airport or city, or type any NCEI station ID, such as USW00094728 for New York's Central Park. 'Find stations near a place' gives the ID of any station.
- Start month (`start_date`, date, required): Any day in the first month to get.
- End month (`end_date`, date): Any day in the last month to get, up to 30 years on. Leave empty for the start month alone.
- Units (`units`, text): Metric (°C, mm, m/s) or US standard units (°F, inches, mph). One of: `metric` (Metric (°C, mm, m/s)), `standard` (US standard (°F, inches, mph)). Default: `metric`.

**Outputs**

- `count` (number): How many months NCEI has a summary for.
- `download_url` (text): A link that downloads the same data from NCEI as a CSV file, to open in a spreadsheet or attach to an email.
- `end_month` (text): The last month asked for, as YYYY-MM.
- `months` (list): One row per month, oldest first. Every value is empty when the station does not record it.
- `note` (text): Why nothing came back, and what to check, when NCEI had no data for the request. Empty otherwise.
- `start_month` (text): The first month asked for, as YYYY-MM.
- `station` (object): The station the months come from.
- `units` (object): The units the values are in.

**Example output**

```json
{
  "count": 2,
  "download_url": "https://www.ncei.noaa.gov/access/services/data/v1?dataset=global-summary-of-the-month&stations=USW00094728&startDate=2026-01-01&endDate=2026-02-28&units=metric&includeAttributes=true&includeStationName=true&includeStationLocation=true&format=csv",
  "end_month": "2026-02",
  "months": [
    {
      "avg_max_temperature": 2.3,
      "avg_min_temperature": -4.1,
      "avg_temperature": -0.9,
      "avg_wind_speed": 2.9,
      "cooling_degree_days": 0.0,
      "days_with_heavy_precipitation": 1,
      "days_with_moderate_precipitation": 4,
      "days_with_precipitation": 10,
      "days_with_snow_cover": 13,
      "days_with_snowfall": 3,
      "flags": [],
      "fog_days": 9,
      "freezing_days": 12,
      "frost_days": 22,
      "heating_degree_days": 595.9,
      "heavy_fog_days": 3,
      "highest_temperature": 12.2,
      "highest_temperature_date": "2026-01-09",
      "hot_days": 0,
      "lowest_temperature": -12.8,
      "lowest_temperature_date": "2026-01-30",
      "max_daily_precipitation": 45.7,
      "max_daily_precipitation_date": "2026-01-25",
      "max_daily_snowfall": 290.0,
      "max_daily_snowfall_date": "2026-01-25",
      "max_snow_depth": 229,
      "max_snow_depth_date": "2026-01-26",
      "max_wind_gust": 17.4,
      "month": "2026-01",
      "precipitation": 68.7,
      "snowfall": 353,
      "thunderstorm_days": null,
      "very_cold_days": 0,
      "warm_days": 0
    },
    {
      "avg_max_temperature": 3.1,
      "avg_min_temperature": -3.6,
      "avg_temperature": -0.3,
      "avg_wind_speed": 2.9,
      "cooling_degree_days": 0.0,
      "days_with_heavy_precipitation": 1,
      "days_with_moderate_precipitation": 4,
      "days_with_precipitation": 9,
      "days_with_snow_cover": 22,
      "days_with_snowfall": 3,
      "flags": [],
      "fog_days": 14,
      "freezing_days": 6,
      "frost_days": 20,
      "heating_degree_days": 520.7,
      "heavy_fog_days": 3,
      "highest_temperature": 12.2,
      "highest_temperature_date": "2026-02-28",
      "hot_days": 0,
      "lowest_temperature": -16.1,
      "lowest_temperature_date": "2026-02-08",
      "max_daily_precipitation": 26.9,
      "max_daily_precipitation_date": "2026-02-23",
      "max_daily_snowfall": 277.0,
      "max_daily_snowfall_date": "2026-02-23",
      "max_snow_depth": 356,
      "max_snow_depth_date": "2026-02-24",
      "max_wind_gust": 20.6,
      "month": "2026-02",
      "precipitation": 66.0,
      "snowfall": 568,
      "thunderstorm_days": null,
      "very_cold_days": 0,
      "warm_days": 0
    }
  ],
  "note": null,
  "start_month": "2026-01",
  "station": {
    "elevation_m": 42.7,
    "id": "USW00094728",
    "latitude": 40.77898,
    "longitude": -73.96925,
    "name": "NY CITY CENTRAL PARK, NY US",
    "page_url": "https://www.ncei.noaa.gov/cdo-web/datasets/GHCND/stations/GHCND:USW00094728/detail"
  },
  "units": {
    "degree_days": "\u00b0C degree days",
    "precipitation": "mm",
    "snow": "mm",
    "system": "metric",
    "temperature": "\u00b0C",
    "wind_speed": "m/s"
  }
}
```

### Get yearly summaries

Get a station's weather year by year, for as many years as it has: average, highest and lowest temperatures and their dates, total precipitation and snowfall, days of rain, snow, heat, frost, fog and thunderstorms, and degree days. From NCEI's Global Summary of the Year. No API key required.

**Inputs**

- Station (`station`, text, required): The weather station: pick a major airport or city, or type any NCEI station ID, such as USW00094728 for New York's Central Park. 'Find stations near a place' gives the ID of any station.
- Start year (`start_year`, number, required): The first year to get, such as 2000. From 1763 to 2100.
- End year (`end_year`, number): The last year to get. Leave empty for the start year alone. From 1763 to 2100.
- Units (`units`, text): Metric (°C, mm, m/s) or US standard units (°F, inches, mph). One of: `metric` (Metric (°C, mm, m/s)), `standard` (US standard (°F, inches, mph)). Default: `metric`.

**Outputs**

- `count` (number): How many years NCEI has a summary for.
- `download_url` (text): A link that downloads the same data from NCEI as a CSV file, to open in a spreadsheet or attach to an email.
- `end_year` (number): The last year asked for.
- `note` (text): Why nothing came back, or that the current year is only partly summarized. Empty otherwise.
- `start_year` (number): The first year asked for.
- `station` (object): The station the years come from.
- `units` (object): The units the values are in.
- `years` (list): One row per year, oldest first. Every value is empty when the station does not record it.

**Example output**

```json
{
  "count": 2,
  "download_url": "https://www.ncei.noaa.gov/access/services/data/v1?dataset=global-summary-of-the-year&stations=USW00094728&startDate=2024-01-01&endDate=2025-12-31&units=metric&includeAttributes=true&includeStationName=true&includeStationLocation=true&format=csv",
  "end_year": 2025,
  "note": null,
  "start_year": 2024,
  "station": {
    "elevation_m": 42.7,
    "id": "USW00094728",
    "latitude": 40.77898,
    "longitude": -73.96925,
    "name": "NY CITY CENTRAL PARK, NY US",
    "page_url": "https://www.ncei.noaa.gov/cdo-web/datasets/GHCND/stations/GHCND:USW00094728/detail"
  },
  "units": {
    "degree_days": "\u00b0C degree days",
    "precipitation": "mm",
    "snow": "mm",
    "system": "metric",
    "temperature": "\u00b0C",
    "wind_speed": "m/s"
  },
  "years": [
    {
      "avg_max_temperature": 18.3,
      "avg_min_temperature": 10.5,
      "avg_temperature": 14.4,
      "avg_wind_speed": 2.2,
      "cooling_degree_days": 741.3,
      "days_with_heavy_precipitation": 11,
      "days_with_moderate_precipitation": 78,
      "days_with_precipitation": 125,
      "days_with_snow_cover": 18,
      "days_with_snowfall": 5,
      "flags": [],
      "fog_days": 130,
      "freezing_days": 8,
      "frost_days": 50,
      "heating_degree_days": 2168.1,
      "heavy_fog_days": 15,
      "highest_temperature": 35.0,
      "highest_temperature_date": "2024-08-01",
      "hot_days": 21,
      "lowest_temperature": -10.5,
      "lowest_temperature_date": "2024-12-23",
      "max_daily_precipitation": 93.0,
      "max_daily_precipitation_date": "2024-03-23",
      "max_daily_snowfall": 81.0,
      "max_daily_snowfall_date": "2024-02-13",
      "max_snow_depth": 50,
      "max_snow_depth_date": "2024-12-21",
      "max_wind_gust": 26.4,
      "precipitation": 1178.0,
      "snowfall": 261.0,
      "thunderstorm_days": 24,
      "very_cold_days": 0,
      "warm_days": 164,
      "year": 2024
    },
    {
      "avg_max_temperature": 17.0,
      "avg_min_temperature": 9.3,
      "avg_temperature": 13.1,
      "avg_wind_speed": 2.4,
      "cooling_degree_days": 688.9,
      "days_with_heavy_precipitation": 8,
      "days_with_moderate_precipitation": 74,
      "days_with_precipitation": 121,
      "days_with_snow_cover": 23,
      "days_with_snowfall": 7,
      "flags": [],
      "fog_days": 126,
      "freezing_days": 17,
      "frost_days": 78,
      "heating_degree_days": 2387.4,
      "heavy_fog_days": 14,
      "highest_temperature": 37.2,
      "highest_temperature_date": "2025-06-24",
      "hot_days": 14,
      "lowest_temperature": -12.1,
      "lowest_temperature_date": "2025-01-22",
      "max_daily_precipitation": 67.1,
      "max_daily_precipitation_date": "2025-07-14",
      "max_daily_snowfall": 76.0,
      "max_daily_snowfall_date": "2025-02-08",
      "max_snow_depth": 102,
      "max_snow_depth_date": "2025-12-28",
      "max_wind_gust": 22.4,
      "precipitation": 1006.1,
      "snowfall": 440.0,
      "thunderstorm_days": 23,
      "very_cold_days": 0,
      "warm_days": 150,
      "year": 2025
    }
  ]
}
```

### Search datasets

Search NCEI's datasets (weather, climate normals, radar, satellite, ocean) by words in their names and descriptions, with the years each covers, how often it is updated and its DOI to cite. No API key required.

**Inputs**

- Search text (`query`, text): Words to look for, such as 'precipitation' or 'normals'. Leave empty to list every dataset.
- How many to return (`limit`, number): How many datasets to list, up to 100. From 1 to 100. Default: `25`.

**Outputs**

- `count` (number): How many are listed.
- `datasets` (list): The datasets, best match first.
- `query` (text): The search text, when there was one.
- `total` (number): How many datasets matched.

**Example output**

```json
{
  "count": 2,
  "datasets": [
    {
      "data_types_count": 162,
      "description": "This Global Summaries dataset, known as GSOM for Monthly, contains a monthly resolution of meteorological elements from 1763 to present with updates applied weekly.",
      "doi_url": "https://doi.org/10.7289/V5QV3JJ5",
      "end_date": "2026-10-23",
      "frequency": "weekly",
      "id": "global-summary-of-the-month",
      "name": "Global Summary of the Month (GSOM), Version 1",
      "observation_types": [],
      "page_url": "https://www.ncei.noaa.gov/access/search/data-search/global-summary-of-the-month/",
      "read_by_step": "Get monthly summaries",
      "start_date": "1763-01-01"
    },
    {
      "data_types_count": 120,
      "description": "Local Climatological Data (LCD) v2 are summaries of climatological conditions from airport and other prominent weather stations managed by NWS, FAA, and DOD. The LCD has been provided for approximately 1000 U.S. stations since 2005.",
      "doi_url": "https://doi.org/10.25921/96dw-mb77",
      "end_date": "2026-10-23",
      "frequency": "daily",
      "id": "local-climatological-data-v2",
      "name": "Local Climatological Data (LCD), Version 2 (LCDv2)",
      "observation_types": [],
      "page_url": "https://www.ncei.noaa.gov/access/search/data-search/local-climatological-data-v2/",
      "read_by_step": "Get hourly observations",
      "start_date": "1750-02-01"
    }
  ],
  "query": "daily summaries",
  "total": 49
}
```
