---
title: "Search commands"
description: "Search any term over the last 24 hours, 7 or 30 days without a keyword, follow the search and read its scored results."
canonical: https://docs.mentio.dev/cli/searches
markdown: https://docs.mentio.dev/cli/searches.mdx
---

# Search commands

Search any term over the last 24 hours, 7 or 30 days without a keyword, follow the search and read its scored results.

Search any term over the last 24 hours, 7 or 30 days without a keyword, follow the search and read its scored results. 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 searches:create --term globex --range 30d --kind competitor --platforms reddit,hackernews
mentio searches:get srch_4b1e...
mentio searches:results srch_4b1e... --minRelevance 40 --limit 25
mentio searches:list
```

| Command                        | What it does            | Flags                                                                                    |
| ------------------------------ | ----------------------- | ---------------------------------------------------------------------------------------- |
| `mentio searches:create`       | Start a search          | `--idempotency-key`, `--term`, `--range`, `--platforms`, `--kind`, `--context`, `--json` |
| `mentio searches:get <id>`     | Get a search            |                                                                                          |
| `mentio searches:list`         | List searches           | `--limit`, `--cursor`                                                                    |
| `mentio searches:results <id>` | List a search's results | `--limit`, `--cursor`, `--minRelevance`                                                  |