# Klymax402 Vector Search API

> Klymax402 Vector Search API is a paid API for AI agents from vector-search.api.klymax402.com, paid per call via x402, $0.012/call, status unknown (last checked 2026-09-16).

Indexes text documents and retrieves the most semantically similar results for a given query using vector embeddings

## Facts

- Endpoint: GET https://vector-search.api.klymax402.com/api/search
- Price: $0.012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/klymax402-vector-search-api-da570e58
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mfXhf6lJ3GX1RBW47IjC0

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 klymax402-vector-search-api-da570e58
```

Example prompt: Search these five product descriptions — 'noise-cancelling headphones with 30hr battery', 'wireless earbuds for sport', 'over-ear studio monitor headphones', 'budget wired earphones', 'Bluetooth speaker with bass boost' — and return the top 2 most similar to 'headphones for long work-from-home sessions', using namespace 'products'.

## When to prefer this

Choose this endpoint when you need to search a custom, ad-hoc set of documents by semantic meaning rather than keyword matching, especially when the document set is provided at query time or scoped to a session/namespace. Prefer this over full-text search when the user's query intent matters more than exact word overlap, and when you need to rank results by conceptual similarity rather than lexical frequency.

## Known failure modes

- Query string missing — returns 400 bad request
- topK exceeds max of 10 — clamped or rejected
- No documents provided and no prior session documents — returns empty results or error
- Namespace not found — returns empty result set
- Payment not completed — returns 402 payment required
- Network timeout on large document arrays

## How this service works

Store text and search by semantic similarity

## Output

Returns the top-K text documents from the indexed set that are most semantically similar to the query, ranked by similarity. Typically includes the matched document text and relevance scores.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "topK": {
   "type": "number",
   "description": "Number of top results to return (default: 3, max: 10)"
  },
  "query": {
   "type": "string",
   "description": "The text query to search for"
  },
  "documents": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Array of text documents to index (optional if already stored in this session)"
  },
  "namespace": {
   "type": "string",
   "description": "Namespace to isolate document sets (default: 'default')"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/klymax402-vector-search-api-da570e58/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vector-search.api.klymax402.com](https://www.zero.xyz/host/vector-search.api.klymax402.com/llms.txt)