# apis.directory

> The apis.ax public directory — every agent-legible API, one browsable face.

apis.directory is an App on **apps.ax** — the multi-tenant interpreter. ONE typed
Listing Definition renders every face — the JSON API, the faceted HTML directory
(human register), and the markdown-of-live-state twin (agent register) — from the
same live state, selected BY HOSTNAME. Facets are derived from the Listing type,
not hand-authored.

## Faces

- [Directory (markdown twin)](https://apps.ax/directory?format=md): the live App state as markdown.
- [Directory (HTML)](https://apps.ax/directory?format=html): the designed, faceted human register.
- [API face](https://apps.ax/api/listings): JSON `{ listings, facets, query? }`; supports `?q=<term>` and `?<facet>=<value>`; paginated via `?limit=` (default 200, max 500), `?offset=`.
- [Listing detail](https://apps.ax/listings/:id): one listing, both registers.

## The noun

```
Listing {
  name: string
  summary: string
  url: string?
  category: weather | finance | geo | data | payments   # enum → a derived facet
  provider: ->Provider   # relation → a derived facet
}
```
