{"uid":"cap_JXu2Do-mUCSKMwrd_0RDM","slug":"climatepulse-date-pick-outdoor-event-date-ranker-cfef4882","name":"ClimatePulse Date-Pick — Outdoor Event Date Ranker","description":"Rank 2-6 candidate dates for an outdoor event by real historical weather odds. Rain, heat, frost, wind, and extreme-heat probabilities counted in code from 10 years of NASA POWER reanalysis rows for each date, a deterministic 0-100 weather-favorability score, per-date risk verdicts, and a plain-language recommendation. The \"which Saturday should we book?\" call for weddings, festivals, and races — any location worldwide.","url":"https://climatepulse.theaslangroupllc.com/api/climate/date-pick","method":"GET","headers":{},"bodySchema":{"type":"object","required":["dates","location"],"properties":{"lang":{"type":"string","description":"Response language code (e.g. es, fr, de); defaults to English"},"dates":{"type":"string","description":"2-6 comma-separated candidate dates (YYYY-MM-DD)"},"units":{"type":"string","description":"imperial (default) or metric"},"location":{"type":"string","description":"City, address, or lat,lon of the event venue"},"event_type":{"type":"string","description":"Event type — tailors the notes (wedding, marathon, outdoor-festival, …)"}}},"responseSchema":{"type":"json","example":{"ranking":[{"date":"2027-10-09","rank":1,"risk":{"heat":"low","rain":"low","overall":"low"},"probabilities_pct":{"hot_day":9,"any_rain":13},"favorability_score":88},{"date":"2027-04-10","rank":2,"risk":{"heat":"low","rain":"moderate","overall":"moderate"},"probabilities_pct":{"hot_day":1,"any_rain":26},"favorability_score":74},{"date":"2027-05-15","rank":3,"risk":{"heat":"moderate","rain":"moderate","overall":"moderate"},"probabilities_pct":{"hot_day":14,"any_rain":31},"favorability_score":61}],"location":"Austin, TX, United States","recommendation":"Book October 9th: half the rain odds of either spring date and essentially no heat risk.","scoring_method":"100 minus weighted historical probabilities — deterministic and recomputable"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KHOfuFjfmScazw2HpL6zL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Ranks 2–6 candidate dates for an outdoor event by historical weather favorability using 10 years of NASA POWER reanalysis data, returning a 0–100 score, risk verdicts, and a plain-language booking recommendation.","exampleAgentPrompt":"I'm planning an outdoor wedding and need to pick between May 10, May 17, May 24, and May 31, 2025 near Austin, Texas — can you rank those dates by historical weather odds and tell me which one to book?","exampleUseCases":null,"resultDescription":"Returns a ranked list of the candidate dates each with a deterministic 0–100 weather-favorability score, per-date probabilities for rain, heat, frost, wind, and extreme heat derived from 10 years of NASA POWER reanalysis data, a risk verdict label per date, and a plain-language recommendation identifying the best booking choice.","failureModes":["Fewer than 2 or more than 6 candidate dates provided — returns validation error","Invalid or unrecognizable location — returns geocoding error","Dates outside the 10-year historical reanalysis window — insufficient data error","Network timeout fetching NASA POWER data — 504 response","Payment not completed or insufficient USDC — 402 Payment Required"],"whenToPreferThis":"Use this endpoint when a user needs to choose between specific calendar dates for an outdoor event and wants the decision grounded in multi-year historical climate odds rather than a short-range forecast. Ideal for weddings, festivals, races, graduations, and any event booked weeks or months in advance where future forecasts are unavailable. Prefer this over a simple forecast API when comparing multiple candidate dates or when the event date is more than 10 days out.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:38:52.392Z","isFirstParty":false}