# Aayat AI Library Research

> Aayat AI Library Research is a paid API for AI agents from aayatai.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-29).

Returns a structured research report for an npm, PyPI, Rust crates, or Go module package including safety, documentation, repository health, and goal-specific usage guidance

## Facts

- Endpoint: GET https://aayatai.com/library/research?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aayat-ai-library-research-9213e04f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__cxiXlAdqKVvXU51hbhUl

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 aayat-ai-library-research-9213e04f
```

Example prompt: Can you research the hono npm package for me — I want to use it to stream server-sent events — and tell me if it's safe, what version it's on, and show me how to actually do it with code examples?

## When to prefer this

Use this endpoint when a coding agent or developer needs a comprehensive, cited, one-call research brief on a software library — combining safety analysis, repository health, documentation lookup, and goal-specific usage guidance — without needing to query npm, PyPI, GitHub, and docs sites separately. Prefer it over raw package registry APIs when you want an opinionated safety verdict plus usage-ready Markdown with citations in a single pay-per-call request.

## Known failure modes

- Unknown package name returns an error or empty result
- Unsupported ecosystem value rejected by schema validation
- Package exists but has no public documentation leading to sparse report
- Network timeout fetching live documentation or repository data
- Goal string too long (over 200 chars) causes validation rejection

## How this service works

Pay-per-use data and tools for AI agents: crypto token safety, prices and wallets, an LLM gateway, web search and documents to Markdown, library docs, package safety and AI model prices for coding agents, company research, news, UK/EU open data and an x402 market guide. Pay per call in USDC on Base or Solana with x402. No account or API key.

## Output

A JSON object containing: a Markdown research report with numbered citations, a safety object with verdict, score, flags, and licences, the latest version string, a repository health summary with stars and last push date, scraped documentation excerpts with token counts, and an array of cited sources with URLs, kinds, and titles.

## 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",
     "required": [
      "library"
     ],
     "properties": {
      "goal": {
       "type": "string",
       "maxLength": 200,
       "description": "What you want to do with it, e.g. stream server-sent events (default: overview)."
      },
      "library": {
       "type": "string",
       "maxLength": 214,
       "minLength": 1,
       "description": "Package name, e.g. hono, fastapi, tokio."
      },
      "ecosystem": {
       "enum": [
        "npm",
        "pypi",
        "crates",
        "go"
       ],
       "type": "string",
       "default": "npm",
       "description": "Package ecosystem: npm, pypi, crates (Rust) or go (Go modules)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "library",
      "report",
      "sources"
     ],
     "properties": {
      "docs": {
       "type": [
        "object",
        "null"
       ]
      },
      "goal": {
       "type": [
        "string",
        "null"
       ]
      },
      "trust": {
       "type": "object",
       "description": "Third-party text, cleaned: read trust.notice; removed = what we stripped."
      },
      "report": {
       "type": "string",
       "description": "Markdown brief with [n] citations into sources."
      },
      "safety": {
       "type": [
        "object",
        "null"
       ]
      },
      "library": {
       "type": "string"
      },
      "sources": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "n": {
          "type": "integer"
         },
         "url": {
          "type": "string"
         },
         "kind": {
          "type": "string"
         },
         "title": {
          "type": "string"
         }
        }
       }
      },
      "version": {
       "type": [
        "string",
        "null"
       ]
      },
      "ecosystem": {
       "type": "string"
      },
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "docs": {
   "tokens": 1500,
   "sources": [
    {
     "url": "https://hono.dev/docs/middleware/builtin/cors",
     "kind": "docs-page"
    }
   ]
  },
  "goal": "enable CORS",
  "report": "## Summary\nHono 4.13.9 is a small web framework ... safe to adopt [1].\n\n## How to do the goal\n```ts\napp.use('/api/*', cors())\n```\n[1]\n\n## Gotchas\n- ... [2]",
  "safety": {
   "flags": [],
   "score": 100,
   "verdict": "ok",
   "licences": [
    "MIT"
   ]
  },
  "library": "hono",
  "sources": [
   {
    "n": 1,
    "url": "https://hono.dev/docs/middleware/builtin/cors",
    "kind": "docs",
    "title": "docs-page"
   },
   {
    "n": 2,
    "url": "https://stackoverflow.com/q/1",
    "kind": "stackoverflow",
    "title": "Hono CORS not working with credentials"
   }
  ],
  "version": "4.13.9",
  "ecosystem": "npm",
  "repository": {
   "url": "https://github.com/honojs/hono",
   "stars": 32361,
   "verdict": "healthy",
   "lastPushAt": "2026-09-27T03:11:53Z"
  },
  "researchedAt": "2026-09-28T12:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aayat-ai-library-research-9213e04f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aayatai.com](https://www.zero.xyz/host/aayatai.com/llms.txt)
