# Vibe Springs API Discovery & Search

> Vibe Springs API Discovery & Search is a paid API for AI agents from vibesprings.net, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Search and filter available x402 pay-per-query API endpoints by keyword, category, or maximum price

## Facts

- Endpoint: GET https://vibesprings.net/api/infra/discover
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vibe-springs-api-discovery-search-48139bcf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YRu25gXuxJB7ontfLsInV

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-api-discovery-search-48139bcf
```

Example prompt: Search the Vibe Springs service catalog for any available endpoints in the 'weather' category that cost no more than 0.01 USDC each.

## When to prefer this

Use this endpoint when an AI agent needs to dynamically discover what pay-per-query APIs are available on the Vibe Springs platform, especially to find the right tool for a task, stay within a budget constraint, or enumerate services by domain category before deciding which to call.

## Known failure modes

- No endpoints match the given keyword or category — returns empty results
- max_price filter too restrictive — filters out all available endpoints
- Invalid category string — may return empty or unfiltered results
- Network or service downtime — HTTP 5xx error

## How this service works

Agent service discovery and search endpoint. Search and filter available x402 API endpoints by category, maximum query price, or keyword matches.

## Output

A filtered list of available x402 API endpoints matching the query, including their names, descriptions, categories, and per-call pricing in USDC.

## 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": [],
     "properties": {
      "q": {
       "type": "string",
       "description": "Search keyword"
      },
      "category": {
       "type": "string",
       "description": "Filter category"
      },
      "max_price": {
       "type": "string",
       "description": "Max price in USDC"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "weather",
  "category": null,
  "services": [
   {
    "name": "Historical Weather",
    "category": "data/weather",
    "endpoint": "https://vibesprings.net/api/weather",
    "price_usdc": 0.002,
    "description": "..."
   }
  ],
  "max_price": 0.01,
  "checked_at": "2026-06-26T20:00:00.000Z",
  "total_found": 2,
  "processingTime": "85ms"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vibe-springs-api-discovery-search-48139bcf/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)
