Use when the user wants Parallel to discover a set of people, companies, products, or other entities matching natural-language criteria. Use Data Enrichment when the input entities are already known.
Preview the interpreted schema without starting a run:
parallel-cli findall run \
"Find YC companies in developer tools" \
--dry-run \
--json
Review the inferred entity type and match conditions before an expensive or high-volume run.
parallel-cli findall run \
"Find AI startups in healthcare" \
--generator core \
--match-limit 25 \
--json
Generator tiers are base, core (default), and pro; higher tiers are generally more thorough and expensive. Match limits range from 5 to 1,000.
Exclude known entities with a reviewed JSON array:
parallel-cli findall run \
"Find AI startups in healthcare" \
--exclude '[{"name":"Example Corp","url":"example.com"}]' \
--json
Construct --exclude with a JSON serializer. Do not interpolate raw user text into shell source.
parallel-cli findall run \
"Find AI startups in healthcare" \
--match-limit 100 \
--no-wait \
--json
Record the exact returned run ID. Depending on the CLI/API generation it may begin with findall_ or frun_; reject whitespace or shell metacharacters.
parallel-cli findall status "findall_xxx" --json
parallel-cli findall poll "findall_xxx" \
--timeout 540 \
-o "healthcare-ai-startups.json" \
--json
parallel-cli findall result "findall_xxx" --json
Poll at most three times. If the run is still incomplete after 27 minutes total, stop and report its status and ID.
Cancel only when the user requests it or when an already authorized run must be stopped to control cost:
parallel-cli findall cancel "findall_xxx"
Confirm the ID and explain that cancellation stops the running job before executing it.