{"uid":"cap_jOwX14zwfCd9nprkTS4QY","slug":"maxwell-international-weather-forecast-api-6d0eabeb","name":"Maxwell International Weather Forecast API","description":"NWS daily/period forecast (about 7 days, day and night periods) for a US point or grid. From the NWS (US and territories), cached and refreshed about every 3 hours; a location not yet cached answers 404, is not charged, and is queued.","url":"https://api.maxwellinternational.ai/v1/weather/forecast?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"sku":"weather.forecast","wfo":"BOU","cache":"hit","gridX":63,"gridY":62,"state":"Colorado","country":"United States","periods":[{"name":"Tonight","endTime":"2026-09-26T06:00:00-06:00","isDaytime":false,"startTime":"2026-09-25T21:00:00-06:00","windSpeed":"5 to 8 mph","temperature":53,"temperatureC":11.7,"shortForecast":"Mostly Clear","windDirection":"SSW","temperatureUnit":"F","detailedForecast":"Mostly clear. Low around 53, with temperatures rising to around 55 overnight...."}],"updatedAt":null,"generatedAt":"2026-09-26T03:52:17.125Z","sourceClass":"official-api","resolvedFrom":"latlon"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TgCXnNZ9_pDAVdV-nYce0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a multi-period weather forecast (temperature, wind, conditions) for a given location using official NWS grid data","exampleAgentPrompt":"What's the weather forecast for the next few days at coordinates 39.7°N, 104.9°W near Denver, Colorado? I need temperature in Fahrenheit, wind speed, and a detailed forecast for each period.","exampleUseCases":[{"title":"Outdoor event planning weather check","prompt":"I'm planning an outdoor concert in Boulder, Colorado this Saturday. Can you pull the official NWS weather forecast for 40.015°N, 105.27°W and tell me the temperature, wind conditions, and whether it'll be clear or rainy for the evening periods?"},{"title":"Packing forecast for upcoming travel","prompt":"I'm flying into Denver next week and want to know what the weather will be like. Fetch the forecast for 39.8561°N, 104.6737°W and give me the temperature highs and lows and wind conditions for each period."},{"title":"Agricultural frost risk monitoring","prompt":"Can you check the overnight low temperature forecast for my farm location at 40.1°N, 103.5°W in eastern Colorado? I need the temperature in Fahrenheit and the detailed forecast text for the overnight periods to decide if I need to protect my crops."}],"resultDescription":"Returns a JSON object containing multiple forecast periods (e.g. Tonight, Tomorrow, Tomorrow Night), each with start/end times, daytime flag, temperature in °F and °C, wind speed and direction, short forecast summary, and detailed forecast text. Also includes NWS WFO office code, grid coordinates (gridX/gridY), state, country, cache hit/miss status, and generation timestamp. Source class indicates official NWS API data resolved from lat/lon.","failureModes":["Coordinates outside NWS coverage area (non-US locations) may return no forecast data","NWS upstream API outage causing failed grid resolution","Cache miss with slow upstream response","Invalid or missing query parameters returning 400 error","Coordinates in ocean or non-continental US grid areas returning no WFO match","Payment failure (402) if x402 micropayment not processed correctly"],"whenToPreferThis":"Choose this endpoint when you need official US National Weather Service forecast data resolved from latitude/longitude coordinates, with structured multi-period forecasts including both Fahrenheit and Celsius temperatures, wind details, and human-readable forecast text. Prefer this over general weather APIs when NWS authority and official forecast grid data are required, or when building US-focused weather-dependent decision systems.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:41:58.110Z","isFirstParty":false,"canonicalSlug":"maxwell-international-weather-forecast-api-6d0eabeb"}