Public agent API

Agent Cookbook

Boring crawl instructions for archive entries, entities, corpus records, changes, schemas, and search. This layer exposes public authorship, provenance, licensing, citation, and reuse fields, and excludes private/internal data.

API manifest
About / author
Authors JSON
Reuse Policy
Corpus manifest
Corpus JSONL
Corpus chunks
Delta JSONL
Changes JSON
Search JSON

Crawl Flow

  1. Fetch /api/manifest.json for route patterns and schema URLs.
  2. Fetch /corpus/manifest.json, then /corpus.jsonl for full ingest.
  3. Fetch /corpus/chunks.jsonl when chunked text is useful.
  4. For updates, fetch /changes.json?since=YYYY-MM-DD and /corpus/delta.jsonl?since=YYYY-MM-DD.
  5. For a single archive entry, fetch its human, JSON, Markdown, and share package URLs from the manifest patterns.

Example Commands

curl https://vietphanx.com/api/manifest.json
curl https://vietphanx.com/corpus.jsonl
curl 'https://vietphanx.com/corpus/delta.jsonl?since=2026-01-01'
curl 'https://vietphanx.com/search.json?q=field%20log'