Access & quotas

In Account API keys, enable Metadata, Files, or Research on your existing key. Activation does not replace the secret or grant a higher tier. Select the relevant use case when applying for higher limits; approved increases apply to that use case.

Authenticated quotas are tracked per key and use case. Research calls that use Scholar or CEDOA also consume Metadata or Files quotas. Effective limits depend on the key and approved tier; check account settings and response headers instead of assuming a fixed allowance.

Public metadata reads also support anonymous and contact-address (mailto) traffic. Those lower limits do not grant Files or MCP access. Research additionally allows only one active tool invocation per account, and external provider capacity limits still apply.

X-RateLimit-Limit / X-RateLimit-Remaining

Daily request allowance and remaining requests.

X-RateLimit-Reset

Seconds until the limiting window resets.

X-RateLimit-Burst / X-RateLimit-Burst-Remaining

Per-second allowance and remaining requests.

X-RateLimit-Minute

Per-minute allowance when configured, including Research tiers.

X-RateLimit-Use-Case

The authenticated use case charged for this request.

Retry-After

Wait at least this many seconds before retrying a rate-limited request.

• 401: check the key and account status.
• 403: enable the required use case.
• 429: respect Retry-After and reduce concurrency or request an appropriate quota increase.
• 503: authentication or the service may be unavailable; retry later.

View recorded activity in Account usage. For current activation and effective quotas, use Account API keys.