Start a bulk work-email lookup (beta, up to 1,000 people)
companyenrich.people.email.bulk.startCreates an asynchronous bulk person email enrichment job for up to 1,000 lookup items
- Prix
- $0.098/successAu prix catalogue
- Taux de réussite
- —Aucune donnée de taux de réussite pour le moment30 derniers jours · 1 appels
- Latence p50
- ——
- Dernière vérification
- 20 août 2026Vérifié et opérationnel
POSThttps://toolswitch.dev/v1/tools/companyenrich.people.email.bulk.startBeta- Utilise le quota de la plateforme
- Réponse synchrone
- Lit des données publiques
Paramètres
the batch form of companyenrich.people.email. Returns {job_id, status, total_requests, estimated_credits} immediately; `estimated_credits` assumes every lookup succeeds and is charged fresh, so it is a strict upper bound. Completed jobs report found_count / not_found_count / unavailable_count separately.
| Paramètre | Type | Obligatoire | Description | Exemple |
|---|---|---|---|---|
| Corps (JSON) | ||||
items | array[object] | Obligatoire | 1-1,000 objects of {person_id (required, integer), domain (optional string)}. NOTE the field is `person_id`, not `id` — using `id` is rejected with a bodyless HTTP 400 | [{"domain":"stripe.com","person_id":256474769}] |
webhook_url | chaîne | Facultatif | callback on completion; poll the free status route instead when calling through a proxy | |
- Corps (JSON)
itemsarray[object]Obligatoire1-1,000 objects of {person_id (required, integer), domain (optional string)}. NOTE the field is `person_id`, not `id` — using `id` is rejected with a bodyless HTTP 400
Exemple :
[{"domain":"stripe.com","person_id":256474769}]webhook_urlchaîneFacultatifcallback on completion; poll the free status route instead when calling through a proxy
Exemple de réponse
{
"job_id": "01a01ca3-7120-7ee5-beba-a7bc64de4ea7",
"status": "pending",
"total_requests": 1,
"estimated_credits": 10
}Exemples de code
Remplacez $TOOLSWITCH_KEY par la clé créée dans la console.
curl -X POST 'https://toolswitch.dev/v1/tools/companyenrich.people.email.bulk.start' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
-H "Content-Type: application/json" \
--data-raw '{"items":[{"domain":"stripe.com","person_id":256474769}]}'import os
import json
import requests
response = requests.request(
"POST",
"https://toolswitch.dev/v1/tools/companyenrich.people.email.bulk.start",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
json=json.loads("{\"items\":[{\"domain\":\"stripe.com\",\"person_id\":256474769}]}"),
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/companyenrich.people.email.bulk.start", {
method: "POST",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
"Content-Type": "application/json",
},
body: JSON.stringify(JSON.parse("{\"items\":[{\"domain\":\"stripe.com\",\"person_id\":256474769}]}")),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());Cette API de passerelle est en version Beta ; son URL et son authentification peuvent changer. Les paramètres de l’exemple sont des données fictives. Les appels sont facturés à $0.098/success, frais de service inclus.