Skip to main content
POST
/
v1beta
/
findall
/
ingest
Python
from parallel import Parallel

client = Parallel(api_key="API Key")

objective = "Find all portfolio companies of Khosla Ventures founded after 2020 and CEO names"

ingest = client.beta.findall.ingest(
    objective=objective,
)

print(ingest.model_dump_json(indent=2))
{
  "objective": "<string>",
  "entity_type": "<string>",
  "match_conditions": [
    {
      "name": "<string>",
      "description": "<string>"
    }
  ],
  "enrichments": [
    {
      "output_schema": {
        "json_schema": {},
        "type": "json"
      },
      "processor": "core",
      "mcp_servers": [
        {
          "url": "<string>",
          "name": "<string>",
          "type": "url",
          "headers": {},
          "allowed_tools": [
            "<string>"
          ]
        }
      ]
    }
  ],
  "generator": "core",
  "match_limit": 123
}

Authorizations

x-api-key
string
header
required

Headers

parallel-beta
string | null

Body

application/json

Input model for FindAll ingest.

objective
string
required

Natural language objective to create a FindAll run spec.

Response

Successful Response

Response model for FindAll ingest.

objective
string
required

Natural language objective of the FindAll run.

entity_type
string
required

Type of the entity for the FindAll run.

match_conditions
MatchCondition · object[]
required

List of match conditions for the FindAll run.

enrichments
FindAllEnrichInput · object[] | null

List of enrichment inputs for the FindAll run.

generator
enum<string>
default:core

The generator of the FindAll run.

Available options:
base,
core,
pro,
preview
match_limit
integer | null

Max number of candidates to evaluate