Find companies, startups, and other entities with natural language
Translate a plain-English company, startup, investor, investment firm, or investment manager search into the canonical EntityFilter contract, execute the existing entity list engine, and return both the interpretation and ranked entity list page. Unsupported constraints are named in the interpretation instead of being silently ignored. Explicit filter fields are hard constraints: they override planner values, while the planner fills fields left unset.
Authentication
AuthorizationBearer
User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key
OR
X-API-Keystring
Admin API key for system-to-system write operations
OR
X-Client-Secretstring
Client secret for read-only service-to-service access (no writes)
Query parameters
permitMonogram
When false, generated monogram logos are stripped from entity rows.
includePrivate
Privileged admin readback scope. Includes hidden or off-sitemap entities. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.
page
Zero-based page index (0..N)
size
The size of the page to be returned
sort
Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.
Request
This endpoint expects an object.
search
Canonical plain-English search request and strategy.
filter
Explicit entity constraints. Caller-supplied fields override planner values; the planner fills only fields left at their canonical defaults.
Response
OK
interpretation
Structured interpretation used to run the entity list query.
result
Entity list page returned by the canonical entity list engine.
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
409
Conflict Error
415
Unsupported Media Type Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error