Data APIFor market research
Map a market no industry code describes.
When no industry name fits, describe the segment in plain language. Each company is confirmed by research and cites the evidence that it belongs, so you can check the list before it goes into a market map or a memo.
From a description to a market map.
One sentence is a complete request. Check how it is read before you spend anything.
Describe the segment
No database categorizes companies this specifically, so the search starts from the public web and confirms each company.
POST /v1/companies/search { "query": "US companies that manufacture industrial heat pumps", "limit": 100, "max_credits": 100 }Check how it is read, for free
Parse returns the filters and criteria Avina would search with, and any assumptions it made. It spends no credits.
POST /v1/companies/search/parse { "query": "US companies that manufacture industrial heat pumps" } 200 OK { "filters": { "all": [ ... ] }, "criteria": [ ... ], "assumptions": [ ... ], "search_request": { ... } }Read results as they arrive
A search runs in the background. Read its results page by page while it is still running. Reading is free.
GET /v1/companies/search/32ba40da/results?after=cursor 200 OK { "data": [ ... ], "next_cursor": "...", "has_more": true }
Why map markets on the Data API.
- It starts where the data is
- Structured conditions go to data providers that can filter on them. When no database has a category for the segment, the search starts from AI search of the public web.
- One record per company
- The same company can come back from several providers under slightly different names. Results are merged into one record per company website before they are checked and counted.
- Every match comes with evidence
- Each result lists your requirements one by one, with a verdict and the sources behind it. A company or person is returned only when every requirement is matched.
How a request is answered.
Every search goes through the same four stages. You do not choose providers, and you can see what each stage did.
Interpret
The request is turned into exact requirements: filters on known fields, and free-text criteria for anything no field covers. Nothing you asked for is dropped.
Route
Avina picks the sources from what the request contains: data providers for structured conditions, AI search of the public web for requirements that need research.
Verify
Each candidate is checked against every requirement. It passes only when every requirement is matched with evidence.
Return
Passing records are merged into one per company or person and added to the results, which you can read while the search is still running.
The APIs behind it.
One key covers all of them. Each links to its page in the docs. See all seven.
- CompaniesAvailableFind companies by anything you can describe: filters, requirements no database covers, and events like a new hire or a funding round.
POST /v1/companies/search - ParseAvailableTurn plain language into structured filters you can show, edit and reuse. Free.
POST /v1/companies/search/parse - SignalsAvailableRun any search on a schedule and get only what is new each time.
POST /v1/companies/searchon a schedule
More ways to use the Data API.
Common questions
How does it find companies no database categorizes?
Avina picks sources from what the request contains. Requirements that need research go to AI search of the public web, and every candidate it finds is then checked against all of your requirements.
How do I know a company belongs in the segment?
Each result lists your requirements with a verdict, a short summary of the evidence and its sources. A company is returned only when every requirement is matched.
Is the list complete?
Not necessarily. A search returns verified matches up to your limit, not a census. Completed means the run finished, and stop_reason says why it stopped.
How is it priced?
Pricing for the Data API is not final yet. Every search takes the most cost-efficient route that still gets good results, and max_credits caps what any one search can spend. Request beta access and we will share pricing.
Describe the segment. Get the map back.
Request beta access and run your first search in minutes.
The Data API is in beta. Access is by request.