Parallel

Parallel FindAll API

The FindAll API discovers and evaluates entities that match complex criteria from natural language objectives. Submit a high-level goal and the service automatically generates structured match conditions, discovers relevant candidates, and evaluates each against the criteria. Returns comprehensive results with detailed reasoning, citations, and confidence scores for each match decision. Streaming events and webhooks are supported.

GitHub OpenAPI

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v1beta/findall/entity-search Quickly search for ranked entities · Fast Entity Search #
Ask an LLM
“Is there a fast, low-latency way to get a ranked list of companies matching a plain-language description?”
“How many entities can a quick entity search return at most?”
Tell an agent
Do a fast entity search for {entity_type} matching {objective}.
Quickly rank up to {match_limit} {entity_type} that fit {objective}.
POST /v1beta/findall/ingest Turn an objective into a FindAll run spec · Ingest FindAll Run #
Ask an LLM
“Can I turn a plain-English goal into a suggested FindAll specification before starting a run?”
“What does the generated FindAll spec give me to customize, like entity type and match conditions?”
Tell an agent
Draft a FindAll run spec from this objective: {objective}.
Convert {objective} into structured FindAll match conditions I can edit before running.
POST /v1beta/findall/runs Start a FindAll run to discover entities · Create FindAll Run #
Ask an LLM
“How do I kick off a FindAll run to find every company that meets my criteria?”
“Which generators can a FindAll run use, such as base, core or pro?”
Tell an agent
Start a FindAll run for {entity_type} matching {objective} with conditions {match_conditions}, using the {generator} generator and up to {match_limit} matches.
Launch a FindAll run for {objective} on {entity_type}, conditions {match_conditions}, generator {generator}, limit {match_limit}, excluding {exclude_list}.
GET /v1beta/findall/runs/{findall_id} Check the status of a FindAll run · Retrieve FindAll Run Status #
Ask an LLM
“Is my FindAll run still queued, running, or finished?”
“Can I poll a FindAll run to see how far along it is?”
Tell an agent
Check the status of FindAll run {findall_id}.
Tell me whether FindAll run {findall_id} has completed yet.
POST /v1beta/findall/runs/{findall_id}/cancel Cancel a FindAll run · Cancel FindAll Run #
Ask an LLM
“How do I stop a FindAll run that I no longer need?”
“Can I cancel a FindAll run before it finds all its matches?”
Tell an agent destructive · confirm first
Cancel FindAll run {findall_id}.
Stop FindAll run {findall_id} from searching any further.
POST /v1beta/findall/runs/{findall_id}/enrich Add enrichment fields to a FindAll run · Add Enrichment to FindAll Run #
Ask an LLM
“Can I add extra researched columns, like headcount or funding, to the entities a FindAll run found?”
“Which processor and MCP servers can be used when enriching FindAll matches?”
Tell an agent
Enrich the matches in FindAll run {findall_id} with fields defined by {output_schema}.
Add an enrichment to FindAll run {findall_id} using the {processor} processor and schema {output_schema}.
GET /v1beta/findall/runs/{findall_id}/events Stream live events from a FindAll run · Stream FindAll Events #
Ask an LLM
“Can I subscribe to real-time updates as a FindAll run discovers matches?”
“How do I resume a FindAll event stream after my connection drops?”
Tell an agent
Stream events from FindAll run {findall_id}.
Resume the FindAll {findall_id} event stream after event {last_event_id}.
POST /v1beta/findall/runs/{findall_id}/extend Raise the match limit of a FindAll run · Extend FindAll Run #
Ask an LLM
“My FindAll run hit its match limit; can I ask it to find more entities?”
“Does extending a FindAll run add to the existing match limit or replace it?”
Tell an agent
Extend FindAll run {findall_id} by {additional_match_limit} more matches.
Have FindAll run {findall_id} keep going and find another {additional_match_limit} entities.
GET /v1beta/findall/runs/{findall_id}/result Get the matched entities from a FindAll run · FindAll Run Result #
Ask an LLM
“Where do I get the list of entities a FindAll run has matched so far?”
“Can I see a snapshot of FindAll results while the run is still going?”
Tell an agent
Get the current results of FindAll run {findall_id}.
Show me the entities matched so far by FindAll run {findall_id}.
GET /v1beta/findall/runs/{findall_id}/schema View the schema of a FindAll run · Get FindAll Run Schema #
Ask an LLM
“What entity type and match conditions is a given FindAll run using?”
“Can I look up the schema a FindAll run was set up with?”
Tell an agent
Show the schema for FindAll run {findall_id}.
Get the match condition and enrichment schema used by FindAll run {findall_id}.

Documentation

📖
Documentation
https://docs.parallel.ai/home
📖
APIReference
https://docs.parallel.ai/api-reference
📖
GettingStarted
https://docs.parallel.ai/getting-started/overview
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/parallel-ai/refs/heads/main/authentication/parallel-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/parallel-ai/refs/heads/main/openapi/parallel-findall-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/parallel-ai:parallel-ai-findall-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

parallel-findall-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Parallel Find All API
  description: Parallel API
  contact:
    name: Parallel Support
    url: https://parallel.ai
    email: support@parallel.ai
  version: 0.1.2
servers:
- url: https://api.parallel.ai
  description: Parallel API
security:
- ApiKeyAuth: []
tags:


# --- truncated at 32 KB (58 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/parallel-ai/refs/heads/main/openapi/parallel-findall-api-openapi.yml