API referenceGET

List mentions

List AI-scored mentions from Reddit, Hacker News, X, and Bluesky with filters and pagination.

GEThttps://ai.redreplier.com/ai-app/api/v1/mentions

List AI-scored mentions from Reddit, Hacker News, X, and Bluesky with filters and pagination.

Bearer Token (RedReplier API token)

Parameters

  • websiteId (query, UUID, optional): Filter to one website.
  • statuses (query, repeatable, optional): Mention statuses: NEW, APPROVED, REJECTED.
  • scoreBuckets (query, repeatable, optional): Relevance buckets: VERY_LOW, LOW, MEDIUM, HIGH, VERY_HIGH.
  • includeLowRelevance (query, boolean, optional): Include mentions below score 30.
  • keywords (query, repeatable, optional): Filter by keyword values.
  • sources (query, repeatable, optional): Mention sources: REDDIT_POST, REDDIT_COMMENT, TWITTER (X), BLUESKY, HACKERNEWS.
  • sort (query, optional): Sort order: RELEVANCE or RECENT.
  • from, to (query, ISO string, optional): Ingestion date range.
  • limit (query, integer, optional, 1-500, default 50): Page size.
  • offset (query, integer, optional, min 0, default 0): Pagination offset.

Request body

This endpoint does not require a JSON body.

Response

Returns paginated public Mention objects.

  • mentions (Mention[]): Mentions in the current page.
  • total (number): Total matching mentions.
  • limit (number): Page size used by the response.
  • offset (number): Pagination offset used by the response.

Mention object

  • id (string): Mention UUID.
  • websiteId (string | null): Website UUID.
  • source (string): REDDIT_POST, REDDIT_COMMENT, TWITTER (X), BLUESKY, or HACKERNEWS.
  • keyword (string | null): Keyword value that matched.
  • title, contentText, url, author, subreddit (string | null): Title/body/link context. subreddit is set only for Reddit sources and is null for X, Bluesky, and Hacker News.
  • status (string): NEW, APPROVED, or REJECTED.
  • relevanceScore (number | null): AI relevance score from 0 to 100, or null.
  • relevanceReason (string | null): AI explanation for the match, or null.
  • tags (string[]): AI-generated relevance tags.
  • publishedAt, ingestedAt, reviewedAt, createdAt, updatedAt (ISO string | null): Publication, ingestion, review, creation, and update timestamps in ISO 8601 format, or null.

Notes

By default, REJECTED mentions are excluded and mentions below score 30 are hidden. Buckets: VERY_LOW <10, LOW 10-29, MEDIUM 30-49, HIGH 50-74, VERY_HIGH >=75.

Errors

  • 400 Bad Request: Invalid input, URL, UUID, enum, query parameter, or body.
  • 401 Unauthorized: Missing or invalid Bearer token.
  • 404 Not Found: The resource does not exist for the token account.
  • 500 Internal Server Error: Unexpected server error.
Example request (curl)
curl --request GET \
  --url https://ai.redreplier.com/ai-app/api/v1/mentions?websiteId=9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10&statuses=NEW&sort=RELEVANCE&limit=25 \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "mentions": [
    {
      "id": "6a9f0e8b-2c65-44f7-b6e6-7f88a7df8301",
      "websiteId": "9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10",
      "source": "REDDIT_POST",
      "keyword": "agency CRM",
      "title": "Best CRM for a small agency?",
      "contentText": "We need a lightweight CRM for client follow-ups and deal tracking.",
      "url": "https://reddit.com/r/sales/comments/example/best_crm_for_a_small_agency",
      "author": "agency_ops",
      "subreddit": "sales",
      "status": "NEW",
      "relevanceScore": 86,
      "relevanceReason": "The thread asks for an agency CRM, which directly matches the monitored product category.",
      "tags": ["recommendation-request", "high-intent"],
      "publishedAt": "2026-05-29T09:20:00.000Z",
      "ingestedAt": "2026-05-29T09:24:12.000Z",
      "reviewedAt": null,
      "createdAt": "2026-05-29T09:24:12.000Z",
      "updatedAt": "2026-05-29T09:24:12.000Z"
    }
  ],
  "total": 1,
  "limit": 25,
  "offset": 0
}