Tworzenie witryny
Dodaj witrynę lub produkt do monitorowania na Reddicie, Hacker News, X, Bluesky i Facebooku.
https://ai.redreplier.com/ai-app/api/v1/websitesDodaj witrynę lub produkt do monitorowania na Reddicie, Hacker News, X, Bluesky i Facebooku.
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/jsonParametry
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 zdescription: null; opis ustawisz przezPATCH /websites/{id}lubPOST /websites/analyze-description. Wyślijdescription: "", 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 lubnull.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,DISABLEDlubSUSPENDED.createdAt, updatedAt(ISO string | null): Znaczniki czasu utworzenia i aktualizacji w formacie ISO 8601 lubnull.
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 albocode: "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", gdyX-Workspace-Idwskazuje obszar roboczy niedostępny dla tych danych uwierzytelniających, lubcode: "permission_denied", gdy twoja rola w obszarze roboczym nie ma uprawnieniaredreplier.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ą wRetry-After.500 Internal Server Error: Nieoczekiwany błąd serwera.
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"]}'{
"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"
}
]
}