Get started

Authentication

Create an API key from the dashboard and pass it as a bearer token. Keys are scoped to your account and can be revoked at any time.

HTTP header

Authorization: Bearer YOUR_STORMY_API_KEY

X-API-Key: YOUR_STORMY_API_KEY is also accepted.

Key rules

Never put an API key in a URL, request body, prompt, or MCP tool argument — only in the HTTP header.
Free keys carry the social:read scope: cached data only, 50 results per rolling 30 days.
Paid keys add social:fresh and email:find for live provider calls and verified email lookup.
Revoking a key takes effect immediately. Creating a new key never resets free-tier limits — they are account-scoped.