{"uid":"cap_jvb3pXY6eIxELxntrasGF","slug":"weatherxm-agent-api-7-day-weather-forecast-5a5413e6","name":"WeatherXM Agent API – 7-Day Weather Forecast","description":"7-day hourly and daily weather forecast","url":"https://agent.weatherxm.com/api/forecast","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"],"type":"string"},"queryParams":{"type":"object","required":["lat","lon"],"properties":{"tz":{"type":"string","description":"IANA timezone (e.g., Europe/Athens) or \"auto\""},"lat":{"type":"number","description":"Latitude (-90 to 90)"},"lon":{"type":"number","description":"Longitude (-180 to 180)"},"units":{"enum":["metric","imperial"],"type":"string","description":"Unit system: \"metric\" (default) or \"imperial\""}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","description":"7-day hourly and daily weather forecast data"}}}}},"responseSchema":{"type":"json","example":{"daily":[{"date":"2025-01-05","precipitation":0,"temperatureMax":18.5,"temperatureMin":12.3,"precipitationProbability":10}],"units":"metric","hourly":[{"time":"2025-01-05T12:00:00+02:00","humidity":65,"windSpeed":12.5,"temperature":15.2,"precipitation":0}],"location":{"lat":37.98,"lon":23.73},"timezone":"Europe/Athens"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_S72UEp6K64tN8zjE8_OYG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns 7-day hourly and daily weather forecasts for any lat/lon coordinate, including temperature, precipitation, humidity, and wind speed","exampleAgentPrompt":"What's the 7-day weather forecast for Athens, Greece (37.98°N, 23.73°E) in metric units, using the Europe/Athens timezone? I want hourly and daily breakdowns including temperature, precipitation, and wind.","exampleUseCases":[{"title":"Plan outdoor events by weather","prompt":"Check the 7-day weather forecast for our venue in Denver, Colorado. I need hourly temperature and precipitation data so we can schedule the outdoor festival on the driest, warmest day next week."},{"title":"Agricultural irrigation scheduling","prompt":"Get me the next 7 days of hourly precipitation and humidity forecasts for our farm near Fresno, California (36.74°N, 119.77°W). We need to know when rain is expected so we can optimize our irrigation system."},{"title":"Travel itinerary weather planning","prompt":"What's the hourly and daily weather forecast for Tokyo, Japan for the next week? I need temperature, wind speed, and precipitation probability to decide which days are best for outdoor sightseeing during my trip."}],"resultDescription":"A JSON object containing 7 days of daily forecasts (date, max/min temperature, precipitation, precipitation probability) and hourly forecasts (timestamp, temperature, humidity, wind speed, precipitation), plus location coordinates, timezone, and unit system used.","failureModes":["Missing required lat or lon parameters returns a 400 error","Latitude out of range (-90 to 90) or longitude out of range (-180 to 180) returns validation error","Invalid or unrecognized timezone string may cause timezone parsing error","Payment failure (x402 protocol) results in 402 Payment Required with no forecast data","Service unavailability or upstream data gap may return 503 or empty forecast arrays"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable multi-day (up to 7 days) weather forecast data keyed by geographic coordinates, especially when you require both hourly and daily granularity in a single call. Prefer this over current-conditions or historical endpoints when forward-looking planning is the goal. Well-suited for automation pipelines, travel planning, agricultural scheduling, or any agent workflow that needs upcoming weather at a precise lat/lon.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:35:09.662Z","isFirstParty":false}