API-referentieGET

Vermeldingen weergeven

Geef door AI gescoorde vermeldingen van Reddit, Hacker News, X, Bluesky en Facebook weer, met filters en paginering.

GEThttps://ai.redreplier.com/ai-app/api/v1/mentions

Geef door AI gescoorde vermeldingen van Reddit, Hacker News, X, Bluesky en Facebook weer, met filters en paginering.

Bearer-token (RedReplier API-token)

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/json

Parameters

  • 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, tenzij includeLowRelevance true is.
  • 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: RELEVANCE of RECENT.
  • 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, FACEBOOK of FACEBOOK_GROUP.
  • keyword (string | null): Waarde van het trefwoord dat overeenkwam.
  • title, contentText, url, author, subreddit (string | null): Context van titel, tekst en link. subreddit bevat de subreddit voor Reddit-bronnen en het groeps-id voor FACEBOOK_GROUP, en is null voor de andere bronnen.
  • status (string): NEW, APPROVED of REJECTED.
  • relevanceScore (number | null): AI-relevantiescore van 0 tot 100, of null.
  • relevanceReason (string | null): AI-uitleg van de match, of null.
  • aiReplySuggestion (string | null): Door AI opgestelde reactie die iemand moet nakijken voordat die wordt geplaatst, of null.
  • 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, of null.

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, of code: "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" als X-Workspace-Id een workspace noemt waar deze inloggegevens geen toegang toe hebben, of code: "permission_denied" als 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 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'
200
{
  "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
}