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>. Keys carry a scope — read, write (implies read) or admin (implies write) — chosen when the key is minted. Each operation's security requirement (and its x-required-scope extension) names the minimum scope it needs; request the least-privileged key that covers the operations you call.

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.

includeEngagementMetrics
enum<string>

Set to true to include each mention's latest public engagement snapshot. Omit or pass false to avoid the engagement-state join.

Available options:
true,
false
Example:

"false"

Response

200 response

Paginated list of a single author's mentions.

data
object[]
required
pagination
object
required