OverviewPlatformsAPI Reference
Mentions

Get a mention

Fetches one mention by id, with the same fields the list returns. An id from another workspace gets a 404.

GET
/v1/mentions/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

An API key from POST /v1/api-keys. Keys start with ref_.

In: header

Path Parameters

id*string

Mention id (mm_...).

Length1 <= length

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/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    }  },  "post": {    "platform": "bluesky",    "url": "string",    "text": "string",    "title": "string",    "imageUrl": "string",    "links": [      "string"    ],    "publishedAt": "string",    "engagement": {      "likes": 0,      "reposts": 0,      "replies": 0,      "quotes": 0,      "views": 0,      "bookmarks": 0    },    "replyTo": {      "author": "string",      "url": "string",      "text": "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": 0,    "sentiment": "positive",    "intents": [      "string"    ],    "automated": true,    "language": "string",    "confidence": 0,    "uncertain": true,    "note": "string",    "failed": true,    "feedback": {      "relevant": true,      "sentiment": "positive",      "at": "string",      "original": {        "relevance": 0,        "sentiment": "positive"      }    }  },  "triage": {    "assignee": {      "id": "string",      "name": "string",      "email": "string"    },    "snoozedUntil": "string",    "note": "string"  },  "createdAt": "string"}
Was this page helpful?

Export mentions as JSON

Returns in one response the mentions GET /v1/mentions lists for the same filters, latest match first, which is the order they reached your feed. Each row is the full Mention object from the list, text included. At most 10,000 mentions are returned, and `truncated` tells you when some were cut. It shares the CSV export's limit of 6 exports a minute per workspace, in either format, and a 429 includes Retry-After.

List mentions

Lists your keywords' mentions with filters and paging. Each mention pairs one post with one keyword. Latest match first by default, or sort=priority to rank the last 30 days by attention score. For the next page, send nextCursor and keep the filters and sort. alertId applies an alert's filter, giving what that alert would send. anyOf adds OR groups as URL-encoded JSON, at least one of which must match along with every other filter.