Start a bulk work-email job
leadsforge.people.email.find.bulkRequest email finding.
- Preço
- $0.0245/successPelo preço de tabela
- Taxa de sucesso
- 83,5%Últimos 30 dias · 443 chamadas
- Latência p50
- 8.2 sp95 147 s
- Última verificação
- 20 de ago. de 2026Verificado e funcionando
POSThttps://toolswitch.dev/v1/tools/leadsforge.people.email.find.bulkBeta- Usa a cota da plataforma
- Resposta síncrona
- Lê dados públicos
Parâmetros
202 with a jobID; poll leadsforge.people.enrich.job.status then fetch leadsforge.people.enrich.job.results. `people` entries are deduplicated by normalized linkedinURL or case-insensitive firstName+lastName+company, so duplicates lose their externalID.
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| Corpo (JSON) | ||||
people | matriz | Opcional | max 500; each item is {linkedinURL} OR {firstName, lastName, company}, plus optional externalID (max 128 chars). Mutually exclusive with personIDs | [{"company":"Stripe","lastName":"Collison","firstName":"Patrick","externalID":"crm-42"}] |
personIDs | matriz | Opcional | ids from leadsforge.people.search; externalID is NOT supported in this mode | ["p_abc123","p_def456"] |
saveToList | booleano | Opcional | also persist the results as a list in the LeadsForge app | |
webhookURL | string | Opcional | POSTed on completion/failure, retried up to 10 times with exponential backoff | https://example.com/webhook |
clientRequestID | string | Opcional | your own correlation id — also the filter key on the jobs list | my-request-123 |
- Corpo (JSON)
peoplematrizOpcionalmax 500; each item is {linkedinURL} OR {firstName, lastName, company}, plus optional externalID (max 128 chars). Mutually exclusive with personIDs
Exemplo:
[{"company":"Stripe","lastName":"Collison","firstName":"Patrick","externalID":"crm-42"}]personIDsmatrizOpcionalids from leadsforge.people.search; externalID is NOT supported in this mode
Exemplo:
["p_abc123","p_def456"]saveToListbooleanoOpcionalalso persist the results as a list in the LeadsForge app
webhookURLstringOpcionalPOSTed on completion/failure, retried up to 10 times with exponential backoff
Exemplo:
https://example.com/webhookclientRequestIDstringOpcionalyour own correlation id — also the filter key on the jobs list
Exemplo:
my-request-123
Exemplos de código
Substitua $TOOLSWITCH_KEY pela chave criada no console.
curl -X POST 'https://toolswitch.dev/v1/tools/leadsforge.people.email.find.bulk' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
-H "Content-Type: application/json" \
--data-raw '{"people":[{"company":"Stripe","lastName":"Collison","firstName":"Patrick","externalID":"crm-42"}],"clientRequestID":"treg-verify-1"}'import os
import json
import requests
response = requests.request(
"POST",
"https://toolswitch.dev/v1/tools/leadsforge.people.email.find.bulk",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
json=json.loads("{\"people\":[{\"company\":\"Stripe\",\"lastName\":\"Collison\",\"firstName\":\"Patrick\",\"externalID\":\"crm-42\"}],\"clientRequestID\":\"treg-verify-1\"}"),
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/leadsforge.people.email.find.bulk", {
method: "POST",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
"Content-Type": "application/json",
},
body: JSON.stringify(JSON.parse("{\"people\":[{\"company\":\"Stripe\",\"lastName\":\"Collison\",\"firstName\":\"Patrick\",\"externalID\":\"crm-42\"}],\"clientRequestID\":\"treg-verify-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.0245/success, incluindo a taxa de serviço.