Onagio publishes a small read-only HTTP API. There is no signup, no API key, no rate limit, and no billing. You can call it right now from a terminal.

curl https://onagio.com/api/cheeses

Why this exists

Increasingly the thing asking about our cheese is not a person browsing a website. It is an assistant answering someone who said "find me a well-aged parmesan from Parma and tell me if it is in stock." That software cannot read a hero image. It can read JSON.

So the three wheels, their prices, their current stock, their lead times, and the tour schedule are all available as structured data. The alternative was hoping a crawler correctly parsed the words off a page with a parallax background, and we did not like our odds.

Everything you need

/openapi.json — OpenAPI 3.1 specification. Every operation has a unique operationId, typed parameters, and response schemas, so it drops straight into a function-calling tool definition.
/docs — endpoint reference with worked examples.
/llms.txt — plain-text summary of the company and when to reach for us.
/api — the service index, if you would rather discover it by hand.

Ground rules

GET only. Anything else returns 405. The API is read-only by design. Orders go to wholesale@onagio.com and are handled by a person.
No authentication. There is nothing private here. It is a public catalogue for a company that makes 200 wheels a month.
CORS is open. Access-Control-Allow-Origin: * on every response.
Caching. Five minutes on catalogue data, one minute on availability. Respect the headers and we will never need a rate limit.
Errors are JSON. Always. Match on error.code, never on the message text.

Command line

There is a CLI in the cli/ directory of the website repository. It wraps the same endpoints so you can check stock without writing a fetch call.

npx onagio cheeses
npx onagio stock ONG-MANIFESTO-48
npx onagio pairings ONG-LETTERA-36
npx onagio typewriters --working

Stability

The API is at 1.2.0. SKUs are stable and will not be reissued. Fields get added, never removed or retyped, and if that ever changes the version goes to 2 and the old one keeps serving for a year. We are a cheese company. We are not going to deprecate anything on a quarterly cadence.

Support

api@onagio.com. It reaches Ari, who has a mechanical engineering degree and wrote this API himself over two winters. Response times are better than you would expect except during the second week of August, when they are infinite.