{"uid":"cap_vTuB2_UBgOY9e8qkRzTV3","slug":"nws-area-forecast-discussion-api-75997497","name":"NWS Area Forecast Discussion API","description":"Latest NWS Area Forecast Discussion (forecaster reasoning, confidence, key messages, aviation) for a forecast office or the office covering a US point, split into sections; text=0 omits the raw product. 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/discussion?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.discussion","wfo":"BOU","country":"United States","sections":[{"text":"- Drier and warmer this weekend, with highs reaching into the 80s\n  across th...","title":"KEY MESSAGES","period":null}],"productId":"25fa07f5-da22-424f-8756-a361a7b8dbb8","generatedAt":"2026-09-26T07:40:20.766Z","productText":"\n000\nFXUS65 KBOU 260523\nAFDBOU\n\nArea Forecast Discussion\nNational Weather Ser...","sourceClass":"official-api","issuanceTime":"2026-09-26T05:23:00+00:00","issuingOffice":"KBOU"}},"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_cq0qbWoMekKtuQvkDZjve","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":"Retrieves the official National Weather Service Area Forecast Discussion (AFD) for a given Weather Forecast Office (WFO), including key messages, forecast reasoning, and full product text.","exampleAgentPrompt":"Can you pull the latest NWS Area Forecast Discussion from the Boulder weather office (BOU) and summarize the key messages about this weekend's conditions?","exampleUseCases":[{"title":"Weekend weather planning for outdoor event","prompt":"What is the National Weather Service saying about this weekend's weather in the Boulder area? Pull the latest forecast discussion from the BOU office and give me the key messages."},{"title":"Meteorologist reasoning for unusual forecast","prompt":"The forecast shows highs in the 80s which seems unusual — can you fetch the official NWS area forecast discussion from the Denver weather office so I can see the meteorologist's reasoning?"},{"title":"Daily weather briefing digest","prompt":"Every morning, pull the latest Area Forecast Discussion from the BOU weather forecast office and give me a summary of the key messages and any significant weather alerts mentioned."}],"resultDescription":"Returns a structured JSON object containing the full Area Forecast Discussion product text, parsed sections with titles (e.g. KEY MESSAGES), the issuing Weather Forecast Office code, issuance timestamp, a unique product ID, and source classification. The response mirrors the official NWS AFD format with machine-readable fields.","failureModes":["Invalid or unrecognized WFO office code returns an error or empty result","NWS upstream API unavailability may cause 502/503 errors","Payment of 0.005 USDC required via x402 protocol; missing payment returns 402","Discussion not yet issued for the current period may return stale or null data","Rate limiting if too many requests are made in quick succession"],"whenToPreferThis":"Choose this endpoint when you need the official NWS Area Forecast Discussion text for a specific Weather Forecast Office, particularly when you want the meteorologist's technical reasoning, narrative forecast discussion, or key messages behind a forecast — rather than just raw forecast data. It is ideal for agents building weather briefings, explaining forecast rationale to users, or monitoring official NWS communications. Prefer over raw NOAA API access when you need a pre-parsed, structured response with sections and metadata already extracted.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:36:39.840Z","isFirstParty":false,"canonicalSlug":"nws-area-forecast-discussion-api-75997497"}