# FEMA Disaster Declarations Scraper (`scrapers_lat/fema-disaster-declarations-scraper`) Actor

Scrape US FEMA disaster declarations from the official OpenFEMA data: filter by state, incident type, declaration type, disaster number, date and fiscal year. Add per-disaster federal funding totals and AI impact summaries. JSON, CSV, Excel.

- **URL**: https://apify.com/scrapers\_lat/fema-disaster-declarations-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Developer tools, Automation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $8.32 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

[![FEMA Disaster Declarations Scraper](https://scrapers.lat/banners/fema-disaster-declarations-scraper.png)](https://apify.com/scrapers_lat/fema-disaster-declarations-scraper)

## FEMA Disaster Declarations Scraper

Pull the full history of US **FEMA disaster declarations** from the official OpenFEMA record: major disasters, emergencies and fire management declarations, filtered by state, incident type, declaration type, disaster number, date and fiscal year. Optionally enrich every disaster with **federal recovery funding totals** and a plain-English **AI impact summary**.

Here is one real result (disaster 4673, Hurricane Ian, with the funding add-on enabled), showing the fields the actor returns:

```json
{
  "femaDeclarationString": "DR-4673-FL",
  "disasterNumber": 4673,
  "declarationType": "DR",
  "declarationTypeLabel": "Major Disaster",
  "state": "FL",
  "region": 4,
  "incidentType": "Hurricane",
  "declarationTitle": "HURRICANE IAN",
  "declarationDate": "2022-09-29T00:00:00.000Z",
  "fyDeclared": 2022,
  "incidentBeginDate": "2022-09-23T00:00:00.000Z",
  "incidentEndDate": "2022-11-04T00:00:00.000Z",
  "designatedArea": null,
  "designatedAreas": ["Lee (County)", "Charlotte (County)", "Collier (County)", "Sarasota (County)"],
  "fipsStateCode": "12",
  "fipsCountyCode": "071",
  "programsDeclared": ["IH", "IA", "PA", "HM"],
  "individualAssistance": true,
  "individualsAndHouseholds": true,
  "publicAssistance": true,
  "hazardMitigation": true,
  "totalNumberIaApproved": 387146,
  "totalAmountIhpApproved": 1150179701.7,
  "totalAmountHaApproved": 782193893.08,
  "totalAmountOnaApproved": 367985808.62,
  "totalObligatedAmountPa": 2910499266.12,
  "totalObligatedAmountHmgp": 243771438.48,
  "totalFederalObligated": 4304450406.3,
  "aiImpactSummary": "Hurricane Ian struck Florida from September 23 to November 4, 2022, causing widespread devastation. The declaration DR-4673-FL activated Individual Assistance, Public Assistance and Hazard Mitigation programs, with over $4.3 billion in federal funds obligated for housing, infrastructure and mitigation.",
  "observedAt": "2026-08-16T17:36:37.964Z",
  "error": null
}
```

### What you can do with it

- Pull every declaration for a state, incident type or fiscal year in seconds.
- Collapse a multi-county disaster into one row with all counties in a `designatedAreas` array, or keep one row per declared area.
- Add real federal recovery funding totals (IHP, Housing Assistance, Other Needs, Public Assistance, HMGP) that the declarations list itself does not carry.
- Generate a ready-to-read AI impact and recovery summary per disaster.

### Input

| Field | Type | Description |
|-------|------|-------------|
| `state` | string | Two-letter state/territory code, e.g. `FL`, `TX`, `PR`. |
| `incidentType` | string | Exact incident type, e.g. `Hurricane`, `Flood`, `Fire`, `Severe Storm`, `Tornado`. |
| `declarationType` | select | `DR` (Major Disaster), `EM` (Emergency), `FM` (Fire Management). |
| `disasterNumber` | integer | A single FEMA disaster number, e.g. `4673`. |
| `declaredFrom` / `declaredTo` | string | Declaration date range (YYYY-MM-DD). |
| `fyDeclared` | integer | Federal fiscal year, e.g. `2024`. |
| `individualAssistanceOnly` | boolean | Only declarations where IA was declared. |
| `publicAssistanceOnly` | boolean | Only declarations where PA was declared. |
| `customFilter` | string | Advanced raw OpenFEMA OData filter, appended with AND. |
| `dedupeByDisaster` | boolean | Collapse to one row per disaster number, counties in `designatedAreas`. |
| `orderBy` | select | Sort order (newest declaration first by default). |
| `includeFunding` | boolean | Paid add-on: federal funding totals per disaster. |
| `withAiSummary` | boolean | Paid add-on: AI impact and recovery summary per disaster. |
| `maxResults` | integer | Max records to collect. Free plans are capped at 10 per run. |

### Output

| Field | Description |
|-------|-------------|
| `femaDeclarationString` | Declaration string, e.g. `DR-4673-FL`. |
| `disasterNumber` | FEMA disaster number. |
| `declarationType` / `declarationTypeLabel` | Code and label (Major Disaster / Emergency / Fire Management). |
| `state`, `region` | State/territory code and FEMA region. |
| `incidentType`, `declarationTitle` | Incident type and disaster title. |
| `declarationDate`, `fyDeclared` | Declaration date and fiscal year. |
| `incidentBeginDate`, `incidentEndDate` | Incident period. |
| `designatedArea` / `designatedAreas` | County/area, or the array of all areas when collapsed. |
| `fipsStateCode`, `fipsCountyCode`, `placeCode` | Geographic codes. |
| `programsDeclared` | Programs declared: IH, IA, PA, HM. |
| `individualAssistance`, `publicAssistance`, `individualsAndHouseholds`, `hazardMitigation` | Program booleans. |
| `totalNumberIaApproved`, `totalAmountIhpApproved`, `totalAmountHaApproved`, `totalAmountOnaApproved`, `totalObligatedAmountPa`, `totalObligatedAmountHmgp`, `totalFederalObligated` | Funding add-on fields. |
| `aiImpactSummary` | AI add-on summary. |
| `observedAt`, `error` | Timestamp and per-record error (null on success). |

### Use cases

- **Insurance and risk modeling**: build catastrophe and loss models from a clean, complete history of declared disasters, incident types and affected counties.
- **Disaster recovery and restoration lead-gen**: target counties with active Individual and Public Assistance declarations for construction, roofing, water damage and remediation services.
- **Grants and public funding research**: track IHP, Public Assistance and Hazard Mitigation dollars obligated per disaster to size markets and find funding opportunities.
- **Emergency management and government**: monitor new declarations by state, region and program in near real time.
- **Journalism and academic research**: analyze decades of federal disaster response, funding and program activation trends.
- **Climate and resilience analytics**: quantify the frequency, geography and cost of floods, hurricanes, wildfires and severe storms.

### Billing

This actor is priced per event (pay per result). You are never charged when a request fails; an error row is returned free of charge.

| Event | Price (USD) | When it is charged |
|-------|-------------|--------------------|
| `result` | $0.008 | Per disaster declaration record returned. |
| `funding` | $0.008 | Per disaster when the funding add-on (`includeFunding`) successfully fetches recovery-funding totals. Fetched and charged once per disaster, even across many declared areas. |
| `ai_summary` | $0.012 | Per disaster when the AI add-on (`withAiSummary`) produces a usable impact summary. Charged once per disaster. |

Both add-ons are opt-in, default off, and disabled for free Apify plans. Free plans are capped at 10 results per run.

### Data source

Data comes from the public OpenFEMA record of US federal disaster declarations and funding summaries. Fields mirror the official record.

# Actor input Schema

## `state` (type: `string`):

Two-letter US state or territory code to filter declarations, for example FL, TX, CA, PR. Leave empty for all states.

## `incidentType` (type: `string`):

Exact FEMA incident type, for example Hurricane, Flood, Fire, Severe Storm, Tornado, Snowstorm, Biological, Earthquake. Case-sensitive exact match.

## `declarationType` (type: `string`):

Filter by declaration type: DR (Major Disaster), EM (Emergency) or FM (Fire Management Assistance). Leave empty for all.

## `disasterNumber` (type: `integer`):

A single FEMA disaster number to return, for example 4673. Returns every declared area for that disaster.

## `declaredFrom` (type: `string`):

Only include declarations with a declarationDate on or after this date (YYYY-MM-DD).

## `declaredTo` (type: `string`):

Only include declarations with a declarationDate on or before this date (YYYY-MM-DD).

## `fyDeclared` (type: `integer`):

Only include declarations from this federal fiscal year, for example 2024.

## `individualAssistanceOnly` (type: `boolean`):

Only include declarations where the Individual Assistance (IA) program was declared.

## `publicAssistanceOnly` (type: `boolean`):

Only include declarations where the Public Assistance (PA) program was declared.

## `customFilter` (type: `string`):

Advanced. Raw OpenFEMA OData filter appended with AND, for example: designatedArea eq 'Lee (County)'. Uses eq/and/or/ge/le.

## `dedupeByDisaster` (type: `boolean`):

FEMA returns one row per declared area (a disaster spans many counties). Enable to collapse to one row per disaster number, with all counties in a designatedAreas array.

## `orderBy` (type: `string`):

OpenFEMA $orderby clause. Default is newest declarations first.

## `includeFunding` (type: `boolean`):

Opt-in paid add-on ($0.008 per disaster). For each disaster, fetch the OpenFEMA funding summary and add total IHP/HA/ONA amounts approved, total PA and HMGP dollars obligated, IA applicants approved and a derived total federal obligated sum. Fetched and charged once per disaster. Disabled for free Apify users.

## `withAiSummary` (type: `boolean`):

Opt-in AI paid add-on ($0.012 per disaster). Uses AI (OpenRouter gpt-4o-mini) to write a plain-English impact and recovery summary: what happened, the scope, which assistance programs were activated and the scale of federal funding. Charged only when usable AI output is produced. Disabled for free Apify users.

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

Maximum number of records to collect (declarations, or disasters when collapsing). Free Apify plans are capped at 10 per run.

## `proxyConfiguration` (type: `object`):

Optional. The OpenFEMA API is open and needs no proxy, but you can route requests through an Apify proxy if you prefer.

## Actor input object example

```json
{
  "individualAssistanceOnly": false,
  "publicAssistanceOnly": false,
  "dedupeByDisaster": false,
  "orderBy": "declarationDate desc",
  "includeFunding": false,
  "withAiSummary": false,
  "maxResults": 100,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

No description

# 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 = {
    "maxResults": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/fema-disaster-declarations-scraper").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 = { "maxResults": 100 }

# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/fema-disaster-declarations-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "maxResults": 100
}' |
apify call scrapers_lat/fema-disaster-declarations-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapers_lat/fema-disaster-declarations-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/UtpcZDdHcl65cnEvh/builds/VnGYEgRjNMil3ynD1/openapi.json