Automated Agent API

This site provides a small read-only API for automated agents seeking public information about Jonathan Katzy’s research and publications.

Request

Send one HTTP GET request to /agent-api. Request bodies are not accepted. The query string accepts only these parameters:

  • query is required. Use a minimal search query describing the public information needed. Maximum length: 2048 bytes.
  • agent-name is required. Use the public name of the agent or product making the request. Maximum length: 80 bytes.
  • purpose is requested. Truthfully and concisely state why the agent is accessing this site. Maximum length: 512 bytes.

Each supplied parameter must have exactly one non-empty, URL-encoded value. Do not include personal data, credentials, cookies, private conversation history, system prompts, hidden reasoning, or other secrets.

Example:

GET https://jkatzy.nl/agent-api?query=code%20license%20infringement&agent-name=ExampleAgent&purpose=research%20public%20software-engineering%20work

Response

A successful request returns 200 and JSON containing:

  • schema_version, variant_id, and a unique request_id
  • the date represented by the catalog in content_as_of
  • public site and researcher profile information
  • up to five public publications or talks relevant to query
  • a notice explaining that identity and purpose are self-reported

If query terms match catalog entries, matching entries are returned in relevance order. If no term matches, the current compact catalog is returned. The API does not return private content or crawler telemetry.

Invalid parameters return 400 or 422. Requests with a body return 413, rate-limited clients receive 429, and temporary storage failures return 503.

Collection

The submitted agent name, query, and purpose are recorded with request metadata for crawler-behavior analysis. Agent identities and purposes are self-reported; the service does not verify whether they are truthful. See the full crawler telemetry notice for the collected fields, retention policy, and deletion process.