> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geogen.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Competitors

> See how your entity ranks against competitors in LLM mentions

## `geogen competitors`

Competitor visibility leaderboard. Maps to [`GET /v1/competitors`](/api-reference/competitors).

```bash theme={null}
geogen competitors --entity ent_123 --period 30d
```

Options:

| Flag                                      | Description                                  |
| ----------------------------------------- | -------------------------------------------- |
| `--entity <id>`                           | Entity ID (required)                         |
| `--period <period>`                       | `7d`, `14d`, or `30d`                        |
| `--start-date <iso>` / `--end-date <iso>` | Custom date range                            |
| `--models <uuids>`                        | Comma-separated model UUIDs                  |
| `--competitors-only`                      | Exclude your own entity from the leaderboard |
| `--limit <n>`                             | Max results                                  |
| `--offset <n>`                            | Pagination offset                            |

Columns: `rank`, `name`, `visibility%`, `mentions`.

```bash theme={null}
# Top 10 competitors only, last 14 days, JSON output
geogen --json competitors \
  --entity ent_123 \
  --period 14d \
  --competitors-only \
  --limit 10
```