API-ReferenzGET

Websites auflisten

Listet alle überwachten Websites für das authentifizierte RedReplier-Konto auf.

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

Listet alle überwachten Websites für das authentifizierte RedReplier-Konto auf.

Bearer-Token (RedReplier-API-Token)

Authentifizierung

Sende bei jeder Anfrage ein RedReplier-API-Token als Bearer-Token. Tokens beginnen mit redreplier_; RedReplier ermittelt das Konto aus dem Token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parameter

Dieser Endpoint hat keine Pfad- oder Query-Parameter.

Request-Body

Dieser Endpoint benötigt keinen JSON-Body.

Antwort

Gibt ein Objekt mit einem websites-Array zurück.

  • websites (Website[]): Überwachte Websites, die für das Token-Konto sichtbar sind.

Website-Objekt

  • id (string): Website-UUID.
  • accountGroupId (string): Aus dem Token ermittelte Account-Gruppe.
  • domain (string): Normalisierte Website-Domain.
  • url (string): Website-URL.
  • name (string | null): Anzeigename.
  • description (string | null): Kontext für die Relevanzbewertung.
  • createdAt, updatedAt (ISO string | null): Erstellungs- und Aktualisierungszeitpunkte im ISO-8601-Format oder null.
  • keywords (Keyword[]): Keyword-Objekte für diese Website.

Keyword-Objekt

  • id (string): Keyword-UUID.
  • websiteId (string): UUID der übergeordneten Website.
  • value (string): Keyword-Text mit bis zu 255 Zeichen.
  • status (string): PENDING, ACTIVE, DISABLED oder SUSPENDED.
  • createdAt, updatedAt (ISO string | null): Erstellungs- und Aktualisierungszeitpunkte im ISO-8601-Format oder null.

Beispielanfrage

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

Hinweise

Nutze dies zuerst, um websiteId- und keywordId-Werte für spätere Aufrufe zu finden.

Fehler

  • 400 Bad Request: Ungültige Eingabe, URL, UUID, Enum, Query-Parameter oder Body.
  • 401 Unauthorized: Fehlendes oder ungültiges Bearer-Token.
  • 404 Not Found: Die Ressource existiert nicht für das Token-Konto.
  • 500 Internal Server Error: Unerwarteter Serverfehler.
Beispielanfrage (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"
        }
      ]
    }
  ]
}