Step-by-step guide
User API and keys
A Premium user can create a least-privilege key and read implemented NewsHub API v1 endpoints. The secret is shown once.
Before you start
- Have active Premium and a secure place for the secret.
Steps
- Open API and choose recommended scopes.
- Create a key and immediately save it in a secret manager.
- Run the shown curl to /api/v1/posts?limit=3&include=summary,topics.
- Revoke a key exposed to logs, chat, or browser storage.
Expected result
A Bearer request returns only your account data allowed by its scopes.
Important limitations
- A key cannot be recovered after closing; raw text requires include=raw.
If it did not work
- 401: Bearer/key; 403: Premium/scope; 429: follow Retry-After.