Mentions

List matched conversations

Scored mentions across Reddit, X, Bluesky, Hacker News and Facebook, each with the matched keyword, a relevance score with its reasoning, and an AI-drafted reply.

get/mentions

Request

  • Base URL: https://ai.redreplier.com/ai-app/api/v1
  • URL: https://ai.redreplier.com/ai-app/api/v1/mentions
  • Auth: HTTP bearer

Query parameters

websiteIdstring uuid

Restrict to mentions for one monitored website.

statusesMentionStatus[]

Review states to include. Repeat the key for several, e.g. ?statuses=NEW&statuses=APPROVED.

scoreBucketsRelevanceBucket[]

Relevance bands to include.

includeLowRelevanceboolean

Include mentions the scorer judged unlikely to be worth a reply. Excluded by default.

minScoreinteger

Only return mentions scoring at least this much. Unscored mentions are left out. The website's minimum score still applies unless includeLowRelevance is true.

keywordsstring[]

Only mentions matched by these keywords.

sourcesMentionSource[]

Platforms to include.

sort'RELEVANCE' | 'RECENT'

Order results by relevance score or publish time.

fromstring date-time

Only mentions RedReplier found at or after this time (ISO 8601). Filters on ingestedAt, not publishedAt.

tostring date-time

Only mentions RedReplier found at or before this time (ISO 8601). Filters on ingestedAt, not publishedAt.

limitinteger

Maximum mentions to return.

offsetinteger

Mentions to skip before returning results.

Headers

X-Workspace-Idstring

The workspace to act in, for OAuth sign-ins that reach several workspaces. Take the id from GET /workspaces. Without it the call lands in the default workspace. A workspace the caller cannot reach answers 403 with code: workspace_access_denied. An API key belongs to one workspace: send its own id or leave the header out

Response

Mentions

totalinteger required

Mentions matching the filters, before paging.

limitinteger required
offsetinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.