Referencia de API

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, Bluesky y Facebook. Úsala para crear sitios monitorizados, gestionar palabras clave, revisar menciones puntuadas por IA, previsualizar cambios de facturación y configurar alertas por correo. La API nunca cobra ni cambia el plan: los cambios de plan se hacen en la app de RedReplier.

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 u organización. Cada llamada se ejecuta en un workspace: sin la cabecera opcional X-Workspace-Id cae en el workspace predeterminado. Un inicio de sesión OAuth, como el conector de Claude o ChatGPT, puede llegar a todos los workspaces a los que pertenece su miembro, en todas sus organizaciones. Llama a Listar workspaces y envía el id que quieras en X-Workspace-Id. Una clave API pertenece a un workspace, así que envía su propio id o no incluyas la cabecera.

X-Workspace-Id: acct_7dK9pQ2

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, Bluesky y Facebook para un sitio web.
  • Mention: publicación o comentario encontrado en Reddit, Hacker News, X, Bluesky o Facebook 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

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, o code: "token_issuer_lost_access" cuando la persona que creó la clave API fue desactivada o salió del workspace.
  • 403 Forbidden: La cabecera X-Workspace-Id indica un workspace al que esta credencial no puede acceder, también cuando una clave API se envía con el id de otro workspace. El cuerpo incluye code: "workspace_access_denied" y el workspaceId. Un 403 con code: "subscription_required" significa que el plan del workspace no incluye acceso a la API. Un 403 con code: "permission_denied" significa que tu rol en el workspace no tiene el permiso que la llamada necesita: RedReplier necesita redreplier.write, que tienen Admin y Editor. Ese cuerpo indica el requiredPermission y tu role.
  • 404 Not Found: El recurso no existe para la cuenta del token.
  • 429 Too Many Requests: Límite de solicitudes superado. Cada respuesta incluye RateLimit-Policy, RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset, y un 429 añade Retry-After en segundos. Los límites se cuentan por clave API.
  • 500 Internal Server Error: Error inesperado del servidor.

Un workspace rechazado responde:

{
  "statusCode": 403,
  "error": "Forbidden",
  "code": "workspace_access_denied",
  "workspaceId": "acct_3Hm8XwR",
  "message": "No tienes acceso al espacio de trabajo acct_3Hm8XwR. Llama a GET /workspaces para ver los espacios de trabajo que puedes usar y envía uno de esos ids en la cabecera X-Workspace-Id."
}

Volver a empezar