---
title: "Fast Entity Search"
method: POST
path: "/v1beta/findall/entity-search"
tags: ["FindAll"]
---

# Fast Entity Search

`POST /v1beta/findall/entity-search`

Return ranked entities matching a natural language objective.

This endpoint performs a best-effort search optimized for low latency. To keep
responses fast, it returns a fixed set of attributes and supports queries of
limited complexity.

For comprehensive match evaluation and enrichment, use the
[FindAll API](https://docs.parallel.ai/findall-api/findall-quickstart).

## Request body

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

## Response `200`

Successful Response

- FindAllEntitySearchResponse
  - `entity_set_id` string, required — Entity set request ID. Example: `entity_set_cad0a6d2dec046bd95ae900527d880e7`
  - `entities` EntityItem[], required — Ranked list of entities.
    - `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-06-02** `e396803650d6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/parallel-web/apis/parallel-api/changes/v1beta/findall/entity-search/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)