Dokumentacja APIPOST

Tworzenie witryny

Dodaj witrynę lub produkt do monitorowania na Reddicie, Hacker News, X, Bluesky i Facebooku.

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

Dodaj witrynę lub produkt do monitorowania na Reddicie, Hacker News, X, Bluesky i Facebooku.

Token Bearer (token API RedReplier)

Uwierzytelnianie

W każdym żądaniu wysyłaj token API RedReplier jako token Bearer. Tokeny zaczynają się od redreplier_, a RedReplier ustala konto na podstawie tokena. Aby działać w obszarze roboczym innym niż domyślny, wyślij X-Workspace-Id; zobacz Lista obszarów roboczych.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parametry

Ten endpoint nie przyjmuje parametrów ścieżki ani zapytania.

Treść żądania

  • url (string, URL, wymagany): URL witryny.
  • name (string, opcjonalny): Wyświetlana nazwa.
  • keywords (string[], opcjonalny): Początkowe słowa kluczowe; każda wartość może mieć do 255 znaków.
  • description (string, opcjonalny, maks. 5000): Ręczny opis witryny. Po pominięciu RedReplier pobiera zawartość spod adresu URL i pisze opis, zużywając jedno generowanie AI z limitu planu. Jeśli pobieranie się nie powiedzie lub limit się wyczerpie, witryna i tak zostanie utworzona z description: null; opis ustawisz przez PATCH /websites/{id} lub POST /websites/analyze-description. Wyślij description: "", aby pominąć pobieranie i analizę AI: żadne generowanie nie zostanie zużyte, a witryna powstanie bez opisu.

Odpowiedź

Zwraca jeden publiczny obiekt Website.

Obiekt Website

  • id (string): UUID witryny.
  • accountGroupId (string): Grupa kont ustalona na podstawie tokena.
  • domain (string): Znormalizowana domena witryny.
  • url (string): URL witryny.
  • name (string | null): Wyświetlana nazwa.
  • description (string | null): Kontekst używany przy ocenie trafności.
  • createdAt, updatedAt (ISO string | null): Znaczniki czasu utworzenia i aktualizacji w formacie ISO 8601 lub null.
  • keywords (Keyword[]): Obiekty słów kluczowych tej witryny.

Obiekt Keyword

  • id (string): UUID słowa kluczowego.
  • websiteId (string): UUID witryny nadrzędnej.
  • value (string): Treść słowa kluczowego, do 255 znaków.
  • status (string): PENDING, ACTIVE, DISABLED lub SUSPENDED.
  • createdAt, updatedAt (ISO string | null): Znaczniki czasu utworzenia i aktualizacji w formacie ISO 8601 lub null.

Przykładowe żądanie

curl -X POST https://ai.redreplier.com/ai-app/api/v1/websites \
  -H 'Authorization: Bearer redreplier_test_1234567890' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://acmecrm.io","name":"Acme CRM","keywords":["agency CRM"]}'

Uwagi

Początkowe słowa kluczowe są zapisywane ze statusem PENDING. Te, które mieszczą się w planie, otrzymują status ACTIVE przy następnym wywołaniu GET /websites lub POST /websites/{websiteId}/keywords, a pozostałe zachowują PENDING, dopóki plan nie zostanie podniesiony w aplikacji RedReplier. Domena już monitorowana w tym obszarze roboczym zwraca 400, podobnie jak plan bez wolnego miejsca na witrynę. Ponowne dodanie usuniętej domeny przywraca tę witrynę.

Błędy

  • 400 Bad Request: Nieprawidłowe dane wejściowe, URL, UUID, wartość enum, parametr zapytania lub treść żądania.
  • 401 Unauthorized: Brak tokena Bearer lub token jest nieprawidłowy albo code: "token_issuer_lost_access", gdy osoba, która utworzyła klucz API, została dezaktywowana lub opuściła obszar roboczy.
  • 403 Forbidden: code: "subscription_required", gdy plan obszaru roboczego nie obejmuje dostępu do API, code: "workspace_access_denied", gdy X-Workspace-Id wskazuje obszar roboczy niedostępny dla tych danych uwierzytelniających, lub code: "permission_denied", gdy twoja rola w obszarze roboczym nie ma uprawnienia redreplier.write (mają je Administrator i Edytor).
  • 404 Not Found: Zasób nie istnieje dla konta przypisanego do tokena.
  • 429 Too Many Requests: Przekroczono limit żądań. Odczekaj liczbę sekund podaną w Retry-After.
  • 500 Internal Server Error: Nieoczekiwany błąd serwera.
Przykładowe żądanie (curl)
curl --request POST \
  --url https://ai.redreplier.com/ai-app/api/v1/websites \
  --header 'Authorization: Bearer redreplier_test_1234567890' \
  --header 'Content-Type: application/json' \
  --data '{"url": "https://acmecrm.io","name": "Acme CRM","keywords":["agency CRM"]}'
201
{
  "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"
    }
  ]
}