Returns mentions scoped to the authenticated organization. Filter by keyword, source, sentiment, date range, or custom filter groups.
Body shape matches POST /api/v1/mentions exactly — simple or advanced filters object, view to reuse a feed’s filters, includeAll to toggle low-relevance, cursor pagination via limit + cursor.
Tip: call POST /api/v2/ai/filter-wizard with a natural-language prompt to get a ready-to-paste filters object.
Documentation Index
Fetch the complete documentation index at: https://octolens.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Clerk API key. Create one in Settings → API Keys. Pass as Authorization: Bearer <key>.
Filter and paginate mentions. Either provide view to reuse an existing feed's filters, or supply filters directly (or both - they merge). Body shape matches v1 /api/v1/mentions so v1 clients can reuse the same request bodies. Date ranges live inside filters.startDate / filters.endDate (ISO 8601).
Feed/view ID to reuse as a base filter. If filters is also provided, the two are merged (view's saved filters + inline filters both apply).
x <= 9007199254740991Filter object. Accepts the simple flat form ({ source: ["twitter"], sentiment: ["positive"] }) or the advanced group form with AND/OR operators. Use POST /api/v2/ai/filter-wizard to generate one from natural language.
When true, includes low-relevance mentions (internal relevanceScore = 2). Default false returns only high and medium relevance (scores 0 and 1).
Page size, 1-100.
1 <= x <= 100Opaque cursor from a previous response's pagination.nextCursor.