Referência da APIGET

Listar sites

Lista todos os sites monitorados da conta RedReplier autenticada, cada um com seus objetos de palavra-chave.

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

Lista todos os sites monitorados da conta RedReplier autenticada, cada um com seus objetos de palavra-chave.

Token Bearer (token de API do RedReplier)

Parâmetros

Este endpoint não aceita parâmetros de caminho nem de consulta.

Corpo da requisição

Este endpoint não exige um corpo JSON.

Resposta

Retorna um objeto com um array websites.

  • websites (Website[]): Sites monitorados visíveis para a conta do token.

Objeto Website

  • id (string): UUID do site.
  • accountGroupId (string): Grupo de conta resolvido a partir do token.
  • domain (string): Domínio normalizado do site.
  • url (string): URL do site.
  • name (string | null): Nome de exibição.
  • description (string | null): Contexto usado para pontuação de relevância.
  • createdAt, updatedAt (ISO string | null): Carimbos de criação e atualização em formato ISO 8601, ou null.
  • keywords (Keyword[]): Objetos Keyword deste site.

Objeto Keyword

  • id (string): UUID da palavra-chave.
  • websiteId (string): UUID do site principal.
  • value (string): Texto da palavra-chave, até 255 caracteres.
  • status (string): PENDING, ACTIVE, DISABLED ou SUSPENDED.
  • createdAt, updatedAt (ISO string | null): Carimbos de criação e atualização em formato ISO 8601, ou null.

Notas

Use primeiro para descobrir valores websiteId e keywordId para chamadas posteriores.

Erros

  • 400 Bad Request: Entrada, URL, UUID, enum, parâmetro de consulta ou corpo inválido.
  • 401 Unauthorized: Bearer token ausente ou inválido, ou code: "token_issuer_lost_access" quando a pessoa que criou a chave API foi desativada ou saiu do workspace.
  • 403 Forbidden: code: "subscription_required" quando o plano do workspace não inclui acesso à API, code: "workspace_access_denied" quando X-Workspace-Id indica um workspace que esta credencial não pode alcançar, ou code: "permission_denied" quando seu papel no workspace não tem a permissão redreplier.write (Admin e Editor têm).
  • 404 Not Found: O recurso não existe para a conta do token.
  • 429 Too Many Requests: Limite de requisições excedido. Aguarde os segundos indicados em Retry-After.
  • 500 Internal Server Error: Erro inesperado do servidor.
Exemplo de solicitação (curl)
curl --request GET \
  --url https://ai.redreplier.com/ai-app/api/v1/websites \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "websites": [
    {
      "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"
        }
      ]
    }
  ]
}