# Veyrly Web Evidence API

> Veyrly Web Evidence API is a paid API for AI agents from api.veyrly.com, paid per call via x402, $0.015/call, status unknown (last checked 2026-09-14).

Returns validated, multi-source web evidence packs answering a research query, with source citations, freshness metadata, and validation status.

## Facts

- Endpoint: POST https://api.veyrly.com/v1/evidence
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/veyrly-web-evidence-api-6655afde
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_i99l9qyV2G7Kgm7qMAY-m

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 veyrly-web-evidence-api-6655afde -d '<json body>'
```

Example prompt: Can you pull validated multi-source web evidence on whether the EU AI Act has come into full effect yet — I need at least 5 sources and they should all be from the last 90 days (7776000 seconds)?

## When to prefer this

Choose Veyrly when an agent needs corroborated, multi-source web evidence with explicit validation flags and timestamped provenance — especially in agentic workflows where a single-source answer is insufficient or where freshness guarantees must be documented. Prefer it over generic search APIs when the output must carry a 'validated: true' evidence attestation and structured source metadata suitable for downstream reasoning or audit trails.

## Known failure modes

- Insufficient sources found: fewer than 3 validated distinct sources available for the query
- Freshness requirement unsatisfied: newest available source older than requested freshness_seconds
- Query too vague or ambiguous to retrieve relevant evidence
- Rate limiting or payment failure via x402 protocol
- Timeout if query requires crawling slow or unavailable pages

## How this service works

Validated multi-source web evidence packs for autonomous agents.

## Output

A fulfilled evidence pack containing a direct answer string, an array of 3–10 validated source objects (each with title, URL, snippet, and publication/update timestamps), an evidence block confirming source count and validation status, a freshness block indicating whether the freshness requirement was met and the newest source timestamp, a UUID request ID, and a fulfillment timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "query": {
   "type": "string",
   "description": "Web evidence question or research query."
  },
  "max_sources": {
   "type": "integer",
   "description": "Maximum number of validated sources returned."
  },
  "freshness_seconds": {
   "type": "integer",
   "description": "Optional maximum evidence age. Freshness is enforced only when requested."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "status",
  "query",
  "answer",
  "sources",
  "freshness",
  "evidence",
  "fulfilled_at",
  "request_id"
 ],
 "properties": {
  "query": {
   "type": "string"
  },
  "answer": {
   "type": "string"
  },
  "status": {
   "const": "fulfilled"
  },
  "sources": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "title",
     "url",
     "snippet",
     "published_at",
     "updated_at"
    ],
    "properties": {
     "url": {
      "type": "string",
      "format": "uri"
     },
     "title": {
      "type": "string"
     },
     "snippet": {
      "type": "string"
     },
     "updated_at": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "published_at": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     }
    },
    "additionalProperties": false
   },
   "maxItems": 10,
   "minItems": 3
  },
  "evidence": {
   "type": "object",
   "required": [
    "source_count",
    "distinct_source_count",
    "validated"
   ],
   "properties": {
    "validated": {
     "const": true
    },
    "source_count": {
     "type": "integer",
     "minimum": 3
    },
    "distinct_source_count": {
     "type": "integer",
     "minimum": 1
    }
   }
  },
  "freshness": {
   "type": "object",
   "required": [
    "required",
    "satisfied",
    "newest_timestamp"
   ],
   "properties": {
    "required": {
     "type": "boolean"
    },
    "satisfied": {
     "type": "boolean"
    },
    "newest_timestamp": {
     "type": [
      "string",
      "null"
     ],
     "format": "date-time"
    }
   }
  },
  "request_id": {
   "type": "string",
   "format": "uuid"
  },
  "fulfilled_at": {
   "type": "string",
   "format": "date-time"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/veyrly-web-evidence-api-6655afde/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.veyrly.com](https://www.zero.xyz/host/api.veyrly.com/llms.txt)