API-ReferenzPOST

Mention erklären

Erzeugt oder lädt KI-Relevanzbegründung und Tags für eine Mention.

POSThttps://ai.redreplier.com/ai-app/api/v1/mentions/{mentionId}/explain

Erzeugt oder lädt KI-Relevanzbegründung und Tags für eine Mention.

Bearer-Token (RedReplier-API-Token)

Authentifizierung

Sende bei jeder Anfrage ein RedReplier-API-Token als Bearer-Token. Tokens beginnen mit redreplier_; RedReplier ermittelt das Konto aus dem Token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parameter

  • mentionId (Pfad, UUID, erforderlich): Mention, die erklärt wird.

Request-Body

Dieser Endpoint benötigt keinen JSON-Body.

Antwort

Gibt ein öffentliches Mention-Objekt mit relevanceReason und tags zurück oder null, wenn die Mention nicht verfügbar ist.

  • id (string): Mention-UUID.
  • websiteId (string | null): Website-UUID.
  • source (string): REDDIT_POST, REDDIT_COMMENT, TWITTER (X), BLUESKY oder HACKERNEWS.
  • keyword (string | null): Keyword-Wert, der gepasst hat.
  • title, contentText, url, author, subreddit (string | null): Kontext für Titel, Inhalt und Link. subreddit wird nur für Reddit-Quellen gesetzt und ist null für X, Bluesky und Hacker News.
  • status (string): NEW, APPROVED oder REJECTED.
  • relevanceScore (number | null): KI-Relevanzscore von 0 bis 100 oder null.
  • relevanceReason (string | null): KI-Erklärung für den Treffer oder null.
  • tags (string[]): KI-generierte Relevanz-Tags.
  • publishedAt, ingestedAt, reviewedAt, createdAt, updatedAt (ISO string | null): Zeitpunkte für Veröffentlichung, Ingestion, Review, Erstellung und Aktualisierung im ISO-8601-Format oder null.

Beispielanfrage

curl -X POST https://ai.redreplier.com/ai-app/api/v1/mentions/33333333-3333-4333-8333-333333333333/explain \
  -H 'Authorization: Bearer redreplier_test_1234567890'

Hinweise

Wenn die Erklärung noch nicht existiert, erzeugt RedReplier sie verzögert.

Fehler

  • 400 Bad Request: Ungültige Eingabe, URL, UUID, Enum, Query-Parameter oder Body.
  • 401 Unauthorized: Fehlendes oder ungültiges Bearer-Token.
  • 404 Not Found: Die Ressource existiert nicht für das Token-Konto.
  • 500 Internal Server Error: Unerwarteter Serverfehler.
Beispielanfrage (curl)
curl --request POST \
  --url https://ai.redreplier.com/ai-app/api/v1/mentions/6a9f0e8b-2c65-44f7-b6e6-7f88a7df8301/explain \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "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.",
  "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"
}