# NOAA Storm Events Scraper - Damage, Hail & Tornado API (`pink_comic/noaa-storm-events-damage-hail-tornado`) Actor Search official NOAA/NCEI Storm Events history for insurance, catastrophe risk, restoration, roofing, and research. Filter hail, tornadoes, wind, floods, wildfire, damage, injuries, deaths, dates, states, counties, magnitude, locations, and narratives. - **URL**: https://apify.com/pink\_comic/noaa-storm-events-damage-hail-tornado.md - **Developed by:** [Ava Torres](https://apify.com/pink_comic) (community) - **Categories:** News - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 storm event records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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 ## NOAA Storm Events Scraper — Damage, Hail & Tornado API Search the official NOAA/NCEI Storm Events Database for source-linked historical hail, tornado, thunderstorm wind, flood, hurricane, wildfire, winter-weather, and other significant-event records. Filter damage, injuries, deaths, magnitude, dates, states, counties/zones, locations, report sources, and narratives for insurance research, catastrophe analytics, roofing/restoration market analysis, emergency planning, and climate research. This actor downloads the latest official compressed detail file for each requested year directly from NOAA. No API key, login, browser, or proxy is required. ### Fast start The default input returns 25 recent Texas hail reports from the currently available 2026 source file: ```json { "startDate": "2026-01-01", "endDate": "2026-12-31", "states": ["TX"], "eventTypes": ["Hail"], "sortBy": "latest", "maxResults": 25 } ```` Find severe hail reports for roofing, restoration, or property-risk research: ```json { "startDate": "2025-01-01", "endDate": "2026-12-31", "states": ["TX", "OK", "KS"], "eventTypes": ["Hail"], "minMagnitude": 1.75, "sortBy": "magnitude", "maxResults": 250 } ``` Find high-damage tornado and wind records: ```json { "startDate": "2024-01-01", "endDate": "2026-12-31", "states": ["FL", "GA", "NC", "SC"], "eventTypes": ["Tornado", "Thunderstorm Wind", "Hurricane (Typhoon)"], "minTotalDamage": 100000, "sortBy": "totalDamage", "maxResults": 500 } ``` Retrieve an exact known event while keeping its year in range: ```json { "eventId": "1316433", "startDate": "2026-01-01", "endDate": "2026-12-31", "states": [], "eventTypes": [], "maxResults": 10 } ``` ### Filters - exact numeric NOAA event ID - inclusive start/end dates, with up to 10 calendar years per run - state names or two-letter abbreviations - exact county, parish, forecast-zone, or marine-zone names - one or more exact NOAA event types - case-insensitive keyword across event/episode narratives, locations, source, zone, and event type - minimum property, crop, or combined damage estimate - minimum direct + indirect injuries or deaths - minimum source magnitude - latest, oldest, damage, deaths, injuries, or magnitude sorting - total `maxResults` cap from 1–1,000 All selected filters are combined. Multiple states, counties, and event types use **OR** within their own field. ### Output Each match has 60+ stable evidence keys, including: - episode ID, event ID, event type, state, FIPS codes, year, and month - county/parish, forecast-zone, or marine-zone identity - NWS Forecast Office, local timezone, and begin/end timestamps - direct, indirect, and total injuries and deaths - original property/crop damage strings plus normalized estimated dollar amounts - report source, magnitude, magnitude type, and event-specific interpretation - flood cause and category - tornado scale, track length/width, and continuation-zone fields - begin/end range, azimuth, named location, latitude, and longitude - complete episode and event narratives - exact official NOAA source-file URL, file date, and retrieval timestamp - source-lag, damage-estimate, accuracy, and historical-coverage caveats No-match runs return an explicit `NO_MATCHING_STORM_EVENTS` item instead of an ambiguous empty dataset. Temporary source failures return `SOURCE_UNAVAILABLE` without claiming that no event occurred. ### Use cases - hail and severe-weather research for roofing and restoration markets - property-insurance underwriting support and catastrophe-model QA - historical storm, tornado, flood, wildfire, and wind analysis - event-based claims research and post-catastrophe evidence gathering - emergency-management and infrastructure-risk studies - source-backed weather evidence for data pipelines and AI agents ### Important scope and interpretation This is **historical post-event data, not a live warning or forecast feed**. NCEI says records normally become available about 75–90 days after the end of a data month. NOAA describes Storm Data as an official publication, but some information can come from media, law enforcement, private companies, individuals, and other outside sources. NWS uses the best available information but does not guarantee every value. Treat each record as source evidence, not a complete or independently verified loss determination. Property and crop damage figures are broad NWS best estimates based on information available at publication time. They are nominal dollars, are not adjusted for inflation, may be blank or incomplete, and are **not insurance claim totals**. Historical coverage changes by era: - 1950–1954: tornadoes only - 1955–1995: tornado, thunderstorm wind, and hail - 1996 onward: all event types defined by the applicable NWS directive Coordinates and location precision also vary by era and reporting method. Tornadoes can have multiple county/state segments, so an event row is not always one unique whole tornado. ### Official sources - [NOAA/NCEI Storm Events Database](https://www.ncei.noaa.gov/stormevents/) - [Official bulk CSV directory](https://www.ncei.noaa.gov/pub/data/swdi/stormevents/csvfiles/) - [Storm Events Database details and historical coverage](https://www.ncei.noaa.gov/stormevents/details.jsp) - [Storm Data FAQ, lag, accuracy, location, and damage guidance](https://www.ncei.noaa.gov/stormevents/faq.jsp) - [Bulk CSV format documentation](https://www.ncei.noaa.gov/pub/data/swdi/stormevents/csvfiles/Storm-Data-Bulk-csv-Format.pdf) # Actor input Schema ## `eventId` (type: `string`): Exact numeric Storm Events event ID. Keep the date range around the event year. ## `startDate` (type: `string`): Inclusive event start date in YYYY-MM-DD format. A run may span at most 10 calendar years. ## `endDate` (type: `string`): Inclusive event end date in YYYY-MM-DD format. ## `states` (type: `array`): State names or two-letter abbreviations. Empty means all states and NOAA marine areas. ## `counties` (type: `array`): Exact NOAA county, parish, marine-zone, or forecast-zone names, such as HOUSTON or MONTGOMERY. ## `eventTypes` (type: `array`): Exact NOAA event types, such as Hail, Tornado, Thunderstorm Wind, Flash Flood, Wildfire, or Hurricane (Typhoon). Empty means all types. ## `keyword` (type: `string`): Case-insensitive substring matched across episode/event narratives, begin/end locations, report source, county/zone, and event type. ## `minPropertyDamage` (type: `number`): Minimum broad nominal-dollar property-damage estimate reported by NWS. These are not insurance claim totals. ## `minCropDamage` (type: `number`): Minimum broad nominal-dollar crop-damage estimate reported by NWS. ## `minTotalDamage` (type: `number`): Minimum property plus crop damage estimate. ## `minInjuries` (type: `integer`): Minimum direct plus indirect injuries. ## `minDeaths` (type: `integer`): Minimum direct plus indirect deaths. ## `minMagnitude` (type: `number`): Minimum source magnitude. Meaning depends on event type: hail uses inches; wind generally uses knots. ## `sortBy` (type: `string`): Order matched events after every filter is applied. ## `maxResults` (type: `integer`): Total response cap after all files, filters, and sorting. ## Actor input object example ```json { "startDate": "2026-01-01", "endDate": "2026-12-31", "states": [ "TX" ], "counties": [], "eventTypes": [ "Hail" ], "minPropertyDamage": 0, "minCropDamage": 0, "minTotalDamage": 0, "minInjuries": 0, "minDeaths": 0, "minMagnitude": 0, "sortBy": "latest", "maxResults": 25 } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startDate": "2026-01-01", "endDate": "2026-12-31", "states": [ "TX" ], "eventTypes": [ "Hail" ], "maxResults": 25 }; // Run the Actor and wait for it to finish const run = await client.actor("pink_comic/noaa-storm-events-damage-hail-tornado").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startDate": "2026-01-01", "endDate": "2026-12-31", "states": ["TX"], "eventTypes": ["Hail"], "maxResults": 25, } # Run the Actor and wait for it to finish run = client.actor("pink_comic/noaa-storm-events-damage-hail-tornado").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 '{ "startDate": "2026-01-01", "endDate": "2026-12-31", "states": [ "TX" ], "eventTypes": [ "Hail" ], "maxResults": 25 }' | apify call pink_comic/noaa-storm-events-damage-hail-tornado --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=pink_comic/noaa-storm-events-damage-hail-tornado", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "NOAA Storm Events Scraper - Damage, Hail & Tornado API", "description": "Search official NOAA/NCEI Storm Events history for insurance, catastrophe risk, restoration, roofing, and research. Filter hail, tornadoes, wind, floods, wildfire, damage, injuries, deaths, dates, states, counties, magnitude, locations, and narratives.", "version": "0.1", "x-build-id": "RRY4rhsOwOZIRwcVk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pink_comic~noaa-storm-events-damage-hail-tornado/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pink_comic-noaa-storm-events-damage-hail-tornado", "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/pink_comic~noaa-storm-events-damage-hail-tornado/runs": { "post": { "operationId": "runs-sync-pink_comic-noaa-storm-events-damage-hail-tornado", "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/pink_comic~noaa-storm-events-damage-hail-tornado/run-sync": { "post": { "operationId": "run-sync-pink_comic-noaa-storm-events-damage-hail-tornado", "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", "properties": { "eventId": { "title": "Exact NOAA Event ID", "pattern": "^[0-9]*$", "type": "string", "description": "Exact numeric Storm Events event ID. Keep the date range around the event year." }, "startDate": { "title": "Start Date", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$", "type": "string", "description": "Inclusive event start date in YYYY-MM-DD format. A run may span at most 10 calendar years.", "default": "2026-01-01" }, "endDate": { "title": "End Date", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$", "type": "string", "description": "Inclusive event end date in YYYY-MM-DD format.", "default": "2026-12-31" }, "states": { "title": "States or Territories", "type": "array", "description": "State names or two-letter abbreviations. Empty means all states and NOAA marine areas.", "items": { "type": "string" }, "default": [ "TX" ] }, "counties": { "title": "County or Forecast Zone Names", "type": "array", "description": "Exact NOAA county, parish, marine-zone, or forecast-zone names, such as HOUSTON or MONTGOMERY.", "items": { "type": "string" }, "default": [] }, "eventTypes": { "title": "Event Types", "type": "array", "description": "Exact NOAA event types, such as Hail, Tornado, Thunderstorm Wind, Flash Flood, Wildfire, or Hurricane (Typhoon). Empty means all types.", "items": { "type": "string" }, "default": [ "Hail" ] }, "keyword": { "title": "Narrative, Location, Source, or Type Keyword", "type": "string", "description": "Case-insensitive substring matched across episode/event narratives, begin/end locations, report source, county/zone, and event type." }, "minPropertyDamage": { "title": "Minimum Property Damage Estimate (USD)", "minimum": 0, "type": "number", "description": "Minimum broad nominal-dollar property-damage estimate reported by NWS. These are not insurance claim totals.", "default": 0 }, "minCropDamage": { "title": "Minimum Crop Damage Estimate (USD)", "minimum": 0, "type": "number", "description": "Minimum broad nominal-dollar crop-damage estimate reported by NWS.", "default": 0 }, "minTotalDamage": { "title": "Minimum Combined Damage Estimate (USD)", "minimum": 0, "type": "number", "description": "Minimum property plus crop damage estimate.", "default": 0 }, "minInjuries": { "title": "Minimum Injuries", "minimum": 0, "type": "integer", "description": "Minimum direct plus indirect injuries.", "default": 0 }, "minDeaths": { "title": "Minimum Deaths", "minimum": 0, "type": "integer", "description": "Minimum direct plus indirect deaths.", "default": 0 }, "minMagnitude": { "title": "Minimum Magnitude", "minimum": 0, "type": "number", "description": "Minimum source magnitude. Meaning depends on event type: hail uses inches; wind generally uses knots.", "default": 0 }, "sortBy": { "title": "Sort Results", "enum": [ "latest", "oldest", "propertyDamage", "cropDamage", "totalDamage", "deaths", "injuries", "magnitude" ], "type": "string", "description": "Order matched events after every filter is applied.", "default": "latest" }, "maxResults": { "title": "Maximum Results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Total response cap after all files, filters, and sorting.", "default": 25 } } }, "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 } } } } } } } } } } ```