Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.finseo.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

All API requests require a valid API key in the Authorization header.

​
Getting your API key

  1. Go to Settings > API in the Finseo dashboard
  2. Click Create API Key
  3. Choose a name, scopes, and optionally restrict to specific projects
  4. Copy the key immediately - it will only be shown once

​
Using your key

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.finseo.ai/v1/projects

​
Scopes

API keys can have one or more scopes:
ScopeDescription
readRead data (projects, prompts, metrics, competitors, sources)
writeModify data (create prompts, update tags, manage projects)
exportBulk 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