{"uid":"cap_netIjDHxY5V2izEOp-oVV","slug":"agentsvc-io-weather-forecast-api-36200a60","name":"agentsvc.io Weather Forecast API","description":"86 APIs for AI agents: web scraping and crawling to Markdown, AI summaries, data extraction and cited answers, screenshots and PDF, PDF, OCR and document conversion, news, paper and developer search and more, paid per call with USDC on Base, Solana, Polygon or Arbitrum via x402. No account, no API key, free sample on every service.","url":"https://agentsvc.io/api/v1/proxy/weather?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"days":{"type":"integer","default":3,"maximum":10,"minimum":1,"description":"Days of daily forecast (the model reaches about 9.5 days)"},"hours":{"type":"integer","default":0,"maximum":48,"minimum":0,"description":"Hourly forecast steps (0 = none)"},"units":{"enum":["metric","imperial"],"type":"string","default":"metric"},"location":{"type":"string","default":"Berlin","description":"City name (e.g. 'Berlin'), or lat,lon string (e.g. '52.52,13.41'). Default: Berlin"}}},"responseSchema":{"type":"json","example":{"data":{"current":{"temp_c":12.5,"wind_kph":14.8,"feels_like_c":10.2,"humidity_pct":71,"weather_code":3},"location":{"lat":52.52,"lon":13.41,"name":"Berlin"},"forecast_3d":[{"date":"2026-04-07","temp_max_c":14,"temp_min_c":8.2,"weather_code":1},{"date":"2026-04-08","temp_max_c":16.5,"temp_min_c":9,"weather_code":2},{"date":"2026-04-09","temp_max_c":13,"temp_min_c":7.8,"weather_code":61}]},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iEDmL2-4xKsPl8MH2edsX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current weather conditions and a multi-day (up to 16-day daily, 48-hour hourly) forecast for a given city or lat/lon coordinate","exampleAgentPrompt":"What's the current weather in Tokyo and give me a 5-day daily forecast in metric units?","exampleUseCases":[{"title":"Trip packing decision support","prompt":"What will the weather be like in Barcelona over the next 7 days — give me the daily highs and lows in Celsius so I know what to bring?"},{"title":"Outdoor event planning check","prompt":"Can you pull a 3-day forecast for Austin, Texas in imperial units starting today, including hourly data for the next 24 hours?"},{"title":"Remote field worker briefing","prompt":"Get me the current conditions and a 10-day daily forecast for coordinates 64.13,-21.9 in metric — I need temperature, wind, and humidity."}],"resultDescription":"Returns a JSON object with: current conditions (temperature in °C, feels-like, wind speed in kph, humidity %, WMO weather code); resolved location (name, lat, lon); and a daily forecast array for the requested number of days (date, max/min temp, weather code). Hourly steps are included when requested.","failureModes":["Unknown or misspelled location name returns an error or defaults to Berlin","Days value outside 1–16 or hours outside 0–48 will be rejected by schema validation","Network timeout from upstream weather provider returns a 5xx error","Malformed lat/lon string (e.g. missing comma) may fail to resolve location","Insufficient USDC balance or failed x402 payment returns a 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when an AI agent needs weather data without setting up a dedicated API key or account — ideal for pay-per-call workflows using USDC on Base. Supports up to 16-day daily and 48-hour hourly forecasts, both city name and coordinate lookups, and metric/imperial units. Best for lightweight, on-demand weather enrichment inside agent pipelines at $0.002 per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:42:19.148Z","isFirstParty":false,"canonicalSlug":"agentsvc-io-weather-forecast-api-36200a60"}