Data APIFor recruiting
Source candidates by what they do and where they work.
People search finds individuals by role, seniority and the kind of company that employs them. Each result is one person, with their current title, employer and LinkedIn profile, and a verified work email when you ask for one.
From a role to a shortlist.
Describe the person and the employer in the same sentence. Each is a complete request body.
Find people by role and employer
Conditions about the person and conditions about the employer, combined in one request.
POST /v1/people/search { "query": "Senior machine learning engineers at US robotics companies with 50 to 500 employees", "limit": 50, "max_credits": 20 }Add a verified work email
Set enrich_emails and each person comes back with a work email and its status, so you know which addresses are valid before you write.
POST /v1/people/search { "query": "Heads of data and analytics at US healthcare companies with more than 1,000 employees", "limit": 50, "enrich_emails": true, "max_credits": 40 }See why each person matched
Every requirement is listed on the result with its verdict and the evidence. This one is shortened.
{ "name": "Jordan Avery", "title": "Head of Revenue Operations", "seniority": "head", "company": { "name": "Northwind Pay", "domain": "northwindpay.example" }, "email_status": "valid", "matched_criteria": [{ "criterion": "person.title", "verdict": "matched", "evidence": { "summary": "Current title: Head of Revenue Operations" } }] }
Why source on the Data API.
- The person and the employer
- Combine title, seniority, department and location with the employer's industry, size and more. One request answers both halves.
- Emails that are checked
- Ask for work emails and each one comes back with a status. An email is not guaranteed for every person, and the result tells you when there is none.
- 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.
- PeopleAvailableFind people by job title, seniority and employer, with verified work emails on request.
POST /v1/people/search - 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
More ways to use the Data API.
Common questions
What does a people search return?
One person per result: name, current job title, seniority, department, location, employer and LinkedIn profile, with the evidence for each requirement. Work emails and phone numbers are added when you request them.
Is an email guaranteed for every person?
No. A search does not guarantee an email or a phone number for every person. When one is found, it comes back with its status.
Can I start from companies instead of people?
Yes. Run a company search for the employers you care about, and attach a persona with the job titles you want. Each company comes back with the matching people.
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 role. Get the people back.
Request beta access and run your first people search in minutes.
The Data API is in beta. Access is by request.