# Vibe Springs Travel Brief API

> Vibe Springs Travel Brief API is a paid API for AI agents from vibesprings.net, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns a combined travel intelligence brief for a city including weather forecast, air quality, upcoming public holidays, and local currency exchange rates in a single call.

## Facts

- Endpoint: GET https://vibesprings.net/api/travel-brief
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vibe-springs-travel-brief-api-74844b80
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fgvpGKCS8_UeqhfKOULxz

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 vibe-springs-travel-brief-api-74844b80
```

Example prompt: Give me a travel brief for Paris — I need the weather forecast, air quality, any upcoming French public holidays, and EUR exchange rates against USD.

## When to prefer this

Choose this endpoint when you need a single aggregated travel intelligence snapshot for a city — combining weather, air quality, holidays, and FX in one $0.02 call — rather than making four separate API calls to different services. Ideal for travel planning assistants, itinerary builders, or any agent that needs to contextualise a destination before giving advice. Requires no API keys or accounts, just x402 micropayment capability on Base.

## Known failure modes

- Unknown or ambiguous location name returns an error or empty location object
- Invalid or unsupported currency ISO code may fall back to USD
- No upcoming holidays if the country code cannot be resolved or has no scheduled holidays
- Network timeout from upstream providers (Open-Meteo, Frankfurter) may delay or partially fail the response
- x402 payment failure (insufficient USDC balance or unsupported wallet) results in 402 status with no data returned

## How this service works

Complete destination intelligence in one call. Geocodes any city or location then fetches 7-day weather forecast, current air quality index, upcoming public holidays, and local currency FX rates — all in parallel. Ideal for travel planning agents, itinerary builders, and event schedulers.

## Output

A JSON object containing: a multi-day weather forecast (temp, precipitation, UV index, wind speed, condition), current air quality metrics (AQI label, PM2.5, PM10, CO), upcoming public holidays for the country, local currency FX rates against a base currency, resolved location details (name, coordinates, timezone), and source attribution — all in a single response with processing time.

## 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": {
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2 country code for holidays (e.g. FR, US, JP). Auto-detected from location if omitted."
      },
      "currency": {
       "type": "string",
       "description": "Local currency ISO code for FX rates (default: USD)"
      },
      "location": {
       "type": "string",
       "description": "City or place name to look up (e.g. 'Paris', 'New York', 'Tokyo')"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fx": {
   "base": "USD",
   "date": "2026-06-21",
   "rates": {
    "EUR": 0.92,
    "GBP": 0.79,
    "JPY": 157.5
   }
  },
  "sources": [
   "Weather Forecast",
   "Air Quality Index",
   "Nager.Date",
   "ECB via Frankfurter"
  ],
  "forecast": [
   {
    "date": "2026-06-21",
    "uvIndex": 7,
    "windKph": 18,
    "precipMm": 0.2,
    "tempMaxC": 26,
    "tempMinC": 16,
    "condition": "Partly cloudy",
    "precipProbPct": 20
   }
  ],
  "location": {
   "name": "Paris, Île-de-France, France",
   "country": "France",
   "latitude": 48.85,
   "timezone": "Europe/Paris",
   "longitude": 2.35,
   "countryCode": "FR"
  },
  "airQuality": {
   "pm10": 14.1,
   "pm2_5": 8.2,
   "aqiLabel": "Fair",
   "europeanAqi": 32,
   "carbonMonoxide": 210
  },
  "processingTime": "380ms",
  "upcomingHolidays": [
   {
    "date": "2026-07-14",
    "name": "Fête Nationale",
    "type": "Public"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vibe-springs-travel-brief-api-74844b80/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)