RedRover Logo

Mentions

List Mentions

Lists Reddit posts and comments that mention you, your competitors or your topic, newest first.

GET/mentions
Scope: mentions:readAI Connector Tool: redrover_list_mentions

Headers

  • AuthorizationstringRequired

    Bearer followed by an rr_live_ API key or a connected app's access token. See Authentication.

  • X-Workspace-IdstringRequired

    The workspace to act on, from List Workspaces.

    UUID

Query Parameters

  • limitinteger

    How many results to return, 1 to 100 (default 25)

    1 to 100 · default 25

  • offsetinteger

    How many results to skip (default 0)

    default 0

  • daysinteger

    How many days back to look, 1 to 90 (default 30)

    1 to 90

  • typestring

    Only direct, competitor or niche mentions

    one of direct, competitor, niche

Response

200 A page of mentions.

  • dataobject[]Required
    Show 14 Child Fields
    • idstringRequired

      Mention ID

    • kindstringRequired

      A Reddit post or a comment

      one of post, comment

    • titlestringRequired

      The thread's title

    • textstringRequired

      The post or comment text that mentions you

    • subredditstringRequired

      Subreddit, without r/

    • urlstringRequired

      Link to the post or comment on Reddit

    • createdAtstringRequired

      When it was posted on Reddit

    • upvotesnumberRequired

      Upvotes when last checked

    • commentCountnumberRequired

      Replies in the thread when last checked

    • keywordsstring[]Required

      Your tracked keywords it matched

    • typesstring[]Required

      direct (names you), competitor (names a competitor) or niche (your topic)

      each one of direct, competitor, niche

    • sentimentstringRequired

      Tone toward you

      one of positive, negative, neutral

    • relevancenumberRequired

      How relevant it is to you, 0 to 100

    • statusstringRequired

      open, handled (our team acted on it) or dismissed

      one of open, handled, dismissed

  • paginationobjectRequired
    Show 3 Child Fields
    • limitintegerRequired

      Page size used for this response

    • offsetintegerRequired

      How many results were skipped

    • hasMorebooleanRequired

      True when more results follow at a higher offset

Errors

Every error uses the error envelope.

  • 400days, type, limit or offset is not valid
  • 401The Authorization header is missing, or the key is invalid or revoked
  • 403The key lacks the endpoint's scope, or cannot reach the workspace
  • 429More than 120 requests in a minute. Wait for Retry-After seconds
  • 500Something 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"
200 Response
{
  "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
  }
}