---
title: "Generate FindAll Candidates"
method: POST
path: "/v1beta/findall/candidates"
tags: ["FindAll"]
---

# Generate FindAll Candidates

`POST /v1beta/findall/candidates`

Deprecated alias for ``/v1beta/findall/entity-search``.

## Request body

- FindAllCandidatesRequest
  - `entity_type` 'company' | 'people', required — Type of entity to search for.
  - `objective` string, required — Natural language description of target entities.
  - `match_limit` integer — Maximum number of candidates to return. Must be between 5 and 1000 (inclusive). May return fewer results. Defaults to 100.

## Response `200`

Successful Response

- FindAllCandidatesResponse
  - `candidate_set_id` string, required — Candidate set request ID. Example: `candidate_set_cad0a6d2dec046bd95ae900527d880e7`
  - `candidates` CandidateItem[], required — Ranked list of entity candidates.
    - `name` string, required — Entity name.
    - `url` string, required — Canonical URL for the entity.
    - `description` string, required — Descriptive text about the entity.

## Other responses

- `422` — Validation Error

## Changes

> 21 revisions in range; 2 could not be searched.

- **2026-04-21** `57e1c56be094` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/parallel-web/apis/parallel-api/changes/v1beta/findall/candidates/post.md)

---

[API](https://skmtc.dev/parallel-web/apis/parallel-api.md) · [All operations](https://skmtc.dev/parallel-web/apis/parallel-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/parallel-web/parallel-api/revisions/1595294c8795/schema)