API-referentiePOST

Website aanmaken

Voeg een website of product toe om te volgen op Reddit, Hacker News, X, Bluesky en Facebook.

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

Voeg een website of product toe om te volgen op Reddit, Hacker News, X, Bluesky en Facebook.

Bearer-token (RedReplier API-token)

Authenticatie

Stuur bij elk verzoek een RedReplier-API-token mee als Bearer-token. Tokens beginnen met redreplier_; RedReplier leidt het account af uit het token. Stuur X-Workspace-Id mee om in een andere workspace dan de standaardworkspace te werken; zie Workspaces weergeven.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parameters

Dit endpoint heeft geen pad- of queryparameters.

Request body

  • url (string, URL, verplicht): URL van de website.
  • name (string, optioneel): Weergavenaam.
  • keywords (string[], optioneel): Eerste trefwoorden; elke waarde mag maximaal 255 tekens lang zijn.
  • description (string, optioneel, max. 5000): Handmatige beschrijving van de website. Laat je die weg, dan scrapet RedReplier de URL en schrijft er zelf een, wat één AI-generatie uit het quotum van je abonnement kost. Mislukt het scrapen of is het quotum op, dan wordt de website toch aangemaakt met description: null; stel er later een in met PATCH /websites/{id} of POST /websites/analyze-description. Stuur description: "" om het scrapen en de AI-analyse over te slaan: er wordt geen generatie gebruikt en de website begint zonder beschrijving.

Respons

Geeft één openbaar Website-object terug.

Website-object

  • id (string): UUID van de website.
  • accountGroupId (string): Accountgroep die uit het token is afgeleid.
  • domain (string): Genormaliseerd domein van de website.
  • url (string): URL van de website.
  • name (string | null): Weergavenaam.
  • description (string | null): Context die wordt gebruikt voor de relevantiescore.
  • createdAt, updatedAt (ISO string | null): Tijdstempels van aanmaak en wijziging in ISO 8601-formaat, of null.
  • keywords (Keyword[]): Keyword-objecten van deze website.

Keyword-object

  • id (string): UUID van het trefwoord.
  • websiteId (string): UUID van de bovenliggende website.
  • value (string): Tekst van het trefwoord, maximaal 255 tekens.
  • status (string): PENDING, ACTIVE, DISABLED of SUSPENDED.
  • createdAt, updatedAt (ISO string | null): Tijdstempels van aanmaak en wijziging in ISO 8601-formaat, of null.

Voorbeeldverzoek

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"]}'

Opmerkingen

Eerste trefwoorden worden opgeslagen als PENDING. Trefwoorden die binnen het abonnement passen, worden ACTIVE bij de volgende aanroep van GET /websites of POST /websites/{websiteId}/keywords; de rest blijft PENDING totdat het abonnement in de RedReplier-app wordt geüpgraded. Een domein dat al in deze workspace wordt gevolgd, geeft 400, en dat geldt ook voor een abonnement zonder vrije websiteplek. Voeg je een verwijderd domein opnieuw toe, dan wordt die website hersteld.

Fouten

  • 400 Bad Request: Ongeldige invoer, URL, UUID, enum, queryparameter of body.
  • 401 Unauthorized: Bearer-token ontbreekt of is ongeldig, of code: "token_issuer_lost_access" wanneer de persoon die de API-sleutel heeft aangemaakt is gedeactiveerd of de workspace heeft verlaten.
  • 403 Forbidden: code: "subscription_required" wanneer het abonnement van de workspace geen API-toegang bevat, code: "workspace_access_denied" wanneer X-Workspace-Id een workspace noemt waar deze inloggegevens geen toegang toe hebben, of code: "permission_denied" wanneer je rol in de workspace geen redreplier.write heeft (Admin en Editor hebben die wel).
  • 404 Not Found: De resource bestaat niet voor het account van het token.
  • 429 Too Many Requests: Rate limit overschreden. Wacht het aantal seconden uit Retry-After.
  • 500 Internal Server Error: Onverwachte serverfout.
Voorbeeldverzoek (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"
    }
  ]
}