Enrich a person — role, work history, skills, LinkedIn
oceanio.people.enrichMatch a person with our database and enrich it with additional information
- Prix
- $0.0081/successAu prix catalogue
- Taux de réussite
- 98,8 %30 derniers jours · 74 434 appels
- Latence p50
- 594 msp95 2.3 s
- Dernière vérification
- 20 août 2026Vérifié et opérationnel
POSThttps://toolswitch.dev/v1/tools/oceanio.people.enrichBeta- Utilise le quota de la plateforme
- Réponse synchrone
- Lit des données publiques
Paramètres
the base call returns the profile — job title, seniorities, departments, full experience history with dates, skills, location, LinkedIn URL, connections and followers — for 0.1 credit. Leave revealEmails/revealPhones out unless you actually need contact details; they are 10x and 100x the price
| Paramètre | Type | Obligatoire | Description | Exemple |
|---|---|---|---|---|
| Corps (JSON) | ||||
person | objet | Obligatoire | the person to match — id, name, firstName, lastName, jobTitle, email, phone, linkedin, twitter, facebook, country. A LinkedIn URL is the strongest key; name + company domain also resolves | {"name":"Patrick Collison","linkedin":"https://www.linkedin.com/in/patrickcollison"} |
company | objet | Facultatif | the person's company, to disambiguate a common name. `domain` is enough | {"domain":"stripe.com"} |
revealEmails | objet | Facultatif | {includeEmails: true, webhookUrl: '…'} — asks for verified email addresses too. Billed separately at the reveal rate (about 1 credit per verified email) and delivered to the webhook, not inline. Available only with your own key | |
revealPhones | objet | Facultatif | {includePhones: true, webhookUrl: '…'} — asks for direct phone numbers. Billed separately (about 10 credits per verified phone) and delivered to the webhook. Available only with your own key | |
- Corps (JSON)
personobjetObligatoirethe person to match — id, name, firstName, lastName, jobTitle, email, phone, linkedin, twitter, facebook, country. A LinkedIn URL is the strongest key; name + company domain also resolves
Exemple :
{"name":"Patrick Collison","linkedin":"https://www.linkedin.com/in/patrickcollison"}companyobjetFacultatifthe person's company, to disambiguate a common name. `domain` is enough
Exemple :
{"domain":"stripe.com"}revealEmailsobjetFacultatif{includeEmails: true, webhookUrl: '…'} — asks for verified email addresses too. Billed separately at the reveal rate (about 1 credit per verified email) and delivered to the webhook, not inline. Available only with your own key
revealPhonesobjetFacultatif{includePhones: true, webhookUrl: '…'} — asks for direct phone numbers. Billed separately (about 10 credits per verified phone) and delivered to the webhook. Available only with your own key
Exemples de code
Remplacez $TOOLSWITCH_KEY par la clé créée dans la console.
curl -X POST 'https://toolswitch.dev/v1/tools/oceanio.people.enrich' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
-H "Content-Type: application/json" \
--data-raw '{"person":{"name":"Patrick Collison","linkedin":"https://www.linkedin.com/in/patrickcollison"},"company":{"domain":"stripe.com"}}'import os
import json
import requests
response = requests.request(
"POST",
"https://toolswitch.dev/v1/tools/oceanio.people.enrich",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
json=json.loads("{\"person\":{\"name\":\"Patrick Collison\",\"linkedin\":\"https://www.linkedin.com/in/patrickcollison\"},\"company\":{\"domain\":\"stripe.com\"}}"),
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/oceanio.people.enrich", {
method: "POST",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
"Content-Type": "application/json",
},
body: JSON.stringify(JSON.parse("{\"person\":{\"name\":\"Patrick Collison\",\"linkedin\":\"https://www.linkedin.com/in/patrickcollison\"},\"company\":{\"domain\":\"stripe.com\"}}")),
});
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.0081/success, frais de service inclus.