Referencia de APIGET

Obtener sitio web

Obtiene un sitio web monitorizado por ID, con sus palabras clave y la descripción usada para calcular relevancia.

GEThttps://ai.redreplier.com/ai-app/api/v1/websites/{websiteId}

Obtiene un sitio web monitorizado por ID, con sus palabras clave y la descripción usada para calcular relevancia.

Token Bearer (token de API de RedReplier)

Autenticación

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. Envía X-Workspace-Id para actuar en un workspace distinto del predeterminado; consulta Listar workspaces.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parámetros

  • websiteId (ruta, UUID, obligatorio): Sitio web que se obtendrá.

Cuerpo de la solicitud

Este endpoint no requiere un cuerpo JSON.

Respuesta

Devuelve un objeto Website público.

Objeto Website

  • id (string): UUID del sitio web.
  • accountGroupId (string): Grupo de cuenta resuelto desde el token.
  • domain (string): Dominio normalizado del sitio web.
  • url (string): URL del sitio web.
  • name (string | null): Nombre visible.
  • description (string | null): Contexto usado para calcular la relevancia.
  • createdAt, updatedAt (ISO string | null): Marcas de creación y actualización en formato ISO 8601, o null.
  • keywords (Keyword[]): Objetos Keyword de este sitio web.

Objeto Keyword

  • id (string): UUID de la palabra clave.
  • websiteId (string): UUID del sitio web principal.
  • value (string): Texto de la palabra clave, hasta 255 caracteres.
  • status (string): PENDING, ACTIVE, DISABLED o SUSPENDED.
  • createdAt, updatedAt (ISO string | null): Marcas de creación y actualización en formato ISO 8601, o null.

Solicitud de ejemplo

curl -s https://ai.redreplier.com/ai-app/api/v1/websites/11111111-1111-4111-8111-111111111111 \
  -H 'Authorization: Bearer redreplier_test_1234567890'

Notas

El token debe pertenecer al mismo grupo de cuenta que el sitio web.

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: code: "subscription_required" cuando el plan del workspace no incluye acceso a la API, code: "workspace_access_denied" cuando X-Workspace-Id indica un workspace al que esta credencial no puede acceder, o code: "permission_denied" cuando tu rol en el workspace no tiene el permiso redreplier.write (lo tienen Admin y Editor).
  • 404 Not Found: El recurso no existe para la cuenta del token.
  • 429 Too Many Requests: Límite de solicitudes superado. Espera los segundos indicados en Retry-After.
  • 500 Internal Server Error: Error inesperado del servidor.
Solicitud de ejemplo (curl)
curl --request GET \
  --url https://ai.redreplier.com/ai-app/api/v1/websites/9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10 \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "id": "9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10",
  "accountGroupId": "acct_7dK9pQ2",
  "domain": "acmecrm.io",
  "url": "https://acmecrm.io",
  "name": "Acme CRM",
  "description": "CRM for small agencies that need pipeline tracking and client follow-up reminders.",
  "createdAt": "2026-05-22T10:15:30.000Z",
  "updatedAt": "2026-05-29T14:02:11.000Z",
  "keywords": [
    {
      "id": "73a3c9b6-3e5f-4a53-a2c6-70c5ef7f2f6d",
      "websiteId": "9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10",
      "value": "agency CRM",
      "status": "ACTIVE",
      "createdAt": "2026-05-22T10:16:00.000Z",
      "updatedAt": "2026-05-29T14:02:11.000Z"
    }
  ]
}