--- type: "firecrawl-provider" description: "NWS watches, warnings and advisories (active and last ~7 days) and daily/hourly forecasts for a GeoJSON geometry in the United States: the land contract shared with the other land programs (geometry in; spatial_precision, sources, missing and a location echo out)." use_when: "NWS watches, warnings and advisories (active and last ~7 days) and daily/hourly forecasts for a GeoJSON geometry in the United States: the land contract shared with the other land programs (geometry in; spatial_precision, sources, missing and a location echo out)." categories: "Real estate" capabilities: 5 credits_per_call: 5 --- # National Weather Service API (api.weather.gov) on Firecrawl Alexandria NWS watches, warnings and advisories (active and last ~7 days) and daily/hourly forecasts for a GeoJSON geometry in the United States: the land contract shared with the other land programs (geometry in; spatial_precision, sources, missing and a location echo out). - Categories: Real estate - Category index: [Real estate category](https://firecrawl.dev/alexandria/agents/categories/real-estate) - Provider key: `api-weather-gov` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/api-weather-gov) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/api-weather-gov/openapi.json) ## Capabilities - [Alert](https://firecrawl.dev/alexandria/agents/providers/api-weather-gov/weather/alert): One NWS alert by CAP id from /alerts/{id}: full description and instruction, geocodes, affected zones and the storm polygon when the alert has one. - [Alerts active](https://firecrawl.dev/alexandria/agents/providers/api-weather-gov/weather/alerts_active): Active NWS watches, warnings and advisories (status actual) for a GeoJSON geometry. Samples the centroid and ring vertices, resolves their county, forecast and fire zones with /zones?point=, reads /alerts/active?zone=... and keeps zone-based alerts (match zone, precision county) plus storm-based alerts whose polygon intersects the geometry or lies within buffer_km of it (match polygon, precision polygon). - [Alerts history](https://firecrawl.dev/alexandria/agents/providers/api-weather-gov/weather/alerts_history): NWS alerts (status actual) whose zones or polygon covered a GeoJSON geometry within a date window, from /alerts?zone=...&start=...&end=.... The API keeps about seven days of alerts; a window older than that is reported in `missing`, not guessed. Pages with `continuation` (the API's opaque cursor). - [Forecast daily](https://firecrawl.dev/alexandria/agents/providers/api-weather-gov/weather/forecast_daily): Per-local-day quantitative forecast for the NWS 2.5 km grid cell containing the geometry's centroid, aggregated from the raw gridpoint series (/gridpoints/{wfo}/{x},{y}): precipitation (mm), max/min temperature (C), min relative humidity, max wind and gust (km/h), max probability of precipitation, plus the day and night text from the 12-hour forecast, which also supplies the local UTC offset. - [Forecast hourly](https://firecrawl.dev/alexandria/agents/providers/api-weather-gov/weather/forecast_hourly): Hourly forecast periods for the NWS grid cell containing the geometry's centroid, from /gridpoints/{wfo}/{x},{y}/forecast/hourly: temperature (as the source states it, F), dewpoint (C), relative humidity, probability of precipitation, wind and short forecast text, with local-offset timestamps. ## 1. Choose this provider when NWS watches, warnings and advisories (active and last ~7 days) and daily/hourly forecasts for a GeoJSON geometry in the United States: the land contract shared with the other land programs (geometry in; spatial_precision, sources, missing and a location echo out). ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "api-weather-gov", "capability": "weather/alert", "options": { "id": "urn:oid:2.49.0.1.840.0.9e766ef59956321185e90b57796fe623a623b014.001.1" } } ``` ## 3. Add provider options Use only the options needed for the task: - `id` (string): CAP identifier, e.g. urn:oid:2.49.0.1.840.0.9e766ef59956321185e90b57796fe623a623b014.001.1. Pattern: ^urn:oid:[0-9][0-9.]*(\.[0-9a-f]+)?\.[0-9]+\.[0-9]+$. Example: `` - `url` (string): Alternative to id: the alert URL https://api.weather.gov/alerts/urn:oid:... Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "api-weather-gov", capability: "weather/alert", options: { id: "urn:oid:2.49.0.1.840.0.9e766ef59956321185e90b57796fe623a623b014.001.1", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "api-weather-gov", "capability": "weather/alert", "options": { "id": "urn:oid:2.49.0.1.840.0.9e766ef59956321185e90b57796fe623a623b014.001.1" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "api-weather-gov", "capability": "weather/alert", "options": { "id": "urn:oid:2.49.0.1.840.0.9e766ef59956321185e90b57796fe623a623b014.001.1" } } }' ``` ### CLI ```sh firecrawl scrape 'api-weather-gov/weather/alert' \ --options '{"id":"urn:oid:2.49.0.1.840.0.9e766ef59956321185e90b57796fe623a623b014.001.1"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "api-weather-gov", "capability": "weather/alert", "options": { "id": "urn:oid:2.49.0.1.840.0.9e766ef59956321185e90b57796fe623a623b014.001.1" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "api-weather-gov", "capability": "weather/alert", "options": { "id": "urn:oid:2.49.0.1.840.0.9e766ef59956321185e90b57796fe623a623b014.001.1" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "alert": { "affected_zones": [ "TXC439" ], "area_desc": "Tarrant, TX", "category": "Met", "certainty": "Likely", "description": "...The National Weather Service in Fort Worth has issued a Flood\nWarning for the following rivers in Texas...\n\nWalnut Creek Near Mansfield affecting Tarrant County.\n\n* WHAT...Minor flooding is forecast.\n\n* WHERE...Walnut Creek near Mansfield.\n\n* WHEN...Until late tonight.\n\n* IMPACTS...At 19.0 feet, Minor flooding will occur along the creek\nthrough Mansfield, downstream of Joe Pool Lake. By 19 feet, Retta\nRoad is flooded.\n\n* ADDITIONAL DETAILS...\n- At 11:00 AM CDT Thursday the stage was 18.0 feet.\n- Forecast...The river will rise above flood stage to 19.3 feet\nthis afternoon. It will then fall below flood stage this\nafternoon to 11.2 feet tomorrow morning. It will rise to 11.3\nfeet tomorrow morning. It will then fall again and remain below\nflood stage.\n- Bankfull stage is 22.0 feet.\n- Flood stage is 19.0 feet.", "distance_km": null, "effective": "2026-10-01T11:26:00-05:00", "ends": "2026-10-02T02:00:00-05:00", "event": "Flood Warning", "expires": "2026-10-02T02:00:00-05:00", "has_polygon": true, "headline": "Flood Warning issued October 1 at 11:26AM CDT until October 2 at 2:00AM CDT by NWS Fort Worth TX", "id": "urn:oid:2.49.0.1.840.0.9e766ef59956321185e90b57796fe623a623b014.001.1", "instruction": "Do not drive cars through flooded areas. Caution is urged when\nwalking near riverbanks.\n\nAdditional information is available at water.noaa.gov/wfo/fwd.", "match": "polygon", "message_type": "Alert", "nws_headline": "FLOOD WARNING IN EFFECT UNTIL LATE TONIGHT", "onset": "2026-10-01T12:37:00-05:00", "response": "Avoid", "same": [ "048439" ], "sender_name": "NWS Fort Worth TX", "sent": "2026-10-01T11:26:00-05:00", "severity": "Severe", "spatial_precision": "polygon", "status": "Actual", "ugc": [ "TXC439" ], "urgency": "Expected", "url": "https://api.weather.gov/alerts/urn:oid:2.49.0.1.840.0.9e766ef59956321185e90b57796fe623a623b014.001.1", "vtec": "/O.NEW.KFWD.FL.W.0045.261001T1737Z-261002T0700Z/" }, "location": { "area_m2": 87520882, "bbox": [ -97.18, 32.52, -97.06, 32.63 ], "centroid": [ -97.123095, 32.576587 ], "kind": "Polygon" }, "missing": [], "observed_at_ms": 1790877891401, "polygon": [ [ -97.18, 32.6 ], [ -97.08, 32.63 ], [ -97.06, 32.56 ], [ -97.17, 32.52 ], [ -97.18, 32.6 ] ], "sources": [ { "name": "NWS alert", "observed_at": "2026-10-01T18:04:51Z", "url": "https://api.weather.gov/alerts/urn%3Aoid%3A2.49.0.1.840.0.9e766ef59956321185e90b57796fe623a623b014.001.1" } ], "spatial_precision": "polygon" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Alert - Capability: `weather/alert` - Description: One NWS alert by CAP id from /alerts/{id}: full description and instruction, geocodes, affected zones and the storm polygon when the alert has one. - Instructions: Read the full text of an alert returned by alerts_active or alerts_history. - Cost: 5 credits per call - Capability file: [Alert](https://firecrawl.dev/alexandria/agents/providers/api-weather-gov/weather/alert) Accepted options: - `id` (string): CAP identifier, e.g. urn:oid:2.49.0.1.840.0.9e766ef59956321185e90b57796fe623a623b014.001.1. Pattern: ^urn:oid:[0-9][0-9.]*(\.[0-9a-f]+)?\.[0-9]+\.[0-9]+$. Example: `` - `url` (string): Alternative to id: the alert URL https://api.weather.gov/alerts/urn:oid:... Example: `` Response schema example: ```json { "alert": { "affected_zones": [ "TXC439" ], "area_desc": "Tarrant, TX", "category": "Met", "certainty": "Likely", "description": "...The National Weather Service in Fort Worth has issued a Flood\nWarning for the following rivers in Texas...\n\nWalnut Creek Near Mansfield affecting Tarrant County.\n\n* WHAT...Minor flooding is forecast.\n\n* WHERE...Walnut Creek near Mansfield.\n\n* WHEN...Until late tonight.\n\n* IMPACTS...At 19.0 feet, Minor flooding will occur along the creek\nthrough Mansfield, downstream of Joe Pool Lake. By 19 feet, Retta\nRoad is flooded.\n\n* ADDITIONAL DETAILS...\n- At 11:00 AM CDT Thursday the stage was 18.0 feet.\n- Forecast...The river will rise above flood stage to 19.3 feet\nthis afternoon. It will then fall below flood stage this\nafternoon to 11.2 feet tomorrow morning. It will rise to 11.3\nfeet tomorrow morning. It will then fall again and remain below\nflood stage.\n- Bankfull stage is 22.0 feet.\n- Flood stage is 19.0 feet.", "distance_km": null, "effective": "2026-10-01T11:26:00-05:00", "ends": "2026-10-02T02:00:00-05:00", "event": "Flood Warning", "expires": "2026-10-02T02:00:00-05:00", "has_polygon": true, "headline": "Flood Warning issued October 1 at 11:26AM CDT until October 2 at 2:00AM CDT by NWS Fort Worth TX", "id": "urn:oid:2.49.0.1.840.0.9e766ef59956321185e90b57796fe623a623b014.001.1", "instruction": "Do not drive cars through flooded areas. Caution is urged when\nwalking near riverbanks.\n\nAdditional information is available at water.noaa.gov/wfo/fwd.", "match": "polygon", "message_type": "Alert", "nws_headline": "FLOOD WARNING IN EFFECT UNTIL LATE TONIGHT", "onset": "2026-10-01T12:37:00-05:00", "response": "Avoid", "same": [ "048439" ], "sender_name": "NWS Fort Worth TX", "sent": "2026-10-01T11:26:00-05:00", "severity": "Severe", "spatial_precision": "polygon", "status": "Actual", "ugc": [ "TXC439" ], "urgency": "Expected", "url": "https://api.weather.gov/alerts/urn:oid:2.49.0.1.840.0.9e766ef59956321185e90b57796fe623a623b014.001.1", "vtec": "/O.NEW.KFWD.FL.W.0045.261001T1737Z-261002T0700Z/" }, "location": { "area_m2": 87520882, "bbox": [ -97.18, 32.52, -97.06, 32.63 ], "centroid": [ -97.123095, 32.576587 ], "kind": "Polygon" }, "missing": [], "observed_at_ms": 1790877891401, "polygon": [ [ -97.18, 32.6 ], [ -97.08, 32.63 ], [ -97.06, 32.56 ], [ -97.17, 32.52 ], [ -97.18, 32.6 ] ], "sources": [ { "name": "NWS alert", "observed_at": "2026-10-01T18:04:51Z", "url": "https://api.weather.gov/alerts/urn%3Aoid%3A2.49.0.1.840.0.9e766ef59956321185e90b57796fe623a623b014.001.1" } ], "spatial_precision": "polygon" } ``` ### Alerts active - Capability: `weather/alerts_active` - Description: Active NWS watches, warnings and advisories (status actual) for a GeoJSON geometry. Samples the centroid and ring vertices, resolves their county, forecast and fire zones with /zones?point=, reads /alerts/active?zone=... and keeps zone-based alerts (match zone, precision county) plus storm-based alerts whose polygon intersects the geometry or lies within buffer_km of it (match polygon, precision polygon). - Instructions: Which watches, warnings and advisories (red flag, fire weather, flood, heat, severe storms) are in effect right now for this paddock, parcel or point, optionally including those within up to 5 km. For past alerts use alerts_history; for one alert's full text use alert. - Cost: 5 credits per call - Capability file: [Alerts active](https://firecrawl.dev/alexandria/agents/providers/api-weather-gov/weather/alerts_active) Accepted options: - `buffer_km` (number): Also keep storm-based alerts whose polygon lies within this many kilometres of the geometry, and resolve zones for points this far outside its bounding box. Example: `0` - `events` (string[]): Keep only these event names (case-insensitive substring match on the NWS event name, e.g. "Red Flag", "Flood", "Heat"). Example: `[]` - `geometry` (object, required): GeoJSON (RFC 7946, WGS84, [lon, lat]) Point, Polygon or MultiPolygon, or a Feature wrapping one. Rings must be closed; altitude is ignored. A FeatureCollection is refused (send one place per call), as is a geometry crossing the antimeridian. Invalid input is `invalid_input` with a JSON pointer and a stable code (ring_not_closed, latitude, longitude, too_large, too_many_vertices, outside_coverage). Example: `{}` - `severity` (string[]): Keep only alerts with one of these CAP severities. Example: `[]` Response schema example: ```json { "alerts": [], "buffer_km": 0, "count": 0, "location": { "area_m2": 601272, "bbox": [ -86.93, 35.853, -86.92, 35.859 ], "centroid": [ -86.925, 35.856 ], "kind": "Polygon" }, "missing": [], "observed_at_ms": 1790877907339, "sources": [ { "name": "NWS point metadata", "observed_at": "2026-10-01T18:05:05Z", "url": "https://api.weather.gov/points/35.856,-86.925" }, { "name": "NWS zones at point", "observed_at": "2026-10-01T18:05:06Z", "url": "https://api.weather.gov/zones?point=35.856,-86.925" }, { "name": "NWS zones at point", "observed_at": "2026-10-01T18:05:06Z", "url": "https://api.weather.gov/zones?point=35.853,-86.93" }, { "name": "NWS zones at point", "observed_at": "2026-10-01T18:05:06Z", "url": "https://api.weather.gov/zones?point=35.853,-86.92" }, { "name": "NWS zones at point", "observed_at": "2026-10-01T18:05:06Z", "url": "https://api.weather.gov/zones?point=35.859,-86.92" }, { "name": "NWS zones at point", "observed_at": "2026-10-01T18:05:06Z", "url": "https://api.weather.gov/zones?point=35.859,-86.93" }, { "name": "NWS active alerts by zone", "observed_at": "2026-10-01T18:05:07Z", "url": "https://api.weather.gov/alerts/active?zone=TNC187%2CTNZ059&status=actual" } ], "spatial_precision": "county", "updated": "2026-10-01T18:04:28+00:00", "zones": [ { "id": "TNC187", "name": "Williamson", "state": "TN", "type": "county", "url": "https://api.weather.gov/zones/county/TNC187" }, { "id": "TNZ059", "name": "Williamson", "state": "TN", "type": "fire", "url": "https://api.weather.gov/zones/fire/TNZ059" }, { "id": "TNZ059", "name": "Williamson", "state": "TN", "type": "public", "url": "https://api.weather.gov/zones/forecast/TNZ059" } ] } ``` ### Alerts history - Capability: `weather/alerts_history` - Description: NWS alerts (status actual) whose zones or polygon covered a GeoJSON geometry within a date window, from /alerts?zone=...&start=...&end=.... The API keeps about seven days of alerts; a window older than that is reported in `missing`, not guessed. Pages with `continuation` (the API's opaque cursor). - Instructions: Which alerts affected this parcel or paddock in the last week (start/end as YYYY-MM-DD). Pass `continuation` from the previous page to continue; alerts_active for what is in effect now. - Cost: 5 credits per call - Capability file: [Alerts history](https://firecrawl.dev/alexandria/agents/providers/api-weather-gov/weather/alerts_history) Accepted options: - `continuation` (string): Opaque cursor from the previous page's meta.page.next_cursor. Example: `` - `end` (string, required): Last day of the window, YYYY-MM-DD (UTC, through 23:59:59). At most 31 days after start. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `events` (string[]): Keep only these event names (case-insensitive substring match on the NWS event name). Example: `[]` - `geometry` (object, required): GeoJSON (RFC 7946, WGS84, [lon, lat]) Point, Polygon or MultiPolygon, or a Feature wrapping one. Rings must be closed; altitude is ignored. A FeatureCollection is refused (send one place per call), as is a geometry crossing the antimeridian. Invalid input is `invalid_input` with a JSON pointer and a stable code (ring_not_closed, latitude, longitude, too_large, too_many_vertices, outside_coverage). Example: `{}` - `limit` (number): Alerts per page before polygon filtering. Example: `100` - `start` (string, required): First day of the window, YYYY-MM-DD (UTC, from 00:00:00). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` Response schema example: ```json { "alerts": [], "count": 0, "fetched": 10, "location": { "area_m2": 4037899, "bbox": [ -100.1, 35.26, -100.08, 35.28 ], "centroid": [ -100.09, 35.27 ], "kind": "Polygon" }, "missing": [], "observed_at_ms": 1790877912653, "sources": [ { "name": "NWS point metadata", "observed_at": "2026-10-01T18:05:12Z", "url": "https://api.weather.gov/points/35.27,-100.09" }, { "name": "NWS zones at point", "observed_at": "2026-10-01T18:05:12Z", "url": "https://api.weather.gov/zones?point=35.27,-100.09" }, { "name": "NWS zones at point", "observed_at": "2026-10-01T18:05:12Z", "url": "https://api.weather.gov/zones?point=35.26,-100.1" }, { "name": "NWS zones at point", "observed_at": "2026-10-01T18:05:12Z", "url": "https://api.weather.gov/zones?point=35.26,-100.08" }, { "name": "NWS zones at point", "observed_at": "2026-10-01T18:05:12Z", "url": "https://api.weather.gov/zones?point=35.28,-100.08" }, { "name": "NWS zones at point", "observed_at": "2026-10-01T18:05:12Z", "url": "https://api.weather.gov/zones?point=35.28,-100.1" }, { "name": "NWS alert history by zone", "observed_at": "2026-10-01T18:05:12Z", "url": "https://api.weather.gov/alerts?zone=TXC483%2CTXZ015&start=2026-09-25T00%3A00%3A00%2B00%3A00&end=2026-10-01T23%3A59%3A59%2B00%3A00&status=actual&limit=100" } ], "spatial_precision": "county", "window": { "end": "2026-10-01T23:59:59+00:00", "start": "2026-09-25T00:00:00+00:00" }, "zones": [ { "id": "TXC483", "name": "Wheeler", "state": "TX", "type": "county", "url": "https://api.weather.gov/zones/county/TXC483" }, { "id": "TXZ015", "name": "Wheeler", "state": "TX", "type": "fire", "url": "https://api.weather.gov/zones/fire/TXZ015" }, { "id": "TXZ015", "name": "Wheeler", "state": "TX", "type": "public", "url": "https://api.weather.gov/zones/forecast/TXZ015" } ] } ``` ### Forecast daily - Capability: `weather/forecast_daily` - Description: Per-local-day quantitative forecast for the NWS 2.5 km grid cell containing the geometry's centroid, aggregated from the raw gridpoint series (/gridpoints/{wfo}/{x},{y}): precipitation (mm), max/min temperature (C), min relative humidity, max wind and gust (km/h), max probability of precipitation, plus the day and night text from the 12-hour forecast, which also supplies the local UTC offset. - Instructions: How much rain is forecast per day over the next 7 days for this field, with highs, lows, wind and minimum humidity. Hourly detail: forecast_hourly. - Cost: 5 credits per call - Capability file: [Forecast daily](https://firecrawl.dev/alexandria/agents/providers/api-weather-gov/weather/forecast_daily) Accepted options: - `days` (number): Number of local days to return, starting with the first day of the forecast. Example: `7` - `geometry` (object, required): GeoJSON (RFC 7946, WGS84, [lon, lat]) Point, Polygon or MultiPolygon, or a Feature wrapping one. Rings must be closed; altitude is ignored. A FeatureCollection is refused (send one place per call), as is a geometry crossing the antimeridian. Invalid input is `invalid_input` with a JSON pointer and a stable code (ring_not_closed, latitude, longitude, too_large, too_many_vertices, outside_coverage). Example: `{}` Response schema example: ```json { "days": [ { "date": "2026-10-01", "day_forecast": "Partly Sunny", "hours_covered": 23, "night_forecast": "Mostly Cloudy", "pop_max_pct": 0, "precip_mm": 0, "rh_min_pct": 43, "temp_max_c": 33.9, "temp_min_c": 17.8, "wind_gust_max_kmh": 29.6, "wind_speed_max_kmh": 20.4 }, { "date": "2026-10-02", "day_forecast": "Slight Chance Rain Showers then Chance Showers And Thunderstorms", "hours_covered": 24, "night_forecast": "Chance Showers And Thunderstorms then Showers And Thunderstorms Likely", "pop_max_pct": 64, "precip_mm": 8.68, "rh_min_pct": 68, "temp_max_c": 31.7, "temp_min_c": 21.1, "wind_gust_max_kmh": 27.8, "wind_speed_max_kmh": 14.8 }, { "date": "2026-10-03", "day_forecast": "Chance Showers And Thunderstorms", "hours_covered": 24, "night_forecast": "Chance Rain Showers", "pop_max_pct": 57, "precip_mm": 5.08, "rh_min_pct": 82, "temp_max_c": 25.6, "temp_min_c": 18.3, "wind_gust_max_kmh": 20.4, "wind_speed_max_kmh": 11.1 }, { "date": "2026-10-04", "day_forecast": "Chance Rain Showers", "hours_covered": 24, "night_forecast": "Chance Rain Showers then Mostly Cloudy", "pop_max_pct": 44, "precip_mm": 9.36, "rh_min_pct": 78, "temp_max_c": 25, "temp_min_c": 17.8, "wind_gust_max_kmh": 18.5, "wind_speed_max_kmh": 11.1 }, { "date": "2026-10-05", "day_forecast": "Mostly Sunny", "hours_covered": 24, "night_forecast": "Mostly Clear", "pop_max_pct": 9, "precip_mm": 0, "rh_min_pct": 47, "temp_max_c": 25, "temp_min_c": 12.2, "wind_gust_max_kmh": 27.8, "wind_speed_max_kmh": 20.4 }, { "date": "2026-10-06", "day_forecast": "Sunny", "hours_covered": 24, "night_forecast": "Mostly Clear", "pop_max_pct": 1, "precip_mm": 0, "rh_min_pct": 47, "temp_max_c": 25.6, "temp_min_c": 9.4, "wind_gust_max_kmh": 24.1, "wind_speed_max_kmh": 13 }, { "date": "2026-10-07", "day_forecast": "Sunny", "hours_covered": 24, "night_forecast": "Mostly Clear", "pop_max_pct": 2, "precip_mm": 0, "rh_min_pct": 42, "temp_max_c": 26.7, "temp_min_c": 10, "wind_gust_max_kmh": 13, "wind_speed_max_kmh": 5.6 } ], "grid": { "contains_geometry": true, "elevation_m": 210.9216, "polygon": [ [ -86.9057, 35.8482 ], [ -86.904, 35.8706 ], [ -86.9317, 35.8719 ], [ -86.9333, 35.8495 ], [ -86.9057, 35.8482 ] ], "time_zone": "America/Chicago", "utc_offset": "-05:00", "wfo": "OHX", "x": 46, "y": 43 }, "location": { "area_m2": 601272, "bbox": [ -86.93, 35.853, -86.92, 35.859 ], "centroid": [ -86.925, 35.856 ], "kind": "Polygon" }, "missing": [], "observed_at_ms": 1790877881106, "sources": [ { "name": "NWS point metadata", "observed_at": "2026-10-01T18:04:40Z", "url": "https://api.weather.gov/points/35.856,-86.925" }, { "name": "NWS raw gridpoint series", "observed_at": "2026-10-01T18:04:41Z", "url": "https://api.weather.gov/gridpoints/OHX/46,43" }, { "name": "NWS 12-hour forecast", "observed_at": "2026-10-01T18:04:41Z", "url": "https://api.weather.gov/gridpoints/OHX/46,43/forecast" } ], "spatial_precision": "grid_cell", "updated_at": "2026-10-01T12:06:48+00:00" } ``` ### Forecast hourly - Capability: `weather/forecast_hourly` - Description: Hourly forecast periods for the NWS grid cell containing the geometry's centroid, from /gridpoints/{wfo}/{x},{y}/forecast/hourly: temperature (as the source states it, F), dewpoint (C), relative humidity, probability of precipitation, wind and short forecast text, with local-offset timestamps. - Instructions: Hourly temperature and humidity for the next two days (default 48 hours, up to 156) at this paddock or parcel. - Cost: 5 credits per call - Capability file: [Forecast hourly](https://firecrawl.dev/alexandria/agents/providers/api-weather-gov/weather/forecast_hourly) Accepted options: - `geometry` (object, required): GeoJSON (RFC 7946, WGS84, [lon, lat]) Point, Polygon or MultiPolygon, or a Feature wrapping one. Rings must be closed; altitude is ignored. A FeatureCollection is refused (send one place per call), as is a geometry crossing the antimeridian. Invalid input is `invalid_input` with a JSON pointer and a stable code (ring_not_closed, latitude, longitude, too_large, too_many_vertices, outside_coverage). Example: `{}` - `hours` (number): Number of hourly periods to return from the start of the forecast. Example: `48` Response schema example: ```json { "grid": { "contains_geometry": true, "elevation_m": 210.9216, "polygon": [ [ -86.9057, 35.8482 ], [ -86.904, 35.8706 ], [ -86.9317, 35.8719 ], [ -86.9333, 35.8495 ], [ -86.9057, 35.8482 ] ], "time_zone": "America/Chicago", "utc_offset": "-05:00", "wfo": "OHX", "x": 46, "y": 43 }, "hours": [ { "dewpoint_c": 20, "end": "2026-10-01T14:00:00-05:00", "is_daytime": true, "pop_pct": 0, "relative_humidity_pct": 49, "short_forecast": "Partly Sunny", "start": "2026-10-01T13:00:00-05:00", "temperature": 90, "temperature_unit": "F", "wind_direction": "S", "wind_speed": "10 mph" }, { "dewpoint_c": 20, "end": "2026-10-01T15:00:00-05:00", "is_daytime": true, "pop_pct": 0, "relative_humidity_pct": 47, "short_forecast": "Mostly Sunny", "start": "2026-10-01T14:00:00-05:00", "temperature": 91, "temperature_unit": "F", "wind_direction": "S", "wind_speed": "15 mph" }, { "dewpoint_c": 20, "end": "2026-10-01T16:00:00-05:00", "is_daytime": true, "pop_pct": 0, "relative_humidity_pct": 46, "short_forecast": "Mostly Sunny", "start": "2026-10-01T15:00:00-05:00", "temperature": 92, "temperature_unit": "F", "wind_direction": "S", "wind_speed": "15 mph" }, { "dewpoint_c": 19.4, "end": "2026-10-01T17:00:00-05:00", "is_daytime": true, "pop_pct": 0, "relative_humidity_pct": 43, "short_forecast": "Partly Sunny", "start": "2026-10-01T16:00:00-05:00", "temperature": 93, "temperature_unit": "F", "wind_direction": "S", "wind_speed": "10 mph" }, { "dewpoint_c": 19.4, "end": "2026-10-01T18:00:00-05:00", "is_daytime": true, "pop_pct": 0, "relative_humidity_pct": 45, "short_forecast": "Mostly Sunny", "start": "2026-10-01T17:00:00-05:00", "temperature": 91, "temperature_unit": "F", "wind_direction": "S", "wind_speed": "10 mph" }, { "dewpoint_c": 19.4, "end": "2026-10-01T19:00:00-05:00", "is_daytime": false, "pop_pct": 0, "relative_humidity_pct": 47, "short_forecast": "Partly Cloudy", "start": "2026-10-01T18:00:00-05:00", "temperature": 90, "temperature_unit": "F", "wind_direction": "S", "wind_speed": "10 mph" } ], "location": { "area_m2": 601272, "bbox": [ -86.93, 35.853, -86.92, 35.859 ], "centroid": [ -86.925, 35.856 ], "kind": "Polygon" }, "missing": [], "observed_at_ms": 1790877886427, "sources": [ { "name": "NWS point metadata", "observed_at": "2026-10-01T18:04:46Z", "url": "https://api.weather.gov/points/35.856,-86.925" }, { "name": "NWS hourly forecast", "observed_at": "2026-10-01T18:04:46Z", "url": "https://api.weather.gov/gridpoints/OHX/46,43/forecast/hourly" } ], "spatial_precision": "grid_cell", "updated_at": "2026-10-01T12:06:48+00:00" } ```