OverviewAPI 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"
  },
  "post": {
    "platform": "bluesky",
    "url": "string",
    "text": "string",
    "links": [
      "string"
    ],
    "publishedAt": "string",
    "replyTo": {
      "author": "string",
      "url": "string",
      "text": "string"
    }
  },
  "author": {
    "id": "string",
    "name": "string",
    "handle": "string",
    "url": "string",
    "avatarUrl": "string",
    "followers": 0,
    "tags": [
      "string"
    ]
  },
  "classification": {
    "relevance": 100,
    "sentiment": "positive",
    "intents": [
      "string"
    ],
    "automated": true,
    "language": "string",
    "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"
  },
  "createdAt": "string"
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}

Export mentions as CSV GET

The same mentions GET /v1/mentions would list for these filters, as CSV, newest matched first (the order they entered your feed, which can differ from the post date): id, published_at, platform, keyword, author, author_url, author_followers, relevance, sentiment, intents (pipe-separated), status, relevant, delivered, url, text (first 1,000 characters). Capped at 10,000 rows; the X-Mentions-Truncated header says when the cap cut the list. At most 6 exports per minute per workspace; a 429 carries Retry-After.

List mentions GET

Mentions matched to your keywords, filtered and paginated. Default order is newest match first; sort=priority ranks the last 30 days of matches by attention score. Page with nextCursor, passing the same filters and sort. A mention is one post matched to one keyword. alertId applies an alert rule's filter on top of the others: the same mentions that rule would send.