Aan de slag met de RedReplier API
Met de RedReplier API kunnen externe tools, automatiseringen en AI-agents het monitoren van vermeldingen op Reddit, Hacker News, X, Bluesky en Facebook beheren. Je gebruikt hem om gemonitorde websites aan te maken, trefwoorden te beheren, door AI gescoorde vermeldingen te beoordelen, wijzigingen in de trefwoordfacturering vooraf te bekijken en e-mailmeldingen in te stellen. De API brengt nooit iets in rekening en wijzigt nooit het abonnement: abonnementswijzigingen doe je in de RedReplier-app.
Basis-URL: https://ai.redreplier.com/ai-app/api/v1
Stuur bij elk verzoek een RedReplier API-token mee als Bearer-token. Tokens beginnen met redreplier_; RedReplier haalt het account uit het token.
Authorization: Bearer redreplier_test_1234567890
Content-Type: application/jsonHet account wordt afgeleid uit het API-token. Stuur geen account- of organisatie-ID's mee. Elke aanroep draait in één workspace: zonder de optionele header X-Workspace-Id komt hij in de standaardworkspace terecht. Een OAuth-login, zoals de connector voor Claude of ChatGPT, kan bij elke workspace waar het lid toe behoort, ook over organisaties heen. Roep Workspaces weergeven aan om ze op te sommen en stuur het gewenste id mee in X-Workspace-Id. Een API-sleutel hoort bij één workspace, dus stuur het eigen id mee of laat de header weg.
X-Workspace-Id: acct_7dK9pQ2Begin met Websites weergeven om de ID's van websites en trefwoorden te vinden.
Belangrijkste resources:
- Website: het product, domein of merk dat wordt gemonitord.
- Trefwoord: een zin die voor een website wordt gezocht op Reddit, Hacker News, X, Bluesky en Facebook.
- Vermelding: een gevonden post of reactie van Reddit, Hacker News, X, Bluesky of Facebook met een
relevanceScorevan0tot100. - Meldingsinstellingen: frequentie van de e-mailsamenvatting met nieuwe relevante vermeldingen.
Statussen van trefwoorden: PENDING, ACTIVE, DISABLED, SUSPENDED. Statussen van vermeldingen: NEW, APPROVED, REJECTED.
REST-endpoints
GETWorkspaces weergeven -/workspacesGETWebsites weergeven -/websitesGETWebsite ophalen -/websites/{websiteId}POSTWebsite aanmaken -/websitesPATCHWebsite bijwerken -/websites/{websiteId}DELETEWebsite verwijderen -/websites/{websiteId}POSTWebsitebeschrijving analyseren -/websites/analyze-descriptionPOSTTrefwoorden toevoegen -/websites/{websiteId}/keywordsPATCHTrefwoord bewerken -/keywords/{keywordId}POSTTrefwoord uitschakelen -/keywords/{keywordId}/disablePOSTTrefwoord inschakelen -/keywords/{keywordId}/enableDELETETrefwoord verwijderen -/keywords/{keywordId}POSTWachtende trefwoorden activeren -/keywords/activate-pendingGETActivering van wachtende trefwoorden vooraf bekijken -/keywords/activate-pending/previewGETTrefwoordfacturering vooraf bekijken -/keywords/billing-previewGETGebruik van trefwoordwijzigingen -/keywords/change-usageGETVermeldingen weergeven -/mentionsGETVermeldingen tellen -/mentions/countPATCHStatus van vermelding bijwerken -/mentions/{mentionId}/statusPOSTVermelding uitleggen -/mentions/{mentionId}/explainGETMeldingsinstellingen ophalen -/alert-settingsPUTMeldingsinstellingen bijwerken -/alert-settings
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"als de persoon die de API-sleutel heeft aangemaakt is gedeactiveerd of de workspace heeft verlaten.403 Forbidden: De headerX-Workspace-Idnoemt een workspace waar deze inloggegevens geen toegang toe hebben, ook als je met een API-sleutel het id van een andere workspace meestuurt. De body bevatcode: "workspace_access_denied"en hetworkspaceId. Een 403 metcode: "subscription_required"betekent dat het abonnement van de workspace geen API-toegang bevat. Een 403 metcode: "permission_denied"betekent dat je rol in de workspace niet de permissie heeft die de aanroep nodig heeft: RedReplier vraagtredreplier.write, die Admin en Editor hebben. Die body noemt derequiredPermissionen jerole.404 Not Found: De resource bestaat niet voor het account van het token.429 Too Many Requests: Rate limit overschreden. Elke respons bevatRateLimit-Policy,RateLimit-Limit,RateLimit-RemainingenRateLimit-Reset, en een 429 voegtRetry-Afterin seconden toe. Limieten worden per API-sleutel geteld.500 Internal Server Error: Onverwachte serverfout.
Een geweigerde workspace geeft dit antwoord:
{
"statusCode": 403,
"error": "Forbidden",
"code": "workspace_access_denied",
"workspaceId": "acct_3Hm8XwR",
"message": "You have no access to workspace acct_3Hm8XwR. Call GET /workspaces to list the workspaces you can use, and send one of those ids in the X-Workspace-Id header."
}