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

# gtm parallel

> Command reference for gtm parallel — Parallel API commands. Generated from the CLI help text.

Parallel API commands.

Every command follows the [CLI contract](/concepts/cli-contract): JSON on stdout, errors on stderr, and command-specific mutation safety controls. Keys resolve as described in [Secrets and API keys](/secrets).

## Examples

Search the web, extract content, or run an entity-discovery job:

```bash theme={"system"}
uv run gtm parallel search query "best CRM for startups" --mode agentic --max 15
```

```bash theme={"system"}
uv run gtm parallel extract excerpts "https://acme.dev/pricing" \
  "Extract pricing tiers and features"
```

FindAll runs are asynchronous — create, poll, then fetch results:

```bash theme={"system"}
uv run gtm parallel findall create \
  "Find YC-backed AI startups founded in 2024" \
  "company" \
  '[{"field": "funding", "operator": "contains", "value": "YC"}]' \
  --limit 50

uv run gtm parallel findall status <FINDALL_ID>
uv run gtm parallel findall result <FINDALL_ID>
```

## `gtm parallel extract`

Extract content from URLs using Parallel API.

### `gtm parallel extract excerpts`

Extract focused excerpts from a URL matching an objective.

```bash theme={"system"}
uv run gtm parallel extract excerpts [OPTIONS] [URL] [OBJECTIVE]
```

| Argument    | Type | Required |
| ----------- | ---- | -------- |
| `URL`       | text | no       |
| `OBJECTIVE` | text | no       |

| Option               | Type | Default | Description                                       |
| -------------------- | ---- | ------- | ------------------------------------------------- |
| `--json`             | text | —       | JSON payload (overrides flags)                    |
| `--parallel-api-key` | text | —       | Override the Parallel API key for this invocation |

### `gtm parallel extract full`

Extract full content from a URL.

```bash theme={"system"}
uv run gtm parallel extract full [OPTIONS] [URL]
```

| Argument | Type | Required |
| -------- | ---- | -------- |
| `URL`    | text | no       |

| Option               | Type | Default | Description                                       |
| -------------------- | ---- | ------- | ------------------------------------------------- |
| `--json`             | text | —       | JSON payload (overrides flags)                    |
| `--parallel-api-key` | text | —       | Override the Parallel API key for this invocation |

## `gtm parallel findall`

Discover entities using Parallel FindAll API.

### `gtm parallel findall create`

Start a FindAll entity discovery run.

```bash theme={"system"}
uv run gtm parallel findall create [OPTIONS] [OBJECTIVE] [ENTITY_TYPE]
                                   [CONDITIONS]
```

| Argument      | Type | Required |
| ------------- | ---- | -------- |
| `OBJECTIVE`   | text | no       |
| `ENTITY_TYPE` | text | no       |
| `CONDITIONS`  | text | no       |

| Option               | Type    | Default | Description                                       |
| -------------------- | ------- | ------- | ------------------------------------------------- |
| `--limit, -n`        | integer | `10`    | Max matches (5-1000)                              |
| `--generator, -g`    | text    | `base`  | Generator: base, core, pro, preview               |
| `--json`             | text    | —       | JSON payload (overrides flags)                    |
| `--parallel-api-key` | text    | —       | Override the Parallel API key for this invocation |

### `gtm parallel findall result`

Get results from a completed FindAll run.

```bash theme={"system"}
uv run gtm parallel findall result [OPTIONS] [FINDALL_ID]
```

| Argument     | Type | Required |
| ------------ | ---- | -------- |
| `FINDALL_ID` | text | no       |

| Option               | Type | Default | Description                                       |
| -------------------- | ---- | ------- | ------------------------------------------------- |
| `--json`             | text | —       | JSON payload (overrides flags)                    |
| `--parallel-api-key` | text | —       | Override the Parallel API key for this invocation |

### `gtm parallel findall status`

Check the status of a FindAll run.

```bash theme={"system"}
uv run gtm parallel findall status [OPTIONS] [FINDALL_ID]
```

| Argument     | Type | Required |
| ------------ | ---- | -------- |
| `FINDALL_ID` | text | no       |

| Option               | Type | Default | Description                                       |
| -------------------- | ---- | ------- | ------------------------------------------------- |
| `--json`             | text | —       | JSON payload (overrides flags)                    |
| `--parallel-api-key` | text | —       | Override the Parallel API key for this invocation |

## `gtm parallel search`

Search the web using Parallel API.

### `gtm parallel search query`

Search the web for a given objective.

```bash theme={"system"}
uv run gtm parallel search query [OPTIONS] [OBJECTIVE]
```

| Argument    | Type | Required |
| ----------- | ---- | -------- |
| `OBJECTIVE` | text | no       |

| Option               | Type    | Default    | Description                                       |
| -------------------- | ------- | ---------- | ------------------------------------------------- |
| `--mode, -m`         | text    | `one-shot` | Search mode: one-shot, agentic, fast              |
| `--max, -n`          | integer | `10`       | Max results (1-20)                                |
| `--json`             | text    | —          | JSON payload (overrides flags)                    |
| `--parallel-api-key` | text    | —          | Override the Parallel API key for this invocation |


## Related topics

- [CLI overview](/cli/index.md)
- [gtm-sdk: Go-To-Market SDK and CLI for Modal](/index.md)
- [gtm accounts](/cli/accounts.md)
- [Quickstart: install gtm-sdk and run your first command](/quickstart.md)
- [Secrets and API keys](/secrets.md)