Primeiros passos com a API RedReplier

A API RedReplier permite que ferramentas externas, automações e agentes de IA gerenciem o monitoramento de menções no Reddit, Hacker News, X e Bluesky. Use-a para criar sites monitorados, gerenciar palavras-chave, revisar menções pontuadas por IA, prever alterações de cobrança e configurar alertas por e-mail.

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

Envie um token de API do RedReplier como Bearer token em cada requisição. Os tokens começam com redreplier_; o RedReplier resolve a conta a partir do token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

A conta é deduzida pelo token de API. Não envie IDs de conta, organização ou workspace. Comece por Listar sites para descobrir IDs de sites e palavras-chave.

Recursos principais:

• Website: produto, domínio ou marca monitorada.
• Keyword: frase comparada com publicações e comentários no Reddit, Hacker News, X e Bluesky para um site.
• Mention: publicação ou comentário encontrado no Reddit, Hacker News, X ou Bluesky com relevanceScore de 0 a 100.
• Alert settings: cadência de e-mail para novas menções relevantes.

Status de palavra-chave: PENDING, ACTIVE, DISABLED, SUSPENDED. Status de menção: NEW, APPROVED, REJECTED.

Endpoints REST

• GET Listar sites - /websites
• GET Obter site - /websites/{websiteId}
• POST Criar site - /websites
• PATCH Atualizar site - /websites/{websiteId}
• DELETE Excluir site - /websites/{websiteId}
• POST Analisar descrição do site - /websites/analyze-description
• POST Adicionar palavras-chave - /websites/{websiteId}/keywords
• PATCH Editar palavra-chave - /keywords/{keywordId}
• POST Desativar palavra-chave - /keywords/{keywordId}/disable
• POST Ativar palavra-chave - /keywords/{keywordId}/enable
• DELETE Excluir palavra-chave - /keywords/{keywordId}
• POST Ativar palavras-chave pendentes - /keywords/activate-pending
• GET Prever ativação de palavras-chave pendentes - /keywords/activate-pending/preview
• GET Prever cobrança de palavras-chave - /keywords/billing-preview
• GET Uso de alterações de palavras-chave - /keywords/change-usage
• GET Listar menções - /mentions
• GET Contar menções - /mentions/count
• PATCH Atualizar status da menção - /mentions/{mentionId}/status
• POST Explicar menção - /mentions/{mentionId}/explain
• GET Obter configurações de alerta - /alert-settings
• PUT Atualizar configurações de alerta - /alert-settings

Erros

• 400 Bad Request: Entrada, URL, UUID, enum, parâmetro de consulta ou corpo inválido.
• 401 Unauthorized: Bearer token ausente ou inválido.
• 404 Not Found: O recurso não existe para a conta do token.
• 500 Internal Server Error: Erro inesperado do servidor.