{ "openapi": "3.0.1", "info": { "title": "FEMA Disaster Declarations & ZIP Damage Data Scraper", "description": "Scrape federal disaster declarations and ZIP-code-level FEMA housing inspection damage and Individual and Households Program (IHP) assistance totals from OpenFEMA v2.", "version": "0.1", "x-build-id": "d1ssXOt5xjLQylQig" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/groundplanes~fema-disaster-zip-damage/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-groundplanes-fema-disaster-zip-damage", "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/groundplanes~fema-disaster-zip-damage/runs": { "post": { "operationId": "runs-sync-groundplanes-fema-disaster-zip-damage", "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/groundplanes~fema-disaster-zip-damage/run-sync": { "post": { "operationId": "run-sync-groundplanes-fema-disaster-zip-damage", "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": { "declaredSince": { "title": "Declared Since Date (YYYY-MM-DD)", "type": "string", "description": "Earliest disaster declarationDate in YYYY-MM-DD format. Leave blank to default to 365 days ago. In ZIP_DAMAGE mode only, if no ZIP damage rows are collected in that window, the lookback automatically widens (800 days, then 1095 days) and the run status message discloses the expansion.", "default": "" }, "incidentTypes": { "title": "Incident Types", "type": "array", "description": "Optional OpenFEMA incidentType filter values (e.g. [\"Hurricane\", \"Severe Storm\", \"Flood\", \"Fire\", \"Tornado\"]). Leave empty for all incident types.", "items": { "type": "string" }, "default": [] }, "maxItems": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum number of records to return, sorted newest first by declarationDate and then totalDamage descending.", "default": 200 }, "minTotalDamageUsd": { "title": "Minimum Total Inspected Damage (USD, ZIP_DAMAGE Mode)", "minimum": 0, "type": "number", "description": "Minimum ZIP-level totalDamage in USD (ZIP_DAMAGE mode only). Set to 0 to return all matching ZIP records.", "default": 0 }, "mode": { "title": "Dataset Mode", "enum": [ "ZIP_DAMAGE", "DECLARATIONS" ], "type": "string", "description": "Select ZIP_DAMAGE (ZIP-level aggregated homeowner inspection damage and approved IHP assistance joined with disaster declaration metadata) or DECLARATIONS (county/area-level federal disaster declarations).", "default": "ZIP_DAMAGE" }, "states": { "title": "States (2-letter codes)", "type": "array", "description": "Two-letter US state or territory postal codes (e.g. [\"FL\"], [\"WV\", \"OH\", \"WI\"]). Leave empty for all states.", "items": { "type": "string" }, "default": [ "FL" ] } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }