# Vibesprings Weather Forecast API

> Vibesprings Weather Forecast API is a paid API for AI agents from vibesprings.net, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10, last successful call 2026-07-01).

Returns detailed daily weather forecasts for up to 16 days for any city or coordinates, including temperature ranges, precipitation, wind, UV index, and condition codes.

## Facts

- Endpoint: GET https://vibesprings.net/api/forecast?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Last successful call: 2026-07-01
- Success rate: 50% of calls made through Zero
- Rating: 4.7 / 5 from 1 review
- Activations on Zero: 8
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vibesprings-net-9d9362e7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yoG8Kyvz5uOfnIBOqSlb5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vibesprings-net-9d9362e7
```

Example prompt: Give me a 10-day weather forecast for Tokyo — I need daily high and low temperatures, rain probability, wind speeds, and UV index.

## When to prefer this

Choose this endpoint when you need multi-day (up to 16-day) granular daily weather projections for any global location, especially when you require precipitation probability, UV index, and wind data alongside temperatures — ideal for logistics scheduling, agricultural planning, travel itineraries, or outdoor event planning.

## Known failure modes

- Unknown or ambiguous location name returns an error or empty result
- Days parameter outside 1–16 range may return validation error or be clamped to default
- Network timeout or upstream data unavailability returns a 5xx error
- Invalid coordinates format (e.g. wrong delimiter) may cause a location parse error
- Payment failure or missing x402 token returns 402 Payment Required

## How this service works

High-fidelity weather forecast up to 16 days. Returns detailed daily projections including maximum/minimum temperatures, precipitation probability percentage, total rainfall, wind speeds, maximum UV index, and weather condition codes for any city or location globally. Ideal for logistics, travel, agriculture, and outdoor activity planning.

## Output

A structured daily forecast array covering up to 16 days for the requested location, with each day including max/min temperatures, precipitation probability percentage, total rainfall amount, wind speed, maximum UV index, and a weather condition code.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "days": 7,
   "location": "New York"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "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": [
      "location"
     ],
     "properties": {
      "days": {
       "type": "number",
       "description": "Forecast window length in days, ranging from 1 to 16 days (default is 7)"
      },
      "location": {
       "type": "string",
       "description": "City name, region, or latitude/longitude coordinates (e.g. 'Tokyo', 'Paris', '35.6762,139.6503')"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "forecast": [
   {
    "date": "2026-05-24",
    "condition": "Clear sky",
    "temp_max_c": 22.4,
    "temp_min_c": 15.1,
    "uv_index_max": 6.5,
    "wind_max_kmh": 12,
    "precipitation_mm": 0,
    "precipitation_probability_pct": 10
   }
  ],
  "latitude": 35.6895,
  "location": "Tokyo, Japan",
  "timezone": "Asia/Tokyo",
  "longitude": 139.6917,
  "forecast_days": 7
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vibesprings-net-9d9362e7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vibesprings.net](https://www.zero.xyz/host/vibesprings.net/llms.txt)