Getting started with the RedReplier API

The RedReplier API lets external tools, automations, and AI agents manage mention monitoring across Reddit, Hacker News, X, and Bluesky. Use it to create monitored websites, manage keywords, review AI-scored mentions, preview keyword billing changes, and configure email alerts.

Base URL: https://ai.redreplier.com/ai-app/api/v1

Send a RedReplier API token as a Bearer token on every request. Tokens start with redreplier_; RedReplier resolves the account from the token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

The account is derived from the API token. Do not pass account, organization, or workspace IDs. Start with List websites to discover website IDs and keyword IDs.

Core resources:

• Website: product, domain, or brand being monitored.
• Keyword: phrase matched across Reddit, Hacker News, X, and Bluesky for a website.
• Mention: matched post or comment from Reddit, Hacker News, X, or Bluesky with a relevanceScore from 0 to 100.
• Alert settings: email digest cadence for new relevant mentions.

Keyword statuses: PENDING, ACTIVE, DISABLED, SUSPENDED. Mention statuses: NEW, APPROVED, REJECTED.

REST endpoints

• GET List websites - /websites
• GET Get website - /websites/{websiteId}
• POST Create website - /websites
• PATCH Update website - /websites/{websiteId}
• DELETE Delete website - /websites/{websiteId}
• POST Analyze website description - /websites/analyze-description
• POST Add keywords - /websites/{websiteId}/keywords
• PATCH Edit keyword - /keywords/{keywordId}
• POST Disable keyword - /keywords/{keywordId}/disable
• POST Enable keyword - /keywords/{keywordId}/enable
• DELETE Delete keyword - /keywords/{keywordId}
• POST Activate pending keywords - /keywords/activate-pending
• GET Preview pending keyword activation - /keywords/activate-pending/preview
• GET Preview keyword billing - /keywords/billing-preview
• GET Keyword change usage - /keywords/change-usage
• GET List mentions - /mentions
• GET Count mentions - /mentions/count
• PATCH Update mention status - /mentions/{mentionId}/status
• POST Explain mention - /mentions/{mentionId}/explain
• GET Get alert settings - /alert-settings
• PUT Update alert settings - /alert-settings

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.