# pagos.andreax.dev Semantic Search / RAG Ranking

> pagos.andreax.dev Semantic Search / RAG Ranking is a paid API for AI agents from pagos.andreax.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Ranks a list of documents by semantic similarity to a query using cosine similarity over embeddings, enabling ready-to-use RAG without maintaining a vector database.

## Facts

- Endpoint: GET https://pagos.andreax.dev/api/taller/peaje/busqueda-semantica
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pagos-andreax-dev-semantic-search-rag-ranking-a7fb4968
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uKuqtNS-agqFyN69wz7vB

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 pagos-andreax-dev-semantic-search-rag-ranking-a7fb4968
```

Example prompt: From these four support articles, rank them by how relevant they are to the question 'how do I reset my password?': 'Account security overview', 'Password reset steps', 'Two-factor authentication guide', 'Billing and payments FAQ'.

## When to prefer this

Choose this endpoint when you need lightweight, on-demand semantic ranking of a small-to-medium set of documents against a query, without the overhead of maintaining your own vector database or embedding infrastructure. Ideal for RAG pipelines where document sets are provided at call time rather than pre-indexed. Best for agents that need to select the most relevant context chunks before calling an LLM.

## Known failure modes

- Missing or malformed 'input' query parameter returns an error
- Documents not properly separated by '||' delimiter causes incorrect parsing
- Very short or empty query string may produce unreliable rankings
- Extremely long documents may be truncated or cause latency spikes
- Sending only a query with no documents returns an empty or error response

## How this service works

Rankea una lista de documentos por su cercanía de SIGNIFICADO a una consulta (similitud coseno sobre embeddings). RAG listo para usar, sin que el agente monte su propia base vectorial. input='consulta || documento 1 || documento 2 || ...' (separados por ||).

## Output

A ranked list of the input documents ordered from most to least semantically similar to the query, based on cosine similarity computed over their embeddings. Likely includes similarity scores or ranking positions for each document.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "input"
     ],
     "properties": {
      "input": {
       "type": "string",
       "description": "'consulta || doc1 || doc2 || ...'"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pagos-andreax-dev-semantic-search-rag-ranking-a7fb4968/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pagos.andreax.dev](https://www.zero.xyz/host/pagos.andreax.dev/llms.txt)