{ "openapi": "3.0.1", "info": { "title": "Hail & Wind Damage Leads for Roofers — Fresh NWS Storm Reports", "description": "Hail, damaging-wind and tornado reports from the National Weather Service, minutes to hours after the storm, with hail size, nearest ZIP, the warning polygon and a priority score. Filter by state or service area; you never pay twice for the same report.", "version": "0.1", "x-build-id": "quvSBmYykbFPNOnPW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/future_style_tooling~hail-wind-roof-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-future_style_tooling-hail-wind-roof-leads", "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/future_style_tooling~hail-wind-roof-leads/runs": { "post": { "operationId": "runs-sync-future_style_tooling-hail-wind-roof-leads", "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/future_style_tooling~hail-wind-roof-leads/run-sync": { "post": { "operationId": "run-sync-future_style_tooling-hail-wind-roof-leads", "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": { "states": { "title": "States", "type": "array", "description": "Only return reports from these states. Leave empty for the whole US.", "items": { "type": "string", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY" ], "enumTitles": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "District of Columbia", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming" ] } }, "hazards": { "title": "Storm damage types", "type": "array", "description": "Hail, measured or estimated damaging gusts, wind-damage reports (trees on houses, roofs off) and tornadoes.", "items": { "type": "string", "enum": [ "hail", "wind_gust", "wind_damage", "tornado" ], "enumTitles": [ "Hail", "Damaging wind gust", "Wind damage report", "Tornado" ] }, "default": [ "hail", "wind_gust", "wind_damage", "tornado" ] }, "minHailInches": { "title": "Minimum hail size (inches)", "minimum": 0.25, "maximum": 6, "type": "number", "description": "1.00 in (quarter) is where shingle damage usually starts. 1.75 in = golf ball.", "default": 1 }, "minWindMph": { "title": "Minimum wind gust (mph)", "minimum": 30, "maximum": 200, "type": "integer", "description": "58 mph is the National Weather Service severe threshold.", "default": 58 }, "minPriority": { "title": "Minimum priority", "enum": [ "low", "medium", "high" ], "type": "string", "description": "High = golf-ball hail or larger, 75+ mph gusts, tornadoes, or damage reports that mention roofs or homes. Medium = 1.25–1.74 in hail, 65–74 mph gusts, other wind damage. Low = everything else that passed the thresholds.", "default": "low" }, "onlyNew": { "title": "Only new reports", "type": "boolean", "description": "Skip reports already delivered by earlier runs in your account. Keep this on for scheduled runs so you never pay twice for the same report.", "default": true }, "lookbackHours": { "title": "Look back (hours)", "minimum": 1, "maximum": 720, "type": "integer", "description": "How far back to search. NWS offices often post reports hours after a storm, so keep at least 24 even when running hourly.", "default": 72 }, "centerPoint": { "title": "Service area center (optional)", "pattern": "^\\s*-?\\d+(\\.\\d+)?\\s*,\\s*-?\\d+(\\.\\d+)?\\s*$", "type": "string", "description": "Only return reports within the radius of this point. Format: latitude, longitude (e.g. 35.4676, -97.5164)." }, "radiusMiles": { "title": "Service area radius (miles)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Used only with a center point.", "default": 50 }, "maxResults": { "title": "Max leads per run", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on leads (and charges) per run. Highest priority and largest hail come first.", "default": 500 }, "matchWarnings": { "title": "Attach the NWS warning", "type": "boolean", "description": "Look up the Severe Thunderstorm or Tornado Warning polygon each report fell in, with the hail size and wind speed forecast for it.", "default": true } } }, "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 } } } } } } } } } }