# getrandomness

> Lean, agent-digestible curated randomness. Each request returns one prepared item from a curated corpus.

All endpoints support GET and HEAD. Public reads are CORS-enabled.

## Choose an access method

### Using curl or code

Call a JSON endpoint listed under Endpoints. Repeat the same request for each independent draw. These endpoints send Cache-Control: no-store.

### Using a web-search or browsing tool

If the tool can open links from fetched pages, use a web-search staging page. Web-search tools may cache responses by URL.

- [/web-search/wikipedia](https://getrandomness.com/web-search/wikipedia)
- [/web-search/font-pair](https://getrandomness.com/web-search/font-pair)
- [/web-search/palette](https://getrandomness.com/web-search/palette)

Use a programmatic random-number generator to choose an integer from 0 through 999. Write it as three digits, adding leading zeroes if needed, then follow the digits in order. The number selects a URL; it does not seed or determine the result.

The three-digit page contains the result as JSON with exactly four next_draws paths and four numbered links. For each additional draw, follow a next_draws URL you have not used before. Using another path guarantees a different URL, not a different corpus item: each draw is independent and may return the same item by chance.

Path tokens identify URLs. They do not seed selection or make responses repeatable. The stable endpoints are the only JSON API surface; /web-search and /draw are linked browsing surfaces.

## Endpoints

- [/wikipedia](https://getrandomness.com/wikipedia): Random Wikipedia page as Markdown in a JSON response.
- [/wikipedia/info](https://getrandomness.com/wikipedia/info): Details of the /wikipedia response fields and size limit.
- [/font-pair](https://getrandomness.com/font-pair): Coherent heading + body font pair.
- [/font-pair/info](https://getrandomness.com/font-pair/info): Details of the /font-pair response fields.
- [/palette](https://getrandomness.com/palette): Coherent five-color palette as hex values.
- [/palette/info](https://getrandomness.com/palette/info): Details of the /palette response fields and optional reference color.

## Machine-readable docs

- [/openapi.json](https://getrandomness.com/openapi.json): OpenAPI 3.1 description of the public API.

## Source

- [getrandomness-server](https://github.com/afolkest/getrandomness-server): Public server code and development sample corpora.