Mentions
List Mentions
Lists Reddit posts and comments that mention you, your competitors or your topic, newest first.
https://app.tryredrover.com/api/public/v1/mentionsmentions:readAI Connector Tool: redrover_list_mentionsHeaders
AuthorizationstringRequiredBearerfollowed by anrr_live_API key or a connected app's access token. See Authentication.X-Workspace-IdstringRequiredThe workspace to act on, from List Workspaces.
UUID
Query Parameters
limitintegerHow many results to return, 1 to 100 (default 25)
1 to 100 · default 25
offsetintegerHow many results to skip (default 0)
default 0
daysintegerHow many days back to look, 1 to 90 (default 30)
1 to 90
typestringOnly direct, competitor or niche mentions
one of direct, competitor, niche
Response
200 A page of mentions.
dataobject[]RequiredShow 14 Child FieldsHide Child Fields
idstringRequiredMention ID
kindstringRequiredA Reddit post or a comment
one of post, comment
titlestringRequiredThe thread's title
textstringRequiredThe post or comment text that mentions you
subredditstringRequiredSubreddit, without r/
urlstringRequiredLink to the post or comment on Reddit
createdAtstringRequiredWhen it was posted on Reddit
upvotesnumberRequiredUpvotes when last checked
commentCountnumberRequiredReplies in the thread when last checked
keywordsstring[]RequiredYour tracked keywords it matched
typesstring[]Requireddirect (names you), competitor (names a competitor) or niche (your topic)
each one of direct, competitor, niche
sentimentstringRequiredTone toward you
one of positive, negative, neutral
relevancenumberRequiredHow relevant it is to you, 0 to 100
statusstringRequiredopen, handled (our team acted on it) or dismissed
one of open, handled, dismissed
paginationobjectRequiredShow 3 Child FieldsHide Child Fields
limitintegerRequiredPage size used for this response
offsetintegerRequiredHow many results were skipped
hasMorebooleanRequiredTrue when more results follow at a higher offset
Errors
Every error uses the error envelope.
400days, type, limit or offset is not valid401The Authorization header is missing, or the key is invalid or revoked403The key lacks the endpoint's scope, or cannot reach the workspace429More than 120 requests in a minute. Wait for Retry-After seconds500Something went wrong on our side
curl "https://app.tryredrover.com/api/public/v1/mentions?days=30&type=direct" \
-H "Authorization: Bearer $REDROVER_API_KEY" \
-H "X-Workspace-Id: $REDROVER_WORKSPACE_ID"{
"data": [
{
"id": "post-81234",
"kind": "post",
"title": "Best tools for planning a weekly changelog?",
"text": "We tried a few, and one that kept coming up was yours.",
"subreddit": "startups",
"url": "https://www.reddit.com/r/startups/comments/1abcde2/how_do_you_plan_content/",
"createdAt": "2026-11-14T09:30:00Z",
"upvotes": 42,
"commentCount": 17,
"keywords": [
"changelog"
],
"types": [
"direct"
],
"sentiment": "positive",
"relevance": 86,
"status": "open"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"hasMore": false
}
}