# Vibe Springs Competitor Analysis API

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

Finds the closest competitor listings by tag overlap and semantic token similarity, returning pricing, call counts, payers, and market rank for a given resource URL or merchant address.

## Facts

- Endpoint: GET https://vibesprings.net/api/trends/competitors
- Price: $0.5/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-competitor-analysis-api-2a8669b5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rteBuzBV-wa04FENaXV6i

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-competitor-analysis-api-2a8669b5
```

Example prompt: What are the top 10 competitors for my listing at https://vibesprings.net/api/trends — show me their pricing, call counts, and where I rank in the market?

## When to prefer this

Use this endpoint when you need to understand the competitive landscape for a specific x402 API listing — particularly useful for API developers wanting to benchmark their pricing, gauge demand relative to peers, or discover semantically similar services competing for the same agent queries. Prefer this over generic web search when you need structured, quantitative competitive data (calls, payers, pricing) from within the x402 ecosystem.

## Known failure modes

- Missing required resource or payTo parameter returns a 400 error
- Invalid or unrecognized resource URL returns empty competitors list
- limit out of range (below 1 or above 25) returns a validation error
- Payment not included or insufficient triggers x402 payment required response
- Merchant address not found in index returns empty result set

## How this service works

Finds the closest competitor listings by tag overlap and semantic token similarity. Returns pricing, calls, and payers for each competitor along with the query resource's market rank.

## Output

A list of up to 25 competitor listings ranked by tag overlap and semantic similarity to the queried resource, each with their pricing, total call counts, number of unique payers, and the queried resource's market rank among them.

## 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",
     "properties": {
      "limit": {
       "type": "integer",
       "description": "Max competitors to return (1-25, default 10)"
      },
      "payTo": {
       "type": "string",
       "description": "Merchant payTo address to analyze"
      },
      "resource": {
       "type": "string",
       "description": "Listing resource URL to analyze for competitors"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": {
   "resource": "https://vibesprings.net/api/forecast"
  },
  "competitors": [
   {
    "price": 0.002,
    "domain": "competitor.io",
    "calls30d": 5000,
    "resource": "https://competitor.io/weather/current",
    "payers30d": 150,
    "sharedTags": [
     "Weather / Environment"
    ],
    "similarityScore": 0.85
   }
  ],
  "marketPosition": {
   "rank": 3,
   "percentileByCalls": 80,
   "percentileByPayers": 75
  },
  "processingTime": "52ms"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vibe-springs-competitor-analysis-api-2a8669b5/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)