Changelog

• Domain vocabulary published at /vocabulary.yaml and an OpenAPI overlay at /overlay.yaml: the overlay adds the two authentication headers and response shapes taken from live calls, so a client generated from the specification works without edits.
• Onboarding descriptor published at /.well-known/api-onboarding: plans, credentials and a three-step first call, machine-readable.
• Free plan lookups moved onto the monthly budget — 2,500 a month, the same number as the request count, with no separate daily cap.
• Cookbook published at /cookbook: four recipes on the feed endpoint, every output captured from the live API.
• OpenAPI specification published at /openapi.json, and /quickstart added with full request-and-response examples.
• The error envelope and all seven of its codes documented on /docs.
• Terms, privacy policy and vulnerability disclosure policy published, with /.well-known/security.txt alongside them.

• Machine-readable descriptors published: apis.json for API catalogues and llms.txt for language models.
• Plan prices and quotas on /pricing brought in line with the live listing.

Breaking changes to the API are announced here before they ship. The specification at /openapi.json is the contract; if a field is in it, it stays in it.

New endpoints and new fields arrive without notice, because adding them cannot break your code.