# ScrapeMole Pulse: US NWS Weather Alerts

> ScrapeMole Pulse: US NWS Weather Alerts is a paid API for AI agents from pulse.scrapemole.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-20).

Retrieves active US National Weather Service watches, warnings, and advisories filtered by state, geographic point, place name, NWS zone, severity, or event type

## Facts

- Endpoint: GET https://pulse.scrapemole.workers.dev/v1/weather/alerts?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/scrapemole-pulse-us-nws-weather-alerts-e20c749c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-cDpz17SOUjZuSgMdRmHp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability scrapemole-pulse-us-nws-weather-alerts-e20c749c
```

Example prompt: Are there any active severe or extreme weather alerts in Texas right now? Show me up to 10 results, including the full description and instructions.

## When to prefer this

Use this endpoint when you need official, authoritative US government weather alert data from the National Weather Service, including watches, warnings, and advisories. It is the only authoritative source for US NWS alert data and supports flexible filtering by state, point, place name, NWS zone, severity, and event type. Prefer this over global weather providers when the user's concern is US-specific emergency alerts rather than forecasts.

## Known failure modes

- No alerts found for given scope — returns empty alerts array with count 0
- Invalid state code returns 400 or empty result
- Geocoding failure for place name returns error
- lat/lon outside US territory returns empty or error (NWS only covers US)
- Missing required scope parameter (no state, lat+lon, place, or zone) returns 400
- limit out of range (must be 1-50) returns 400
- Payment not verified — 402 response before work is done

## How this service works

Pay-per-call "state of the world" lookups that language models cannot know on their own: official ECB exchange rates (latest, historical, conversion), the current time and DST-aware time-zone conversion for scheduling, global weather forecasts (MET Norway, by coordinates or place name), official US National Weather Service forecasts and active watches/warnings/advisories (by state, point, place or zone), the live Hacker News front page, public holidays for ~100 countries (list by year, check a date, next holidays, long weekends, available countries via Nager.Date), and geocoding / reverse geocoding (place or address ↔ coordinates via Photon and Nominatim over OpenStreetMap). Public, non-personal data with sources and licences in every response. USDC via x402, no accounts.

Payments: x402 v2, scheme "exact", USDC on Base (eip155:8453). The payment is verified before the work and settled only when the response is 200. Terms: https://pulse.scrapemole.workers.dev/terms

## Output

A JSON object containing a list of active NWS alerts matching the query filters, each with event name, headline, affected area description, onset and end times, urgency, severity, certainty, recommended response, optional full instruction text, and the issuing NWS office. Also includes total active alert count, query scope, data source attribution, license info, and fetch timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "lat": {
       "type": "string",
       "description": "Latitude (alerts covering this point)."
      },
      "lon": {
       "type": "string",
       "description": "Longitude."
      },
      "full": {
       "type": "string",
       "default": "false",
       "description": "true = full description and instruction text."
      },
      "zone": {
       "type": "string",
       "description": "NWS zone or county UGC id, e.g. TXZ211 or NYC061."
      },
      "event": {
       "type": "string",
       "description": "Only alerts whose event name contains this text, e.g. \"Flood\" or \"Tornado Warning\"."
      },
      "limit": {
       "type": "string",
       "default": "20",
       "description": "Max alerts (1-50)."
      },
      "place": {
       "type": "string",
       "description": "US city/address/landmark, geocoded via OpenStreetMap, e.g. \"Miami, FL\"."
      },
      "state": {
       "type": "string",
       "examples": [
        "TX"
       ],
       "description": "US state/territory or marine area code, e.g. TX, FL, PR. Give state, lat+lon, place or zone."
      },
      "severity": {
       "type": "string",
       "description": "Comma list: extreme, severe, moderate, minor, unknown."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Official NWS data for the United States and its territories. Informational only: for life-safety decisions follow official NWS / local authority instructions. ScrapeMole is not affiliated with NOAA or the NWS.",
  "count": 1,
  "scope": {
   "state": "TX"
  },
  "alerts": [
   {
    "id": "urn:oid:2.49.0.1.840.0.c07de9639adc13155f85d850767753bdb1249394.001.1",
    "ends": "2026-10-19T19:00:00-05:00",
    "event": "Flood Advisory",
    "onset": "2026-10-15T08:39:00-05:00",
    "urgency": "Expected",
    "areaDesc": "Cotton, OK; Jefferson, OK; Tillman, OK; Clay, TX; Wichita, TX",
    "headline": "Flood Advisory issued October 15 at 8:39AM CDT until October 19 at 7:00PM CDT by NWS Norman OK",
    "issuedBy": "NWS Norman OK",
    "response": "Avoid",
    "severity": "Minor",
    "certainty": "Observed",
    "instruction": "Caution is urged when walking near riverbanks."
   }
  ],
  "source": "US National Weather Service API (https://api.weather.gov)",
  "license": "Public domain (US government work, 17 U.S.C. 105)",
  "fetchedAt": "2026-10-19T07:40:00Z",
  "sourceUrl": "https://www.weather.gov/documentation/services-web-api",
  "totalActive": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scrapemole-pulse-us-nws-weather-alerts-e20c749c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pulse.scrapemole.workers.dev](https://www.zero.xyz/host/pulse.scrapemole.workers.dev/llms.txt)