Find Companies, Startups, and Investors in Natural Language
Turns a plain-English search for companies, startups, investors, investment firms, or investment managers into a structured EntityFilter, runs it as a regular entity search, and returns both how the query was interpreted and a ranked page of matching entities. Unsupported constraints are named in the interpretation instead of being silently ignored. A description or company discovery question belongs here; explicit filter fields are hard constraints: they override planner values, while the planner fills fields left unset. Example: search.query ‘AI infrastructure companies founded since 2020’ with size=3. The query accepts plain English; size limits the page, page starts at 0, and filter.yearFoundedRange [{“min”:2020}] imposes a hard founding-year constraint.
Authentication
Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token
Query parameters
Optional answer layers to add beside the entity records; repeat to add more. passage ranks public research snippets and linked news that answer the question; synthesis adds a cited written answer and implies passage; judgment ranks a competitor, market, or provider question’s answer by judged probability; web adds web evidence and the companies it names, and implies judgment.
Zero-based page index (0..N)
Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.
Request
The plain-English search request and the search method to use.
Explicit entity constraints. Caller-supplied fields override planner values; the planner fills only fields left at their canonical defaults.
The stored aVenture news article this search started from. Its approved public Company and Business Line mentions are ordered subjects, rather than candidates judged from the headline. An unknown or non-public article, or one without such mentions, keeps the ordinary search.
Response headers
Cache policy this search ran under: use, bypass, or refresh. Explicit fresh modes require private-data access; automatic date freshness can select refresh for any caller.
Requests allowed per client IP in the current rate-limit window.
Requests left before the tightest applicable rate-limit bucket rejects.
Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.
Response
Recorded investment participation supporting investor discovery. Each row keeps its entity or personal investor, portfolio company, transaction attribution, and query-matched offering evidence. Empty for other question intents.
Judged rows of the result page for a competitor, market, or provider question: the same entities in the same order, each with its judged probability. Empty for other questions.
Passages that best answer the question, ranked by score; empty unless the request asks for the passage layer.
Curated competitors of the single subject entity for peer questions; semantic look-alikes are the result page. Empty otherwise.
Web searches for this question not yet stored; their evidence joins a later request. Empty without the web layer.
Whether this search is mainly about people; set only on entity events in the stream.
Entities the question is about, one per resolved subject name, in query order; empty when the question names none or none resolves.
Written answer grounded in the subject, peer, and result records and the passages; null unless the request asks for the synthesis layer.