@fillin/client

TypeScript client for Fillin — search engine for AI agents. Closes the gap between an LLM's training cutoff and now across HN, arXiv, GitHub Releases, and curated RSS, plus daily snapshots of supply-chain CVEs, new research papers, and frontier AI lab releases.

Install

npm install @fillin/client

Quickstart

import { FillinClient } from "@fillin/client";

const fillin = new FillinClient({
  apiKey: process.env.FILLIN_API_KEY!,
});

// Generic post-cutoff vector search across all corpora — $0.01/call
const { results } = await fillin.query({
  cutoff: "2026-01-01",                // your model's training cutoff
  query: "rust async runtime developments",
  k: 5,                                 // 1–20
});

for (const hit of results) {
  console.log(`[${hit.source}] ${hit.title}  ←  ${hit.url}`);
}

Get a bearer key at fillin.glyphapi.dev/signup (20 free queries, no card). For per-call pricing see fillin.glyphapi.dev/pricing.

API

new FillinClient(options)

| Option | Type | Default | Description | |--------------|----------|------------------------------------|------------------------------------------| | apiKey | string | — | Pre-issued bearer key. | | host | string | https://fillin.glyphapi.dev | API base URL. | | timeoutMs | number | 30000 | Per-request abort timeout. | | fetch | function | globalThis.fetch | Inject for testing or custom transports. |

Methods

• query(params) — generic post-cutoff vector search across all corpora. $0.01/call.
• stats() — bearer-gated corpus stats.
• freshness() — public corpus freshness (no auth).
• health() — liveness check (no auth).
• paymentInfo() — public x402 payment surface.

Slice routes (/query/cves $0.02, /query/papers $0.03, /query/frontier $0.05) and /answer ($0.02) ship in the underlying API but aren't yet wrapped in this client. Hit them directly via fetch, or open an issue/PR if you want first-class methods.

Errors

Non-2xx responses throw FillinError carrying .status and .body (truncated to 500 chars).

License

MIT