Vermeldingen weergeven
Geef door AI gescoorde vermeldingen van Reddit, Hacker News, X, Bluesky en Facebook weer, met filters en paginering.
https://ai.redreplier.com/ai-app/api/v1/mentionsGeef door AI gescoorde vermeldingen van Reddit, Hacker News, X, Bluesky en Facebook weer, met filters en paginering.
Authenticatie
Stuur bij elk verzoek een RedReplier API-token mee als Bearer-token. Tokens beginnen met redreplier_; RedReplier haalt het account uit het token. Stuur X-Workspace-Id mee om in een andere workspace dan de standaard te werken; zie Workspaces weergeven.
Authorization: Bearer redreplier_test_1234567890
Content-Type: application/jsonParameters
websiteId(query, UUID, optioneel): Filter op één website.statuses(query, herhaalbaar, optioneel): Statussen van vermeldingen:NEW,APPROVED,REJECTED.scoreBuckets(query, herhaalbaar, optioneel): Relevantiecategorieën:VERY_LOW,LOW,MEDIUM,HIGH,VERY_HIGH.includeLowRelevance(query, boolean, optioneel): Neem ook vermeldingen op onder de minimumscore van de website (standaard 30).minScore(query, integer, optioneel, 0-100): Alleen vermeldingen met minstens deze score. Vermeldingen zonder score vallen weg. De minimumscore van de website blijft gelden, tenzijincludeLowRelevancetrueis.keywords(query, herhaalbaar, optioneel): Filter op trefwoordwaarden.sources(query, herhaalbaar, optioneel): Bronnen van vermeldingen:REDDIT_POST,REDDIT_COMMENT,TWITTER(X),BLUESKY,HACKERNEWS,FACEBOOK,FACEBOOK_GROUP.sort(query, optioneel): Sorteervolgorde:RELEVANCEofRECENT.from, to(query, ISO string, optioneel): Periode van opname.limit(query, integer, optioneel, 1-500, standaard 50): Paginagrootte.offset(query, integer, optioneel, min. 0, standaard 0): Offset voor paginering.
Request body
Dit endpoint heeft geen JSON-body nodig.
Respons
Geeft gepagineerde openbare Mention-objecten terug.
mentions(Mention[]): Vermeldingen op de huidige pagina.total(number): Totaal aantal overeenkomende vermeldingen.limit(number): Paginagrootte die de respons gebruikt.offset(number): Offset voor paginering die de respons gebruikt.
Mention-object
id(string): UUID van de vermelding.websiteId(string | null): UUID van de website.source(string):REDDIT_POST,REDDIT_COMMENT,TWITTER(X),BLUESKY,HACKERNEWS,FACEBOOKofFACEBOOK_GROUP.keyword(string | null): Waarde van het trefwoord dat overeenkwam.title, contentText, url, author, subreddit(string | null): Context van titel, tekst en link.subredditbevat de subreddit voor Reddit-bronnen en het groeps-id voorFACEBOOK_GROUP, en isnullvoor de andere bronnen.status(string):NEW,APPROVEDofREJECTED.relevanceScore(number | null): AI-relevantiescore van0tot100, ofnull.relevanceReason(string | null): AI-uitleg van de match, ofnull.aiReplySuggestion(string | null): Door AI opgestelde reactie die iemand moet nakijken voordat die wordt geplaatst, ofnull.tags(string[]): Door AI gegenereerde relevantietags.publishedAt, ingestedAt, reviewedAt, createdAt, updatedAt(ISO string | null): Tijdstempels van publicatie, opname, beoordeling, aanmaken en bijwerken in ISO 8601-formaat, ofnull.
Voorbeeldverzoek
curl -s 'https://ai.redreplier.com/ai-app/api/v1/mentions?statuses=NEW&minScore=50&sort=RECENT&limit=20' \
-H 'Authorization: Bearer redreplier_test_1234567890'Opmerkingen
Standaard worden REJECTED vermeldingen weggelaten en worden vermeldingen onder de minimumscore van de website (standaard 30) verborgen. minScore filtert verder en verlaagt die ondergrens nooit zelf. Categorieën: VERY_LOW <10, LOW 10-29, MEDIUM 30-49, HIGH 50-74, VERY_HIGH >=75.
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:code: "subscription_required"als het abonnement van de workspace geen API-toegang bevat,code: "workspace_access_denied"alsX-Workspace-Ideen workspace noemt waar deze inloggegevens geen toegang toe hebben, ofcode: "permission_denied"als 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 GET \
--url https://ai.redreplier.com/ai-app/api/v1/mentions?websiteId=9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10&statuses=NEW&minScore=50&sort=RELEVANCE&limit=25 \
--header 'Authorization: Bearer redreplier_test_1234567890'{
"mentions": [
{
"id": "6a9f0e8b-2c65-44f7-b6e6-7f88a7df8301",
"websiteId": "9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10",
"source": "REDDIT_POST",
"keyword": "agency CRM",
"title": "Best CRM for a small agency?",
"contentText": "We need a lightweight CRM for client follow-ups and deal tracking.",
"url": "https://reddit.com/r/sales/comments/example/best_crm_for_a_small_agency",
"author": "agency_ops",
"subreddit": "sales",
"status": "NEW",
"relevanceScore": 86,
"relevanceReason": "The thread asks for an agency CRM, which directly matches the monitored product category.",
"aiReplySuggestion": "We built Acme CRM for small agencies with exactly this problem. Happy to share how teams set up follow-up reminders.",
"tags": ["recommendation-request", "high-intent"],
"publishedAt": "2026-05-29T09:20:00.000Z",
"ingestedAt": "2026-05-29T09:24:12.000Z",
"reviewedAt": null,
"createdAt": "2026-05-29T09:24:12.000Z",
"updatedAt": "2026-05-29T09:24:12.000Z"
}
],
"total": 1,
"limit": 25,
"offset": 0
}