# logion listings

1 command in this group.

- [`logion listings search`](#logion-listings-search)

## logion listings search

```bash
logion listings search [--api-key API_KEY] [--base-url BASE_URL] [--json] [--timeout TIMEOUT] [--max-retries MAX_RETRIES] [--no-onboarding] [--query QUERY] [--tag TAG_FILTERS] [--tags TAGS] [--category CATEGORY] [--language LANGUAGE] [--price-min PRICE_MIN] [--price-max PRICE_MAX] [--sort SORT] [--limit LIMIT] [--verbose] [--cursor CURSOR] [--include-indexed] [--tier TIER]
```

| Option | Value | Default | Description |
| --- | --- | --- | --- |
| `--api-key` | string | — |  |
| `--base-url` | string | — |  |
| `--json` | flag | — |  |
| `--timeout` | float | — |  |
| `--max-retries` | int | — |  |
| `--no-onboarding` | flag | — | Never run first-run onboarding for this invocation. |
| `--query` | string | — |  |
| `--tag` | string | — | Filter by tag (repeatable; AND semantics) |
| `--tags` | string | — | Filter by tags (comma-separated; use --tag instead) |
| `--category` | string | — |  |
| `--language` | string | — |  |
| `--price-min` | int | — |  |
| `--price-max` | int | — |  |
| `--sort` | relevance \| newest \| recently_updated \| price_low \| price_high \| most_useful | — |  |
| `--limit` | int | `5` |  |
| `--verbose` | flag | — |  |
| `--cursor` | string | — |  |
| `--include-indexed` | flag | — | Include indexed external listings in search results |
| `--tier` | published \| indexed \| improving | — | Filter by listing tier: published (default), indexed, or improving |

**Calls**

- [`search_listings`](/docs/api/listings#search-listings)