gtm parallel - GTM SDK

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"

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

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.

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.

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

​Examples

​gtm parallel extract

​gtm parallel extract excerpts

​gtm parallel extract full

​gtm parallel findall

​gtm parallel findall create

​gtm parallel findall result

​gtm parallel findall status

​gtm parallel search

​gtm parallel search query