List mentions

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 the website's minimum score (30 by default).
• minScore (query, integer, optional, 0-100): Only mentions scoring at least this much. Unscored mentions are left out. The website's minimum score still applies unless includeLowRelevance is true.
• keywords (query, repeatable, optional): Filter by keyword values.
• sources (query, repeatable, optional): Mention sources: REDDIT_POST, REDDIT_COMMENT, TWITTER (X), BLUESKY, HACKERNEWS, FACEBOOK, FACEBOOK_GROUP.
• 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, HACKERNEWS, FACEBOOK, or FACEBOOK_GROUP.
• keyword (string | null): Keyword value that matched.
• title, contentText, url, author, subreddit (string | null): Title/body/link context. subreddit holds the subreddit for Reddit sources and the group id for FACEBOOK_GROUP, and is null for the other sources.
• 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.
• aiReplySuggestion (string | null): AI-drafted reply for a person to review before posting, 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 the website's minimum score (30 by default) are hidden. minScore narrows further and never lowers that floor on its own. 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, or code: "token_issuer_lost_access" when the person who created the API key was deactivated or left the workspace.
• 403 Forbidden: code: "subscription_required" when the workspace plan does not include API access, code: "workspace_access_denied" when X-Workspace-Id names a workspace this credential cannot reach, or code: "permission_denied" when your role in the workspace does not hold redreplier.write (Admin and Editor hold it).
• 404 Not Found: The resource does not exist for the token account.
• 429 Too Many Requests: Rate limit exceeded. Wait the seconds in Retry-After.
• 500 Internal Server Error: Unexpected server error.