{ "openapi": "3.0.1", "info": { "title": "Wildfire Asset Exposure Screener — Live Perimeter Distance", "description": "Screen assets - offices, homes, facilities, portfolios - against live NIFC wildfire perimeters plus USFS Wildfire Hazard Potential class and historical burn history. Per point: distance to nearest fire, hazard class, past burn year. MCP-ready wildfire risk API.", "version": "1.0", "x-build-id": "RZrwwAfnyE4ZvWQIa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/malonestar~wildfire-asset-exposure-screener/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-malonestar-wildfire-asset-exposure-screener", "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/malonestar~wildfire-asset-exposure-screener/runs": { "post": { "operationId": "runs-sync-malonestar-wildfire-asset-exposure-screener", "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/malonestar~wildfire-asset-exposure-screener/run-sync": { "post": { "operationId": "run-sync-malonestar-wildfire-asset-exposure-screener", "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": { "assets": { "title": "Assets to screen", "type": "array", "description": "List of asset locations to screen against live wildfire perimeters. Each item is an object: {\"lat\": , \"lon\": , \"label\": \"\"}. One dataset row (one billable check) is produced per asset. Invalid points produce an ERROR row and the run continues." }, "radiusMiles": { "title": "Reporting radius (miles)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum distance at which the nearest fire is reported for an asset. Fires farther than this are ignored (row comes back CLEAR with null fire fields). Exposure bands stay fixed at IN_PERIMETER / WITHIN_5_MI / WITHIN_25_MI regardless of this radius. Default 25.", "default": 25 }, "states": { "title": "State filter (optional)", "type": "array", "description": "Optional list of 2-letter US state codes (e.g. CA, OR, MT). When set, only fires whose point of origin is in these states are fetched — faster runs for single-state portfolios. Leave empty to screen against ALL active US fires (recommended for assets near state lines).", "items": { "type": "string" } }, "includeIncidentPoints": { "title": "Include incident points", "type": "boolean", "description": "Also screen against the WFIGS incident-locations point layer (small or brand-new wildfires that have no mapped perimeter yet). Distances to these are point distances, not perimeter-edge distances. Incidents already represented by a perimeter are deduplicated by IRWIN id. Default true.", "default": true }, "includeWhp": { "title": "Include USFS Wildfire Hazard Potential class", "type": "boolean", "description": "Look up the USFS Wildfire Hazard Potential (WHP) class at each asset point — a landscape-scale (270m) wildland-fuels hazard rating: Very Low / Low / Moderate / High / Very High, or Non-burnable / Water for developed and open-water land cover. This is a background fuels metric, not a structure-level risk score. One extra lookup per asset. Default true.", "default": true }, "includeHistoricalBurn": { "title": "Include historical burn flag", "type": "boolean", "description": "Check whether each asset point falls inside any historical fire perimeter from the NIFC InterAgency Fire Perimeter History archive, and if so the most recent burn year and fire name. One extra lookup per asset. Default true.", "default": true }, "maxResults": { "title": "Max asset checks", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Safety cap on the number of assets screened (one dataset row per asset). Assets beyond this cap are skipped with a warning.", "default": 1000 } } }, "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 } } } } } } } } } }