Trefwoorden toevoegen
Voeg een of meer trefwoorden toe aan een gevolgde website, zodat RedReplier bijpassende threads ervoor gaat beoordelen.
https://ai.redreplier.com/ai-app/api/v1/websites/{websiteId}/keywordsVoeg een of meer trefwoorden toe aan een gevolgde website, zodat RedReplier bijpassende threads ervoor gaat beoordelen.
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/jsonParameters
websiteId(pad, UUID, verplicht): Website die de trefwoorden krijgt.
Request body
keywords(string[], verplicht, niet leeg): Trefwoorden om toe te voegen; elke waarde mag maximaal 255 tekens lang zijn.
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, ofnull.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,DISABLEDofSUSPENDED.createdAt, updatedAt(ISO string | null): Tijdstempels van aanmaak en wijziging in ISO 8601-formaat, ofnull.
Voorbeeldverzoek
curl -X POST https://ai.redreplier.com/ai-app/api/v1/websites/11111111-1111-4111-8111-111111111111/keywords \
-H 'Authorization: Bearer redreplier_test_1234567890' \
-H 'Content-Type: application/json' \
-d '{"keywords":["agency CRM","client onboarding software"]}'Opmerkingen
Trefwoorden toevoegen staat los van bewerken. Trefwoorden die binnen het abonnement passen, worden meteen ACTIVE. De rest blijft PENDING totdat het abonnement ruimte heeft.
Fouten
400 Bad Request: Ongeldige invoer, URL, UUID, enum, queryparameter of body.401 Unauthorized: Bearer-token ontbreekt of is ongeldig, ofcode: "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"wanneerX-Workspace-Ideen workspace noemt waar deze inloggegevens geen toegang toe hebben, ofcode: "permission_denied"wanneer je rol in de workspace geenredreplier.writeheeft (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 uitRetry-After.500 Internal Server Error: Onverwachte serverfout.
curl --request POST \
--url https://ai.redreplier.com/ai-app/api/v1/websites/9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10/keywords \
--header 'Authorization: Bearer redreplier_test_1234567890' \
--header 'Content-Type: application/json' \
--data '{"keywords":["agency CRM","client follow-up software","sales pipeline for agencies"]}'{
"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"
}
]
}