OverviewPlatformsAPI Reference
Mentions

Get a mention

One mention by id, as it appears in the list: the post, its author with reach and your tags, the classification, the priority score and the triage fields. Ids belong to your organization; any other id is a 404.

GET
/v1/mentions/{id}

Authorization

AuthorizationBearer <token>

API key minted via POST /v1/api-keys (format mk_live_...)

In: header

Path Parameters

idstring

Mention id (mm_...).

Length1 <= length

Response Body

application/json

application/json

application/json

curl -X GET "https://api.mentio.dev/v1/mentions/mm_abc123"
{
  "id": "string",
  "status": "open",
  "relevant": true,
  "delivered": true,
  "priority": 0,
  "keyword": {
    "id": "string",
    "term": "string",
    "group": {
      "id": "string",
      "name": "string",
      "externalId": "string",
      "isDefault": true
    },
    "matchedAs": "phrase",
    "matchedIn": "text"
  },
  "post": {
    "platform": "bluesky",
    "kind": "post",
    "url": "string",
    "text": "string",
    "title": "string",
    "imageUrl": "string",
    "subreddit": "string",
    "flair": "string",
    "repository": {
      "name": "string",
      "event": "new",
      "stars": 0,
      "weeklyStars": 0
    },
    "links": [
      "string"
    ],
    "publishedAt": "string",
    "engagement": {
      "likes": 0,
      "reposts": 0,
      "replies": 0,
      "quotes": 0,
      "views": 0,
      "bookmarks": 0
    },
    "replyTo": {
      "author": "string",
      "url": "string",
      "text": "string"
    }
  },
  "parentMentionId": "string",
  "author": {
    "id": "string",
    "name": "string",
    "handle": "string",
    "url": "string",
    "avatarUrl": "string",
    "followers": 0,
    "tags": [
      "string"
    ]
  },
  "review": {
    "rating": 1,
    "ratingMax": 0,
    "title": "string",
    "version": "string",
    "country": "string",
    "verified": true,
    "response": "string",
    "responseAt": "string",
    "app": {
      "platform": "appstore",
      "id": "string",
      "url": "string"
    }
  },
  "classification": {
    "relevance": 100,
    "sentiment": "positive",
    "intents": [
      "string"
    ],
    "automated": true,
    "language": "string",
    "country": "string",
    "organization": true,
    "confidence": 1,
    "uncertain": true,
    "note": "string",
    "failed": true,
    "feedback": {
      "relevant": true,
      "sentiment": "positive",
      "at": "string",
      "original": {
        "relevance": 100,
        "sentiment": "positive"
      }
    }
  },
  "triage": {
    "assignee": {
      "id": "string",
      "name": "string",
      "email": "string"
    },
    "snoozedUntil": "string",
    "note": "string"
  },
  "duplicateOf": "string",
  "duplicates": [
    {
      "id": "string",
      "platform": "bluesky",
      "url": "string",
      "publishedAt": "string"
    }
  ],
  "stats": {
    "comments": 0
  },
  "createdAt": "string"
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}

Export mentions as JSON GET

The same mentions GET /v1/mentions would list for these filters, in one response, newest matched first (the order they entered your feed): every row is the full Mention object the list returns, text included. Capped at 10,000 mentions; `truncated` (and the X-Mentions-Truncated header) says when the cap cut the list. Shares the CSV export's limit: at most 6 exports per minute per workspace, either format; a 429 carries Retry-After.

List the comments of a mention GET

The comments under a mention's post, newest first: every comment in the thread, whether or not it names your keyword. Read once, about a day after the post, for mentions scored relevant whose keyword has comments enabled (keywords.comments), on Hacker News, Bluesky, GitHub, Stack Overflow, DEV, YouTube and Reddit; empty before that and for other keywords. Each comment delivered costs $0.008 on the comments line of the bill, once per workspace. A comment that itself names one of your keywords is also a mention: `mentionId` links it. Two mentions of one post (two keywords) list the same thread.