Skip to main content
Parallel is a real-time web search and content extraction platform built for LLMs and AI applications.
ParallelFindAllTool calls Parallel’s FindAll API for entity discovery. Given a natural-language objective and a list of boolean match conditions, it returns ranked candidates that satisfy every condition.

Overview

Integration details

Setup

The integration lives in the langchain-parallel package.

Credentials

Head to Parallel to sign up and generate an API key. Set PARALLEL_API_KEY in your environment:

Instantiation

generator is a tool-level setting. Use "preview" (free, capped at 10 candidates) for rapid iteration; switch to "base" (the default), "core", or "pro" for higher-quality runs.

Invocation

Quick discovery (preview generator)

The preview generator returns in seconds and is capped at 10 candidates. match_limit is required; for preview it must be in [5, 10].

Higher-quality runs

Switch to "base", "core", or "pro" for match_limit up to 1000. These take minutes; the tool polls until the run hits a terminal status (completed, cancelled, or failed).

Excluding seen candidates

Pass exclude_list=[FindAllExcludeEntry(name=..., url=...)] to drop candidates you’ve already processed. Both name and url are required.

Cancellation

cancel() aborts an in-flight run by id. The id is returned to the caller that started the run; if you started it with tool.ainvoke(...) in a long-running task, capture findall_id from the run before awaiting completion.

Parameters

Required

  • objective: natural-language description of what to find.
  • entity_type: short noun describing the candidate class ("company", "researcher", "product", etc.).
  • match_conditions: list of FindAllMatchCondition(name=..., description=...). Both fields are required on each.
  • match_limit: integer in [5, 1000]. The preview generator further caps this at 10.

Optional

  • exclude_list: list of FindAllExcludeEntry(name=..., url=...) to skip.
  • webhook: FindAllWebhook(url=..., event_types=[...]) to receive run/candidate events.
  • metadata: free-form metadata persisted on the run.
  • timeout: polling timeout in seconds (default 600).

Chaining

Bind the tool to any tool-calling chat model and drive an agent with create_agent:

Response format

API reference

For detailed documentation, head to the ParallelFindAllTool API reference or the Parallel FindAll API guides.