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

client = Parallel()

candidates = client.beta.findall.candidates(
    entity_type="company",
    objective="AI startups that raised Series A in 2024",
    match_limit=100,
)

for candidate in candidates.candidates:
    print(f"{candidate.name}: {candidate.url}")
{
  "candidates": [
    {
      "name": "<string>",
      "url": "<string>",
      "description": "<string>"
    }
  ]
}

Authorizations

x-api-key
string
header
required

Headers

parallel-beta
string | null

Body

application/json
entity_type
enum<string>
required

Type of entity to search for.

Available options:
company,
people
objective
string
required

Natural language description of target entities.

match_limit
integer
default:100

Maximum number of candidates to return. Must be between 5 and 1000 (inclusive). May return fewer results. Defaults to 100.

Required range: 5 <= x <= 1000

Response

Successful Response

candidates
CandidateItem · object[]
required

Ranked list of entity candidates.