Parallel API commands.
Every command follows the CLI contract: JSON on stdout, errors on stderr, and command-specific mutation safety controls. Keys resolve as described in Secrets and API keys.
Examples
Search the web, extract content, or run an entity-discovery job:
uv run gtm parallel search query "best CRM for startups" --mode agentic --max 15
uv run gtm parallel extract excerpts "https://acme.dev/pricing" \
"Extract pricing tiers and features"
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>
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 |
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.
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.
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.
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.
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 |
Last modified on July 14, 2026
