Skip to main content
GET
List mentions by author

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