LushaDados de pessoasEnrichment

Find the buying-committee contacts at a company

lusha.x.buying-group

Resolve up to 25 companies to Lusha company ids, rank their buying committee (decision makers, champions, end users) with Lusha's persona model, and return lightweight contact previews grouped per company (1 credit per contact returned - always pass contactsLimit)

Price: $0.1248/resultPelo preço de tabela
Success rate: —Ainda não há dados da taxa de sucessoAinda não há dados da taxa de sucesso
Latency p50: ——
Last verified: —Not verified yet

POSThttps://toolswitch.dev/v1/tools/lusha.x.buying-groupBeta

Try onlineProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parâmetros

contactsLimit is the only spend control on this route and Lusha defaults it to 60 contacts per company, so set it on every call. Returns previews (name, title, company, location, social links, `has`/`canReveal` data-point flags, persona `roles`, relevance `score` 0-1) grouped per company under `results[].contacts`; call lusha.people.contacts.enrich on the returned contact ids for emails/phones (a further 1 credit per email, 5 per phone). NOT free: every preview row costs 1 credit - see cost. Successor of the retired lusha.x.decision-makers path (removed by Lusha 2026-08-12, changelog 2.9.0); this is the only operation that accepts contactsLimit and personas

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Corpo (JSON)
`personas`	array[string]	Opcional	filter to buying-committee roles: decision_maker (budget or sign-off authority) \| potential_champion (likely internal advocate) \| end_user (likely day-to-day user); omit for all three	`["decision_maker"]`
`companies`	array[object]	Obrigatório	1-25 entries (V3BuyingGroupCompanyItem); each needs exactly one of `domain` (resolved server-side) or `id` (Lusha company id, vN.… form, e.g. from lusha.companies.search). Optional `clientReferenceId` is echoed back on the matching result. The key is `domain` INSIDE each entry - a top-level domain / company_domain / website / company_name is rejected with 'property … should not exist' (seen live on the retired sibling path 2026-09-02)	`[{"domain":"lusha.com"}]`
`pagination`	objeto	Opcional	optional {page, size}; page >= 0 (default 0), size 10-100 (default 100). Pages across the ranked contacts; contactsLimit still bounds what one company can return	`{"page":0,"size":100}`
`contactsLimit`	inteiro	Opcional	THE SPEND CAP: maximum contacts returned PER COMPANY, minimum 1, default 60, and every contact returned costs 1 credit - so the bill is at most companies × contactsLimit credits. Lusha's default is 60, i.e. an uncapped single-company call can cost 60 credits ($7.49 at the catalog rate) and a 25-company call 1,500. Always set it	`5`

Corpo (JSON)
personasarray[string]Opcional
filter to buying-committee roles: decision_maker (budget or sign-off authority) | potential_champion (likely internal advocate) | end_user (likely day-to-day user); omit for all three
Exemplo: ["decision_maker"]
companiesarray[object]Obrigatório
1-25 entries (V3BuyingGroupCompanyItem); each needs exactly one of `domain` (resolved server-side) or `id` (Lusha company id, vN.… form, e.g. from lusha.companies.search). Optional `clientReferenceId` is echoed back on the matching result. The key is `domain` INSIDE each entry - a top-level domain / company_domain / website / company_name is rejected with 'property … should not exist' (seen live on the retired sibling path 2026-09-02)
Exemplo: [{"domain":"lusha.com"}]
paginationobjetoOpcional
optional {page, size}; page >= 0 (default 0), size 10-100 (default 100). Pages across the ranked contacts; contactsLimit still bounds what one company can return
Exemplo: {"page":0,"size":100}
contactsLimitinteiroOpcional
THE SPEND CAP: maximum contacts returned PER COMPANY, minimum 1, default 60, and every contact returned costs 1 credit - so the bill is at most companies × contactsLimit credits. Lusha's default is 60, i.e. an uncapped single-company call can cost 60 credits ($7.49 at the catalog rate) and a 25-company call 1,500. Always set it
Exemplo: 5

Exemplos de código

Substitua $TOOLSWITCH_KEY pela chave criada no console.

Beta

curl -X POST 'https://toolswitch.dev/v1/tools/lusha.x.buying-group' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"companies":[{"domain":"lusha.com"}],"contactsLimit":1}'

import os
import json
import requests

response = requests.request(
    "POST",
    "https://toolswitch.dev/v1/tools/lusha.x.buying-group",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
    json=json.loads("{\"companies\":[{\"domain\":\"lusha.com\"}],\"contactsLimit\":1}"),
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/lusha.x.buying-group", {
  method: "POST",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
    "Content-Type": "application/json",
  },
  body: JSON.stringify(JSON.parse("{\"companies\":[{\"domain\":\"lusha.com\"}],\"contactsLimit\":1}")),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

Esta API de gateway está em Beta; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a $0.1248/result, incluindo a taxa de serviço.