# Cited Web Answer (RAG) — api.agentstools.dev

> Cited Web Answer (RAG) — api.agentstools.dev is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Answers a natural-language question by searching the public web, reading top pages, and synthesizing a grounded answer with source URLs to minimize hallucination.

## Facts

- Endpoint: GET https://api.agentstools.dev/answer
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cited-web-answer-rag-api-agentstools-dev-1c01b971
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_z20JEzH4bYFxt0brZ3U1z

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 cited-web-answer-rag-api-agentstools-dev-1c01b971
```

Example prompt: Search the web and give me a cited answer to: 'What are the current eligibility requirements for the US Global Entry program?' — use up-to-date sources from the past month and read up to 3 pages.

## When to prefer this

Use this endpoint when you need a factual, verifiable answer to a natural-language question and hallucination risk is a concern — the cited-source design makes it especially suitable for research, fact-checking, and current-events queries. Prefer it over a raw search endpoint when you need a synthesized prose answer rather than a list of headlines or links. Use the timelimit filter when recency matters (e.g. regulatory changes, current events). For pure news monitoring or headline feeds, consider the sibling news-search endpoint instead.

## Known failure modes

- No relevant pages found for the query — returns empty or low-confidence answer
- Timelimit filter too narrow (e.g. 'd') with no fresh indexed pages — no sources returned
- Query is ambiguous or too short — poor quality synthesis with weak citations
- max_sources set to 1 and sole page is paywalled or inaccessible — degraded answer
- Network or upstream search engine timeout — HTTP 5xx or timeout error
- Missing required 'query' parameter — HTTP 400 validation error

## How this service works

Cited answer (RAG): a natural-language question is answered by searching the public web, reading the top pages and synthesizing a grounded answer with a list of source URLs. Answer cites only the retrieved sources (anti-hallucination).

## Output

A synthesized natural-language answer grounded in content retrieved from up to 5 live web pages, accompanied by a list of source URLs that were read to produce the answer. The answer is constrained to information from the retrieved sources, reducing hallucination risk.

## 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": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "description": "The question to answer"
      },
      "region": {
       "type": "string",
       "description": "Locale like 'us-en', 'uk-en' (default us-en)"
      },
      "timelimit": {
       "enum": [
        "d",
        "w",
        "m",
        "y"
       ],
       "type": "string",
       "description": "Freshness filter: past day/week/month/year"
      },
      "max_sources": {
       "type": "integer",
       "maximum": 5,
       "minimum": 1,
       "description": "How many web pages to read (default 3)"
      }
     }
    }
   },
   "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/cited-web-answer-rag-api-agentstools-dev-1c01b971/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)
