Get Buying Group Contacts
Identify the buying group within a set of target companies. Supply companies by domain or Lusha company id - the model scores and labels each returned contact with a persona role.
Personas:
- decision_maker — has budget or sign-off authority
- potential_champion — likely internal advocate for the purchase
- end_user — likely day-to-day user of the product
Pass personas to filter to specific roles, or omit it to get all three. Use contactsLimit to cap how many contacts are returned per company (default 60).
Results are lightweight previews grouped by company. Each contact includes a has field listing available data points, a canReveal field showing what can be unlocked via Enrich, a roles array with the assigned persona(s), and a score (0-1) reflecting relevance to the assigned role.
Use Enrich Contacts with the returned contact id to reveal emails and phones.
Billing: Charged per contact returned via the buyingGroupContact action.
Request body
Example request
{
"companies": [
{
"clientReferenceId": "comp-ref-1",
"domain": "acme.com",
"id": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345"
}
],
"personas": [
"decision_maker",
"potential_champion"
],
"contactsLimit": 20,
"pagination": {
"size": 100
}
}Response
Successful response
Example response
{
"requestId": "951d46da-24f9-4608-84bf-5e70a10bf851",
"results": [
{
"clientReferenceId": "comp-ref-1",
"companyId": "v1.ocoj3UrkPqHcR8yAEosYFTuVXTH282LP",
"contacts": [
{
"id": "v1.VdKU4HkaDb7CE4CEImoUcm7bxUGUUz-aOQ",
"firstName": "Mohammed",
"lastName": "Alam",
"jobTitle": {
"title": "RF/Analog IC Design Engineer",
"departments": [
"Engineering & Technical"
],
"seniority": "Non-Manager"
},
"company": {
"id": "v1.ocoj3UrkPqHcR8yAEosYFTuVXTH282LP",
"name": "Intel",
"domain": "www.intel.com"
},
"location": {
"country": "United States",
"state": "Arizona",
"city": "Chandler"
},
"socialLinks": {
"linkedin": "https://www.linkedin.com/in/mohammed-alam-83759111"
},
"has": [
"firstName",
"lastName",
"jobTitle",
"company",
"location",
"socialLinks",
"phones",
"previousEmployment",
"jobStartDate"
],
"canReveal": [
{
"field": "emails",
"credits": 1
}
],
"roles": [
"potential_champion"
],
"score": 0.8872673511505127,
"error": {
"code": "NOT_FOUND",
"message": "Contact not found"
}
}
],
"error": {
"code": "NOT_FOUND",
"message": "Contact not found"
}
}
],
"pagination": {
"size": 25
},
"billing": {
"creditsCharged": 3,
"resultsReturned": 1
}
}