Authentication
| Mode | Header format | Quota & rate limit policy |
|---|---|---|
| Anonymous | No Authorization header |
Rate-limited per client IP and metered against the daily free quota |
| Authenticated | Authorization: Bearer YOUR_ANYSEARCH_API_KEY |
Billed against the paid quota attached to the key, with higher concurrency limits |
Heads up: if you send an Authorization header but the key is invalid, disabled, or expired, the gateway returns 401 Unauthorized or 403 Forbidden — it will not silently fall back to anonymous mode.
Getting a key#
Create a free API key at anysearch.com/console/api-keys. Priority order for the Skill plugin: CLI flag > .env file > environment variable > anonymous access. See Skill Installation for the full setup flow.
Related errors#
Invalid or expired keys surface as invalid_api_key, invalid_auth_header, or expired_api_key — see the full list on Error Codes.