Entity Search

​

What is Entity Search?

​

When to Use It

• Interactive interfaces: Power a go-to-market or hiring interface, a chat experience, or an automation with a human in the loop, where results need to come back in seconds.
• Starting sets for deeper work: Generate an initial set of people or companies to filter, enrich with additional fields, or hand off to FindAll or the Task API for comprehensive list building and research.
• Cost-sensitive lookups: Run people-and-company search at a fraction of the cost of a full FindAll run when you don’t need exhaustive coverage or per-field citations.

​

Input and Output

​

Sample Request

curl -X POST "https://api.parallel.ai/v1beta/findall/entity-search" \
  -H "x-api-key: $PARALLEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entity_type": "companies",
    "objective": "AI startups that raised Series A in 2024",
    "match_limit": 100
  }'

from parallel import Parallel

client = Parallel(api_key="YOUR_API_KEY")

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

for entity in response.entities:
    print(f"{entity.name}: {entity.url}")

import Parallel from 'parallel-web';

const client = new Parallel({
  apiKey: process.env.PARALLEL_API_KEY
});

const response = await client.beta.findall.entitySearch({
  entity_type: "companies",
  objective: "AI startups that raised Series A in 2024",
  match_limit: 100,
});

for (const entity of response.entities) {
  console.log(`${entity.name}: ${entity.url}`);
}

​

Sample Response

{
  "entity_set_id": "entity_set_cad0a6d2dec046bd95ae900527d880e7",
  "entities": [
    {
      "name": "Figure AI",
      "url": "https://www.figure.ai",
      "description": "AI robotics company building general purpose humanoid robots"
    }
    // ... additional results omitted for brevity ...
  ]
}

​

Getting Good Results

• Consider requesting more results than you need. Results are ranked approximately rather than verified against your objective, so a low match_limit may omit relevant entities that a larger request would include. If your workflow filters or reviews results downstream, request 100 or more and select from the response.
• Avoid highly restrictive objectives. The API returns up to match_limit results even when few entities satisfy the objective, so for narrow, heavily qualified objectives, relevance declines toward the end of the list. Prefer an objective that captures your core criterion and apply further conditions downstream, or use FindAll, which evaluates each match condition explicitly.

​

How It Differs from FindAll

​

Scope and Compliance

​

Next Steps

• FindAll Quickstart: Comprehensive, asynchronous entity discovery with verified, enriched, and cited results
• Search API: Retrieve pages and excerpts across the whole web
• Pricing: Detailed rate schedule
• Rate Limits: Default quotas and how to request higher limits