Yannis rate limits

The yannis.dev public API is intentionally tiny and read-only, but responses still include rate-limit hints so agents can self-throttle instead of guessing. The default policy is 60 requests per 60 seconds for the public policy.

Successful JSON and MCP responses include RateLimit-Policy and RateLimit. The current policy header is RateLimit-Policy: "public";q=60;w=60. The live quota hint uses RateLimit with r for remaining quota and t for the effective window in seconds. Compatibility headers RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset are also returned because many client libraries still inspect those names.

If a client is throttled, the API returns HTTP 429 with application/problem+json, code rate_limit.exceeded, and Retry-After. Retry-After takes precedence over the RateLimit hint when both are present.

These limits protect a personal site, not a metered product. Cache public documents like /openapi.json , /llms.txt , and /index.md when possible. Email hello@yannis.dev if you are building a crawler that needs a higher documented budget.