OverviewPlatformsAPI Reference
Attention

Dismiss an attention item

Put an item away. It leaves the open list and does not come back while its condition lasts; once the condition clears, a new episode may open a new item. Idempotent.

POST
/v1/attention/{id}/dismiss

Authorization

AuthorizationBearer <token>

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

In: header

Path Parameters

idstring

Attention item id (att_...).

Length1 <= length

Response Body

application/json

application/json

application/json

curl -X POST "https://api.mentio.dev/v1/attention/att_abc123/dismiss"
{
  "id": "string",
  "kind": "mention.spike",
  "status": "open",
  "subject": {
    "type": "keyword",
    "id": "string"
  },
  "title": "string",
  "openedAt": "string",
  "resolvedAt": "string",
  "dismissedAt": "string",
  "data": {
    "attentionId": "string",
    "url": "string",
    "keyword": {
      "id": "string",
      "term": "string",
      "kind": "brand",
      "name": "string",
      "groupId": "string"
    },
    "window": {
      "from": "string",
      "to": "string"
    },
    "matches": 0,
    "relevant": 0,
    "baseline": {
      "meanPerHour": 0,
      "stddevPerHour": 0,
      "hours": 0
    }
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}

Brand against competitors GET

Every keyword matched in the window with its counts and its share of brand plus competitor matches; topic keywords are counted but stay out of the split. The window is `range` (7d, 30d, 90d, 365d, ending today) or `from` and `to`, cut into days in `timezone` (UTC by default); `keywordIds` and `platforms` narrow it; `compare=true` adds the period of the same length right before it. Time axis is the publish date.

List attention items GET

What needs a person, newest first: a keyword whose mentions spiked in the last hour (mention.spike), whose negative share of the last 24 hours jumped (sentiment.negative_spike), that turned noisy (keyword.noisy), or a channel whose last sends all failed (channel.failing). Detected once an hour; an item opens when its condition starts and resolves on its own when the condition is gone. Open items by default; `status=all` reads the history. Each opening is also an account event of the same name, which webhook, Slack, email and Telegram channels can subscribe to.