Data APIFor sales and marketing
Build lead lists no single database can.
Describe your ideal customer in plain language. The Data API finds the companies across data providers, checks each one against every requirement, and attaches the people to contact.
From a sentence to a list.
Three requests teams start with. Each is a complete request body you can change and send.
Build a target account list
Fit and timing in one sentence. Country, size and the open job are structured conditions, so they are checked against data records.
POST /v1/companies/search { "query": "B2B software companies in the US with 50 to 500 employees that are hiring sales development representatives", "limit": 50, "max_credits": 50 }Get the buyers at each account
A persona is a saved description of who to reach: which job titles, how many people, and whether to look up email and phone. Pass it to a search and every company comes back with those people attached.
POST /v1/companies/search { "query": "B2B software companies in the US with 50 to 500 employees that are hiring sales development representatives", "persona_ids": ["c92d77d7-cc85-4a62-bcec-518b1d7d6260"], "limit": 50, "max_credits": 50 }Catch a change in leadership
A new executive often reviews the tools their team uses. This finds companies where a sales leader started in the last 60 days.
POST /v1/companies/search { "filters": { "all": [ { "field": "company.employee_count", "operator": "between", "value": [200, 2000] }, { "related": { "relationship": "new_hires", "where": { "all": [ { "field": "title", "operator": "in", "value": ["Chief Revenue Officer", "CRO", "VP Sales"] }, { "field": "started_at", "operator": "within_last_days", "value": 60 } ] } } } ] }, "limit": 25, "max_credits": 25 }
Why build lists on the Data API.
- Coverage past one database
- A request can run across company databases, job listings, technology data and AI search of the public web. What one provider misses, another finds.
- 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.
- The most efficient route
- Every search takes the most cost-efficient path that still gets good results. Set max_credits and a search can never spend more than that.
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 - PeopleAvailableFind people by job title, seniority and employer, with verified work emails on request.
POST /v1/people/search - SignalsAvailableRun any search on a schedule and get only what is new each time.
POST /v1/companies/searchon a schedule - ParseAvailableTurn plain language into structured filters you can show, edit and reuse. Free.
POST /v1/companies/search/parse
More ways to use the Data API.
Common questions
How is this different from buying a list from one data provider?
One provider has one database and its own filters. The Data API sends each part of a request to the providers that can answer it, merges what comes back into one record per company, and checks every result against all of your requirements before returning it.
Can I get contacts with emails and phone numbers?
Yes. Create a persona with the job titles you want and pass it to a company search. Each matching company comes back with those people attached, with work emails and phone numbers when you ask for them. Contact lookups are charged per lookup.
How do I avoid paying for companies I already have?
Pass exclude_domains with the domains you already have. Each run then returns only companies that are new to you.
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 your ideal customer. Get the list back.
Request beta access and run your first search in minutes.
The Data API is in beta. Access is by request.