Octolens API
API by Octolens · rest
The Octolens API lets you query mentions, manage keywords, and configure feeds programmatically. Every action available in the Octolens UI is available here. Authentication Public v2 endpoints require an API key. Create one in Settings > API and pass it as Authorization: Bearer <key>. Keys are scoped to the organization they were minted in; you cannot access another org's data. Internal UI endpoints (x-internal: true) require a member session in the active workspace instead, and a trusted browser origin for writes. API keys carry a scope — read, write (implies read), or admin (implies write). Each endpoint documents the scope it needs via the x-required-scope OpenAPI extension and the scope badge in the docs surface. Rate limiting The v2 API is rate-limited at 500 requests per hour per organization, across all keys for that org. The limit resets at the top of each clock hour (fixed hourly window — the counter is keyed by the UTC hour bucket, not a…
Endpoint: https://app.octolens.com/
Verification: observed. Source: crawl.
Capabilities (117)
- Agency overview
- Invite members to workspaces
- Remove a member from workspaces
- List agency workspaces
- Create an agency workspace
- Get an agency workspace
- Update workspace limits / flex
- Delete an agency workspace
- List workspace members
- Convert natural language to filters
- Recommend monitoring settings from search history
- Share of mentions by one dimension
- Composite dashboard overview
- Per-keyword breakdown
- Sentiment distribution
- Sentiment breakdown per keyword
- Share of voice: your brand vs competitors
- Source/platform breakdown
- Period summary vs the prior period
- Top keywords by volume with High-relevance share
- Top sources by volume with High-relevance share
- Mention volume over time
- Volume over time (day / week / month optional split)
- Build an app deep link
- List attention items