# NOAA Weather Data Scraper & Normalizer (`wakey7dev/noaa-weather-normalizer`) Actor

Fetch live NOAA weather alerts and point forecasts with enriched, normalized data. Risk scoring, unit conversion, event categorization. Free API, no key needed.

- **URL**: https://apify.com/wakey7dev/noaa-weather-normalizer.md
- **Developed by:** [Chris Wakefield](https://apify.com/wakey7dev) (community)
- **Categories:** Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

![Chris The Dev](https://raw.githubusercontent.com/chriswakefield87/appstore-screenshot-translator/main/assets/actor-banner.png)

## NOAA Weather Data Scraper & Normalizer

Fetch, normalize, and enrich weather data from NOAA's National Weather Service API — completely free, no API key required.

### What It Does

This actor pulls live weather alerts and detailed point forecasts from the NWS public API and transforms raw data into clean, enriched, and analysis-ready output.

#### Key Features

- **Weather Alerts** — Active watches, warnings, and advisories for any US state
- **Point Forecasts** — 7-day detailed forecasts for any lat/lon coordinates  
- **Smart Normalization** — Maps 80+ raw NOAA event types into 18 standardized categories
- **Risk Scoring** — Composite severity × urgency × certainty score (1-64 scale) with CRITICAL/HIGH/MODERATE/LOW labels
- **Unit Conversion** — Fahrenheit→Celsius, mph→kph, mph→m/s built in
- **Clean Output** — Human-readable summary tables + structured JSON + machine-readable stats

### Input Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `searchType` | select | ✅ | `alerts` | `alerts`, `forecast`, or `alerts_and_forecast` |
| `stateCode` | select | — | All states | Filter alerts by US state (e.g. CA, TX, FL) |
| `latitude` | string | forecast only | — | Latitude for point forecast (e.g. `40.7128`) |
| `longitude` | string | forecast only | — | Longitude for point forecast (e.g. `-74.006`) |
| `maxResults` | integer | — | `50` | Maximum results (1–500) |
| `severityFilter` | select | — | All | Filter alerts by severity: Extreme, Severe, Moderate, Minor |

### Example Input

```json
{
  "searchType": "alerts_and_forecast",
  "stateCode": "CA",
  "latitude": "37.7749",
  "longitude": "-122.4194",
  "maxResults": 25,
  "severityFilter": "Severe"
}
````

### Example Output

#### Summary Table (KVS OUTPUT)

```
====================================================================================================
  NOAA WEATHER ALERTS — NORMALIZED SUMMARY
====================================================================================================
  Total alerts: 8
  Categories: Heat:3, Fire Weather:2, Flood:1, Wind:1, Marine:1
  Risk levels: HIGH:3, MODERATE:3, CRITICAL:2
                                                                                                    
  #  Event                          Cat            Sev        Urg         Risk Risk Label Area                      
───  ────────────────────────────── ────────────── ────────── ──────────  ──── ────────── ─────────────────────────
  0  Excessive Heat Warning         Heat           Severe     Expected     36 CRITICAL   San Francisco Bay Area    
  1  Heat Advisory                  Heat           Moderate   Expected     18 HIGH       Central California        
  2  Red Flag Warning               Fire Weather   Severe     Expected     36 CRITICAL   North Bay Mountains       
```

#### Structured JSON (Dataset)

```json
{
  "id": "urn:oid:2.49.0.1.840.0.abc123",
  "event": "Excessive Heat Warning",
  "eventCategory": "Heat",
  "headline": "Excessive Heat Warning issued for Bay Area",
  "severity": {"label": "Severe", "score": 3},
  "urgency": {"label": "Expected", "score": 3},
  "certainty": {"label": "Likely", "score": 3},
  "riskScore": 27,
  "riskLabel": "HIGH",
  "effective": "2026-07-15T12:00:00Z",
  "expires": "2026-07-18T00:00:00Z",
  "areaDescription": "San Francisco Bay Area"
}
```

#### Forecast (Dataset with unit conversions)

```json
{
  "name": "Monday",
  "temperature": 92,
  "temperatureC": 33.3,
  "windSpeed": "10 to 15 mph",
  "windSpeedKph": 24.1,
  "windSpeedMs": 6.7,
  "shortForecast": "Sunny and hot"
}
```

### Use Cases

- **Insurance & Risk** — Monitor severe weather events for claims forecasting
- **Agriculture** — Track freeze/frost warnings and heat advisories for crop planning
- **Logistics & Transportation** — Route around weather hazards
- **Emergency Management** — Aggregate alerts by severity and risk score
- **Weather Apps & Dashboards** — Power consumer-facing weather products
- **Research & Analysis** — Historical weather pattern studies

### Data Source

All data from the [NOAA National Weather Service API](https://www.weather.gov/documentation/services-web-api) — a free, public, no-key-required REST API. Data is updated in real-time.

### Pricing

Pay per result — $2.00 per 1,000 results. Each weather alert or forecast period counts as one result.

***

Built by [Chris The Dev](https://apify.com/wakey7dev) • July 2026

# Actor input Schema

## `searchType` (type: `string`):

Choose what type of weather data to fetch. Alerts returns active watches/warnings/advisories. Forecast returns 7-day point forecasts (requires lat/lon).

## `stateCode` (type: `string`):

Filter alerts by US state (e.g. CA, TX, FL). Leave blank for all states.

## `latitude` (type: `string`):

Latitude for point forecast (e.g. 40.7128 for NYC). Used with longitude for forecast mode.

## `longitude` (type: `string`):

Longitude for point forecast (e.g. -74.006 for NYC). Used with latitude for forecast mode.

## `maxResults` (type: `integer`):

Maximum number of alerts or forecast periods to return.

## `severityFilter` (type: `string`):

Filter alerts by severity level.

## Actor input object example

```json
{
  "searchType": "alerts",
  "maxResults": 50
}
```

# Actor output Schema

## `results` (type: `string`):

All normalized weather data items as JSON array.

## `summary` (type: `string`):

Human-readable summary table of results.

## `stats` (type: `string`):

Machine-readable run statistics.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("wakey7dev/noaa-weather-normalizer").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("wakey7dev/noaa-weather-normalizer").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call wakey7dev/noaa-weather-normalizer --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=wakey7dev/noaa-weather-normalizer",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "NOAA Weather Data Scraper & Normalizer",
        "description": "Fetch live NOAA weather alerts and point forecasts with enriched, normalized data. Risk scoring, unit conversion, event categorization. Free API, no key needed.",
        "version": "1.0",
        "x-build-id": "CatcFe7jgYO95FV11"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/wakey7dev~noaa-weather-normalizer/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-wakey7dev-noaa-weather-normalizer",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/wakey7dev~noaa-weather-normalizer/runs": {
            "post": {
                "operationId": "runs-sync-wakey7dev-noaa-weather-normalizer",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/wakey7dev~noaa-weather-normalizer/run-sync": {
            "post": {
                "operationId": "run-sync-wakey7dev-noaa-weather-normalizer",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "searchType"
                ],
                "properties": {
                    "searchType": {
                        "title": "Search Type",
                        "enum": [
                            "alerts",
                            "forecast",
                            "alerts_and_forecast"
                        ],
                        "type": "string",
                        "description": "Choose what type of weather data to fetch. Alerts returns active watches/warnings/advisories. Forecast returns 7-day point forecasts (requires lat/lon).",
                        "default": "alerts"
                    },
                    "stateCode": {
                        "title": "State Code (alerts)",
                        "enum": [
                            "",
                            "AL",
                            "AK",
                            "AZ",
                            "AR",
                            "CA",
                            "CO",
                            "CT",
                            "DE",
                            "FL",
                            "GA",
                            "HI",
                            "ID",
                            "IL",
                            "IN",
                            "IA",
                            "KS",
                            "KY",
                            "LA",
                            "ME",
                            "MD",
                            "MA",
                            "MI",
                            "MN",
                            "MS",
                            "MO",
                            "MT",
                            "NE",
                            "NV",
                            "NH",
                            "NJ",
                            "NM",
                            "NY",
                            "NC",
                            "ND",
                            "OH",
                            "OK",
                            "OR",
                            "PA",
                            "RI",
                            "SC",
                            "SD",
                            "TN",
                            "TX",
                            "UT",
                            "VT",
                            "VA",
                            "WA",
                            "WV",
                            "WI",
                            "WY"
                        ],
                        "type": "string",
                        "description": "Filter alerts by US state (e.g. CA, TX, FL). Leave blank for all states."
                    },
                    "latitude": {
                        "title": "Latitude (forecast)",
                        "type": "string",
                        "description": "Latitude for point forecast (e.g. 40.7128 for NYC). Used with longitude for forecast mode."
                    },
                    "longitude": {
                        "title": "Longitude (forecast)",
                        "type": "string",
                        "description": "Longitude for point forecast (e.g. -74.006 for NYC). Used with latitude for forecast mode."
                    },
                    "maxResults": {
                        "title": "Max Results",
                        "minimum": 1,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Maximum number of alerts or forecast periods to return.",
                        "default": 50
                    },
                    "severityFilter": {
                        "title": "Severity Filter (alerts)",
                        "enum": [
                            "",
                            "Extreme",
                            "Severe",
                            "Moderate",
                            "Minor"
                        ],
                        "type": "string",
                        "description": "Filter alerts by severity level."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
