Primeros pasos con la API de RedReplier

La API de RedReplier permite que herramientas externas, automatizaciones y agentes de IA gestionen el monitoreo de menciones en Reddit, Hacker News, X y Bluesky. Úsala para crear sitios monitorizados, gestionar palabras clave, revisar menciones puntuadas por IA, previsualizar cambios de facturación y configurar alertas por correo.

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

Envía un token de API de RedReplier como Bearer token en cada solicitud. Los tokens empiezan por redreplier_; RedReplier resuelve la cuenta desde el token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

La cuenta se deduce del token de API. No envíes IDs de cuenta, organización o workspace. Empieza con Listar sitios web para descubrir IDs de sitios web y palabras clave.

Recursos principales:

• Website: producto, dominio o marca monitorizada.
• Keyword: frase comparada con publicaciones y comentarios en Reddit, Hacker News, X y Bluesky para un sitio web.
• Mention: publicación o comentario encontrado en Reddit, Hacker News, X o Bluesky con un relevanceScore de 0 a 100.
• Alert settings: cadencia de correo para nuevas menciones relevantes.

Estados de palabra clave: PENDING, ACTIVE, DISABLED, SUSPENDED. Estados de mención: NEW, APPROVED, REJECTED.

Endpoints REST

• GET Listar sitios web - /websites
• GET Obtener sitio web - /websites/{websiteId}
• POST Crear sitio web - /websites
• PATCH Actualizar sitio web - /websites/{websiteId}
• DELETE Eliminar sitio web - /websites/{websiteId}
• POST Analizar descripción del sitio web - /websites/analyze-description
• POST Agregar palabras clave - /websites/{websiteId}/keywords
• PATCH Editar palabra clave - /keywords/{keywordId}
• POST Desactivar palabra clave - /keywords/{keywordId}/disable
• POST Activar palabra clave - /keywords/{keywordId}/enable
• DELETE Eliminar palabra clave - /keywords/{keywordId}
• POST Activar palabras clave pendientes - /keywords/activate-pending
• GET Previsualizar activación de palabras clave pendientes - /keywords/activate-pending/preview
• GET Previsualizar facturación de palabras clave - /keywords/billing-preview
• GET Uso de cambios de palabras clave - /keywords/change-usage
• GET Listar menciones - /mentions
• GET Contar menciones - /mentions/count
• PATCH Actualizar estado de mención - /mentions/{mentionId}/status
• POST Explicar mención - /mentions/{mentionId}/explain
• GET Obtener configuración de alertas - /alert-settings
• PUT Actualizar configuración de alertas - /alert-settings

Errores

• 400 Bad Request: Entrada, URL, UUID, enum, parámetro de consulta o cuerpo no válido.
• 401 Unauthorized: Bearer token ausente o no válido.
• 404 Not Found: El recurso no existe para la cuenta del token.
• 500 Internal Server Error: Error inesperado del servidor.