Authentication
All API requests require a valid API key in the Authorization header.
Getting your API key
- Go to Settings > API in the Finseo dashboard
- Click Create API Key
- Choose a name, scopes, and optionally restrict to specific projects
- Copy the key immediately - it will only be shown once
Using your key
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://app.finseo.ai/api/v1/projects
Scopes
API keys can have one or more scopes:
| Scope | Description |
|---|
read | Read data (projects, prompts, metrics, competitors, sources) |
write | Modify data (create prompts, update tags, manage projects) |
export | Bulk export tracking data |
Project restrictions
Optionally restrict a key to specific projects. A key with no project restrictions can access all projects owned by your account.
Key security
Never expose API keys in client-side code or public repositories.
- Keys are hashed with SHA-256 before storage - we never store plaintext
- Rotate keys regularly and revoke compromised keys immediately
- Use test keys for development, live keys for production
