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

# Commands

> Complete reference for the akta CLI

## Account

```bash theme={null}
akta-pro account   # check tier + credits
```

| Command            | Notes                      |
| ------------------ | -------------------------- |
| `akta-pro account` | your tier + credit balance |

## Company

Resolve a company, then pull a concise overview or a section-by-section Markdown profile.

```bash theme={null}
# Resolve a name to a uuid — run this first
akta-pro company search "Canva"

# Rendered Markdown profile
akta-pro company data canva.com -s firmographic -s technology

# Raw Markdown (pipe/save)
akta-pro company data canva.com -s firmographic --raw

# Slimmed JSON overview
akta-pro company concise canva.com
```

| Command                                  | Notes                             |
| ---------------------------------------- | --------------------------------- |
| `akta-pro company search <query>`        | run first; returns `uuid`         |
| `akta-pro company data <company> -s ...` | Markdown; requires ≥1 `--section` |
| `akta-pro company concise <company>`     | slimmed JSON                      |

<Accordion title="company data sections">
  Each section is billed separately: `firmographic`, `business_model`, `company_assessment`, `trust_signal`, `company_hierarchy`, `digital_presence`, `financial_estimate`, `location`, `management_profile`, `product_offering`, `strategic_signal`, `customer_profile`, `industry`, `technology`, plus enterprise-only `funding_detail` and `mna_and_investment`.

  There is no `"all"` — choose explicitly. The two enterprise sections are auto-skipped (not an error).
</Accordion>

## Industry

```bash theme={null}
akta-pro industry search "warehouse automation"
```

| Command                            | Notes                                |
| ---------------------------------- | ------------------------------------ |
| `akta-pro industry search <query>` | codes feed `news signals --industry` |

## News

```bash theme={null}
# Find type codes
akta-pro news types

# Product-launch news
akta-pro news signals --company canva.com -t SD01 -n 20

# Filter by free-text query, pipe as JSON
akta-pro news signals --query "crude oil prices" --json | jq '.data[].id'

# Full bodies for specific ids
akta-pro news detail 12345 12346
```

| Command                           | Notes                                                                           |
| --------------------------------- | ------------------------------------------------------------------------------- |
| `akta-pro news signals [filters]` | needs ≥1 of `--company`/`--industry`/`--query`/`--title`; compact list with ids |
| `akta-pro news detail <id>...`    | full bodies for ids from signals (max 10)                                       |
| `akta-pro news types`             | tag codes for `--type-code`; offline, no key                                    |

## Alternative signals

Headcount, traffic, hiring, social, and review data. All require **Subscription or Enterprise** — Pay-as-you-go returns `403`.

```bash theme={null}
akta-pro headcount canva.com

akta-pro reviews products canva.com               # list catalog + ids
akta-pro reviews products canva.com --product-id p_123 -n 50
```

| Command                                | Endpoint                    | Notes                              |
| -------------------------------------- | --------------------------- | ---------------------------------- |
| `akta-pro headcount <company>`         | `/company/headcount-trends` | Subscription/Enterprise            |
| `akta-pro traffic <company>`           | `/company/website-traffic`  | Subscription/Enterprise            |
| `akta-pro jobs <company>`              | `/company/jobs`             | Subscription/Enterprise            |
| `akta-pro posts <company>`             | `/company/posts`            | Subscription/Enterprise            |
| `akta-pro reviews employees <company>` | `/company/employee-reviews` | Subscription/Enterprise            |
| `akta-pro reviews products <company>`  | `/company/product-reviews`  | catalog first, then `--product-id` |

<Note>
  Run `akta-pro <command> --help` for every flag.
</Note>

## Non-Interactive Mode

All commands support `--json` output and can be fully controlled via CLI arguments and flags.

**Default (TTY):** a Rich table for list results (search, industry, news), rendered Markdown for company data, and pretty-printed JSON for nested objects.

```bash theme={null}
# Clean, unstyled JSON on stdout (valid for | jq)
akta-pro news signals --query "crude oil prices" --json | jq '.data[].id'

# Applied automatically when stdout is piped/redirected
akta-pro company search "Canva" > results.json

# For company data, --json (alias --raw) emits the raw Markdown
akta-pro company data canva.com -s firmographic --json

# Write the raw JSON/text payload to a file
akta-pro company concise canva.com -o canva.json
```

| Flag                | Behavior                                                                                                                                                  |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--json`            | Clean, unstyled JSON on stdout. Applied automatically when stdout is piped/redirected. For company data, `--json` (alias `--raw`) emits the raw Markdown. |
| `-o, --output FILE` | Writes the raw JSON/text payload to a file.                                                                                                               |
| `-q, --quiet`       | Silences `credits_consumed`, which is otherwise printed to stderr so it never pollutes piped JSON.                                                        |
