---
title: "Mentions commands"
description: "Search, read, triage and export mentions, and follow the feed live."
canonical: https://docs.mentio.dev/cli/mentions
markdown: https://docs.mentio.dev/cli/mentions.mdx
---

# Mentions commands

Search, read, triage and export mentions, and follow the feed live.

Search, read, triage and export mentions, and follow the feed live. Generated from the same OpenAPI document as the [API Reference](/api); ids are positional, every other input is a flag named as in the API, and each flag is described there. Global flags: `--api-key`, `--api-url`, `--pretty`, `--table`.

```bash
mentio mentions:search --relevant true --sentiment negative --limit 20
mentio mentions:get mm_7f3a...
mentio mentions:update mm_7f3a... --status done --note "Replied in the thread"
mentio mentions:update mm_7f3a... --relevant false
mentio mentions:search --languages es --isReply false --minFollowers 1000
mentio mentions:export --since 2026-09-01 --platform reddit --out mentions.csv
mentio mentions:watch --platform reddit --relevant true | jq -r '.post.url'
```

| Command                       | What it does                                                 | Flags                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ----------------------------- | ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `mentio mentions:export`      | Export mentions as CSV                                       | `--keywordId`, `--platform`, `--status`, `--relevant`, `--sentiment`, `--intent`, `--automated`, `--personId`, `--includeMuted`, `--assigneeId`, `--snoozed`, `--excludeAuthors`, `--minRelevance`, `--minFollowers`, `--maxFollowers`, `--isReply`, `--alertId`, `--tags`, `--linkHosts`, `--platforms`, `--notPlatforms`, `--keywordIds`, `--notKeywordIds`, `--sentiments`, `--notSentiments`, `--intents`, `--notIntents`, `--notLinkHosts`, `--notTags`, `--languages`, `--notLanguages`, `--q`, `--since`, `--until`, `--out`                         |
| `mentio mentions:get <id>`    | Get a mention                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `mentio mentions:search`      | List mentions                                                | `--keywordId`, `--platform`, `--status`, `--relevant`, `--sentiment`, `--intent`, `--automated`, `--personId`, `--includeMuted`, `--assigneeId`, `--snoozed`, `--excludeAuthors`, `--minRelevance`, `--minFollowers`, `--maxFollowers`, `--isReply`, `--alertId`, `--tags`, `--linkHosts`, `--platforms`, `--notPlatforms`, `--keywordIds`, `--notKeywordIds`, `--sentiments`, `--notSentiments`, `--intents`, `--notIntents`, `--notLinkHosts`, `--notTags`, `--languages`, `--notLanguages`, `--q`, `--since`, `--until`, `--sort`, `--cursor`, `--limit` |
| `mentio mentions:update <id>` | Update a mention                                             | `--status`, `--assigneeId`, `--snoozedUntil`, `--note`, `--relevant`, `--sentiment`, `--json`                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `mentio mentions:watch`       | Follow the feed: one JSON line per new mention, oldest first | the `mentions:search` filters, `--interval`, `--from-start`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |