Skip to main content
GET
/
api
/
v2
/
mentions
/
by-author
List mentions by author
curl --request GET \
  --url https://app.octolens.com/api/v2/mentions/by-author \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 0,
      "sourceId": "reddit_t3_1abc234",
      "url": "https://reddit.com/r/example/comments/abc123/...",
      "title": "<string>",
      "body": "<string>",
      "source": "reddit",
      "timestamp": "2026-05-06 13:35:37.000",
      "author": "jane.doe",
      "authorName": "<string>",
      "authorAvatar": "<string>",
      "authorUrl": "<string>",
      "authorFollowers": 0,
      "relevance": "relevant",
      "relevanceComment": "<string>",
      "sentiment": "Neutral",
      "language": "en",
      "tags": [
        "competitor_mention",
        "pricing"
      ],
      "keywords": [
        {
          "id": 42,
          "keyword": "social listening"
        }
      ],
      "engaged": true,
      "relevanceScore": 123,
      "feedbackRelevant": 123,
      "imageUrl": "<string>",
      "keywordId": 123
    }
  ],
  "pagination": {
    "nextCursor": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Clerk API key. Create one in Settings → API Keys. Pass as Authorization: Bearer <key>.

Query Parameters

source
enum<string>
required

Platform to scope the lookup to. One of: twitter, reddit, bluesky, dev, github, hackernews, tiktok, linkedin. Display-name-only platforms (youtube, stackoverflow, news, newsletter, podcasts) are not supported — the author there isn't a unique handle.

Available options:
twitter,
reddit,
bluesky,
dev,
github,
hackernews,
tiktok,
linkedin
handle
string

The author's handle/username on source (the handle platforms: twitter, reddit, bluesky, dev, github, hackernews, tiktok). Accepts elonmusk, @elonmusk, or a profile URL — normalized automatically. Required unless profileUrl is given.

profileUrl
string

For source=linkedin: a linkedin.com/in/<slug> URL, in/<slug>, or a bare <slug>. Required for LinkedIn unless handle is given.

limit
integer

Max mentions to return (1–50, default 10).

Required range: 1 <= x <= 50
cursor
string

Pagination cursor from a previous response's nextCursor.

Response

200 response

Paginated list of a single author's mentions.

data
object[]
required
pagination
object
required