---
title: "List mentions"
description: "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."
canonical: https://docs.mentio.dev/api/mentions/search-mentions
markdown: https://docs.mentio.dev/api/mentions/search-mentions.mdx
---

# List mentions

`GET /v1/mentions`

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.

## Parameters

- `keywordId` (query): Only matches of this keyword.
- `platform` (query): Only posts from this platform.
- `status` (query): Only mentions in this status. Omit for every status.
- `relevant` (query): true: only mentions the classifier scored relevant; false: only the rest (unclassified included).
- `sentiment` (query): Only this sentiment.
- `intent` (query): Only mentions carrying this intent (buy_intent, question, complaint, praise, comparison).
- `automated` (query): true: only mentions that read as machine-made (a bot account, a scheduled or templated post, AI-written text); false: only the rest, mentions judged before this existed included. Omitted: everything.
- `personId` (query): Only this person (an id from /v1/people), merged accounts included. Implies includeMuted.
- `includeMuted` (query): true: include mentions by people you muted, hidden by default.
- `assigneeId` (query): Only mentions assigned to this workspace member (user id).
- `snoozed` (query): true: only mentions currently snoozed. Otherwise snoozed mentions stay out until they wake.
- `excludeAuthors` (query): Hide these authors: display names, handles or profile URLs. Repeatable, or one comma-separated value.
- `minRelevance` (query): Only mentions scored at least this; unclassified ones are excluded.
- `minFollowers` (query): Only authors with at least this many followers. Unknown reach never passes.
- `maxFollowers` (query): Only authors with at most this many followers. Unknown reach never passes.
- `isReply` (query): true: only replies and comments (posts answering another post); false: only top-level posts. Omitted: both.
- `alertId` (query): Apply an alert rule's filter (an id from GET /v1/alerts) on top of the other filters: the same mentions the rule would send, for a feed-shaped export or a preview. Unknown ids are a 404.
- `tags` (query): Only authors your workspace tagged with any of these (exact, case-sensitive). Repeatable, or comma-separated.
- `linkHosts` (query): Only posts linking to any of these hosts, the host itself or a subdomain of it (octolens.com also matches blog.octolens.com). Repeatable, or comma-separated.
- `platforms` (query): Only posts from any of these platforms.
- `notPlatforms` (query): Never posts from these platforms.
- `keywordIds` (query): Only matches of any of these keywords.
- `notKeywordIds` (query): Never matches of these keywords.
- `sentiments` (query): Only these sentiments.
- `notSentiments` (query): Never these sentiments. A mention the classifier has not scored yet still passes.
- `intents` (query): Only mentions carrying any of these intents.
- `notIntents` (query): Never mentions carrying these intents.
- `notLinkHosts` (query): Never posts linking to these hosts, the host itself or a subdomain of it.
- `notTags` (query): Never authors your workspace tagged with any of these.
- `languages` (query): Only posts in any of these languages (ISO 639-1: en, es, de). A post whose language is unknown never passes.
- `notLanguages` (query): Never posts in these languages. A post whose language is unknown still passes.
- `q` (query): Substring search in the post text or the author's name.
- `since` (query): Only posts published at or after this instant (ISO 8601, or epoch ms).
- `until` (query): Only posts published at or before this instant (ISO 8601, or epoch ms).
- `sort` (query): newest: by match time, newest first. priority: by attention score, highest first; priority ranks the last 30 days of matches only, older ones stay reachable under newest. Cursors are specific to a sort.
- `cursor` (query): nextCursor from the previous page; pass the same filters and sort.
- `limit` (query): Page size, 1 to 100.

## Responses

- 200: One page of mentions in the requested order
- 400: Invalid query or pagination cursor
- 401: Missing or invalid API key

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx