How do I use the public REST API?

Bearer-token auth at /api/v1/* for embedding audit + citation data in your own dashboards.

Intermediate Last updated 3 May 2026

On Pro and Agency tiers, /app/api-tokens lets you create scoped bearer tokens. Pick a name (e.g. "Acme client dashboard"), tick the scopes you need (audit:read, sites:read, prompts:read, citations:read), and copy the token - we only show it once.

Use the token like:

  1. curl -H "Authorization: Bearer lls_..." https://llmsubmitter.com/api/v1/me
  2. curl -H "Authorization: Bearer lls_..." https://llmsubmitter.com/api/v1/sites
  3. curl -H "Authorization: Bearer lls_..." https://llmsubmitter.com/api/v1/citations?limit=20

Every endpoint is paginated via ?limit (max 100) and ?offset. Tokens are stored as sha256 hashes only; if you lose one, revoke it and create another.

Was this helpful?