{"endpoint":{"id":"treg.people.email.find.personal","provider":"treg","provider_display":"treg","name":"people.email.find.personal — routed: best of 5 providers, own keys first","summary":"Find someone's personal email from their LinkedIn URL or work email — treg picks the provider (own keys first, then cheapest per hit) and names the one that served","method":"POST","path":"/people.email.find.personal","scope":"","tier":"core","kind":"routed","domain":"contacts","call_template":"treg call treg.people.email.find.personal --method POST --data '{\"linkedin_url\":\"https://www.linkedin.com/in/patrickcollison\"}'","cost":{"type":"per_success","value":0.04,"currency":"USD","per":1,"unit":"call","source":"inferred","confidence":"documented","checked":null,"note":"the children's range $0.04–$0.48 per hit, 0% markup; you pay the child that served AND every child tried before it that bills a miss (0 of 5 do), up to X-Treg-Route-Max-Cost (default $1 a call). X-Treg-Route-Exclude them, or X-Treg-Route-Waterfall: 0, to pay for one provider only","usd":0.04},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":200,"means":"output.email == null"},"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":null,"docs_url":"","has_example":false,"input":{"bodyType":"json","body":{"linkedin_url":{"type":"url","required":false,"note":"identity key (part of linkedin_url)"},"linkedin_handle":{"type":"str","required":false,"note":"identity key (part of linkedin_handle)"},"email":{"type":"str","required":false,"note":"identity key (part of email)"}},"note":"Send everything you know about the subject — treg derives the rest (full_name ⇄ first+last), matches each provider on the variants it accepts ({linkedin_url} | {linkedin_handle} | {email}) and sends each provider only the fields it wants. On a miss treg keeps trying providers, cheapest first, within X-Treg-Route-Max-Cost (default $1 per call; misses on per-success providers are free). Options ride as headers, never in the body: X-Treg-Route-Waterfall: 0 (stop at the first miss), X-Treg-Route-Max-Cost: <usd>, X-Treg-Route-Prefer / X-Treg-Route-Exclude: <provider>. The response is {output, raw, _treg: {served_by, tried}}; X-Treg-Served-By names the child. X-Treg-Route-Verify: true checks a hit with treg.people.email.verify in the same call, at that call's own price, and reports it in _treg.verification {verdict, checked, served_by, cost_micro}."},"test_request":{"body":{"linkedin_url":"https://www.linkedin.com/in/patrickcollison"}},"routed_children":["aviato.people.email.find.personal","contactout.people.contact.personal","fiber-ai.people.contacts.reveal.personal","limadata.people.email.find.personal","sixtyfour.people.email.find.personal"],"capability":"people.email.find.personal","capability_description":"Find a person's personal email address","platform":"people","platform_label":"People & contact data","observed":{"samples":6446,"decided":6441,"ok_rate":0.9829,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},"provider":{"service":"treg","display_name":"treg"},"siblings":[{"id":"aviato.people.email.find.personal","provider":"aviato","provider_display":"Aviato","name":"Find a person's personal email","summary":"Personal email addresses for a person from a LinkedIn URL or another profile identifier","method":"GET","path":"/person/email","scope":"any_account","tier":"core","kind":"data","domain":"contacts","call_template":"treg call aviato.people.email.find.personal --query type=personal --query linkedinURL=https://www.linkedin.com/in/satyanadella","cost":{"type":"per_success","value":8,"currency":"credit","per":1,"unit":"call","source":"observed","checked":"2026-10-17","confidence":"verified","note":"8 credits on a hit, as for a work email; a personal miss answered 200 with no emails and was not charged.","usd":0.08},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-10-17","added":"2026-10-17","docs_url":"https://docs.data.aviato.co/api-reference/person/get-email","has_example":true,"input":{"queryParams":{"type":{"type":"string","required":true,"enum":["personal"],"note":"personal on treg's key"},"linkedinURL":{"type":"string","required":false,"note":"public, Sales Navigator or Recruiter URL","example":"https://www.linkedin.com/in/satyanadella"},"id":{"type":"string","required":false,"note":"Aviato person id"},"email":{"type":"string","required":false}},"note":"supply one person identifier"},"test_request":{"queryParams":{"linkedinURL":"https://www.linkedin.com/in/satyanadella","type":"personal"}},"observed":{"samples":2355,"decided":2350,"ok_rate":0.9996,"p50_ms":102,"p95_ms":269,"last_ok_days":0,"hit_rate":0.3963,"hit_samples":2349},"reviews":{"teams":0,"samples":[{"usefulness":"useful","reason":"Aviato returned a name-matched personal Gmail that verified valid.","client":"mcp","month":"2026-10"}]}},{"id":"contactout.people.contact.personal","provider":"contactout","provider_display":"ContactOut","name":"Get personal email, optionally phone from LinkedIn","summary":"Get personal email, optionally phone from LinkedIn","method":"GET","path":"/v1/people/linkedin","scope":"any_account","tier":"core","kind":"data","domain":"contacts","call_template":"treg call contactout.people.contact.personal --query profile=https://www.linkedin.com/in/YOUR-PROFILE --query 'email_type=<string>'","cost":{"type":"per_success","value":0.25,"currency":"USD","per":1,"unit":"call","source":"docs","source_url":"https://api.contactout.com/","checked":"2026-09-08","confidence":"documented","note":"Starter commercial rates supplied by the account owner. Work email $0.15, personal email $0.25, phone $0.25 per profile with a hit; search $0.02 per returned profile/company. Multiple addresses of one type consume one credit per profile. No contact hit means no contact charge. Set email_type explicitly as shown. Phone adds $0.25 only on a hit; never charged per phone/address in the returned array.","contactout":{"job":"contact","rates_micro":{"work_email":150000,"personal_email":250000,"phone":250000,"search":20000}},"usd":0.25},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":404,"means":"no ContactOut profile for this LinkedIn URL — a normal outcome (and free), not an API failure"},"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-09-08","docs_url":"https://api.contactout.com/","has_example":true,"input":{"queryParams":{"profile":{"type":"string","required":true,"note":"Full regular LinkedIn profile URL; Sales Navigator and Recruiter URLs are not supported.","example":"https://www.linkedin.com/in/YOUR-PROFILE"},"email_type":{"type":"string","required":true,"enum":["personal"]},"include_phone":{"type":"boolean","default":false}},"note":"Set email_type explicitly as shown. Phone adds $0.25 only on a hit; never charged per phone/address in the returned array."},"test_request":null,"observed":{"samples":4359,"decided":1769,"ok_rate":1.0,"p50_ms":159,"p95_ms":719,"last_ok_days":0,"hit_rate":0.484,"hit_samples":3655},"reviews":{"teams":0,"samples":[{"usefulness":"useful","reason":"Returned both a personal email and a mobile number for a GCC-based profile where cheaper routed providers found neither.","client":"mcp","month":"2026-09"},{"usefulness":"not_useful","reason":"Charged $0.25 personal reveal but returned corporate northstar-ltd.com address that verified invalid/dns_error — not a usable personal email","client":"mcp","month":"2026-09"},{"usefulness":"useful","reason":"Gave both the personal email and the mobile in one call.","client":"mcp","month":"2026-09"}]}},{"id":"enrichlayer.contacts.personal-email","provider":"enrichlayer","provider_display":"Enrichlayer","name":"Personal email lookup","summary":"Find personal emails for a social profile.","method":"GET","path":"/api/v2/contact-api/personal-email","scope":"any_account","tier":"core","kind":"data","domain":"contacts","call_template":"treg call enrichlayer.contacts.personal-email --query profile_url=https://www.linkedin.com/in/satyanadella --query page_size=1 --query email_validation=precise","cost":{"type":"per_result","value":1,"currency":"credit","per":1,"unit":"record","source":"docs","source_url":"https://enrichlayer.com/docs/api/v2/contact-api/personal-email-lookup","checked":"2026-10-01","confidence":"documented","enrichlayer":{"field":"emails","max_page":10,"extra_per_result":{"email_validation":{"precise":1}}},"note":"One credit per returned email; precise validation adds one credit per found email. Fast validation adds no charge.","usd":0.1},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-10-01","added":"2026-09-30","docs_url":"https://enrichlayer.com/docs/api/v2/contact-api/personal-email-lookup","has_example":true,"input":{"queryParams":{"profile_url":{"type":"string","required":false},"twitter_profile_url":{"type":"string","required":false},"facebook_profile_url":{"type":"string","required":false},"email_validation":{"type":"string","required":false,"enum":["none","fast","precise"]},"page_size":{"type":"string","required":false,"note":"Platform calls require a decimal string from 1 to 10; BYOK calls retain the upstream default."}},"note":"Shared-key calls require page_size 1–10 and can omit emails beyond that limit; this endpoint provides no cursor to fetch them. A team key may use the upstream unbounded default."},"strict_query":true,"test_request":{"queryParams":{"profile_url":"https://www.linkedin.com/in/satyanadella","page_size":"1","email_validation":"precise"}},"observed":{"samples":3142,"decided":3077,"ok_rate":0.9994,"p50_ms":1207,"p95_ms":5319,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"fiber-ai.people.contacts.reveal.personal","provider":"fiber-ai","provider_display":"Fiber AI","name":"Find a person's personal email by LinkedIn URL","summary":"Personal emails only, bounce-validated, from a LinkedIn profile","method":"POST","path":"/v1/contact-details/single","scope":"any_account","tier":"core","kind":"data","domain":"contacts","call_template":"treg call fiber-ai.people.contacts.reveal.personal --method POST --data '{\"linkedinUrl\":\"https://www.linkedin.com/in/williamhgates/\",\"enrichmentType\":{\"getWorkEmails\":false,\"getPersonalEmails\":true,\"getPhoneNumbers\":false},\"validateEmails\":true}'","cost":{"type":"per_success","value":2,"currency":"credit","per":1,"unit":"call","source":"observed","source_url":"https://api.fiber.ai/ai-docs/syncQuickContactReveal.md","checked":"2026-10-17","confidence":"verified","note":"Personal email 2 credits on a hit; live personal-only calls reported chargeInfo.creditsCharged 2 on a hit and 0 on a miss.","usd":0.04},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":404,"means":"`Profile not found` — the LinkedIn URL does not resolve to a known person, an expected outcome and free; do not retry the same URL"},"status":null,"status_note":null,"superseded_by":null,"verified":"2026-10-17","added":"2026-10-17","docs_url":"https://api.fiber.ai/ai-docs/syncQuickContactReveal.md","has_example":true,"input":{"bodyType":"json","body":{"linkedinUrl":{"type":"string","required":true,"note":"full LinkedIn URL, bare slug, Sales Navigator URN, or numeric user id","example":"https://www.linkedin.com/in/williamhgates/"},"enrichmentType":{"type":"object","required":true,"note":"exactly these three flags on treg's key","properties":{"getWorkEmails":{"type":"boolean","required":true,"enum":[false]},"getPersonalEmails":{"type":"boolean","required":true,"enum":[true]},"getPhoneNumbers":{"type":"boolean","required":true,"enum":[false]}}},"validateEmails":{"type":"boolean","required":false,"note":"bounce-validate emails before returning; default true; no extra cost"}},"note":"The personal-email split of syncQuickContactReveal. Pay only when a deliverable personal email comes back."},"test_request":{"body":{"linkedinUrl":"https://www.linkedin.com/in/williamhgates/","enrichmentType":{"getWorkEmails":false,"getPersonalEmails":true,"getPhoneNumbers":false},"validateEmails":true}},"observed":{"samples":41238,"decided":38115,"ok_rate":0.9994,"p50_ms":18109,"p95_ms":40402,"last_ok_days":0,"hit_rate":0.3874,"hit_samples":40424}},{"id":"leadmagic.x.personal-email-finder","provider":"leadmagic","provider_display":"LeadMagic","name":"Find a personal email from a profile URL","summary":"Locates personal email addresses associated with a professional profile URL, serving as a fallback when work email is unavailable or undeliverable. ACCURACY WARNING: a 'found' answer is unverified and can belong to someone else entirely — live 2026-09-06, 3 of 5 hits on one team's batch were addresses whose local part did not match the person's name (e.g. a Dennis returned rajasingh…@gmail.com). Verify with people.email.verify before outreach, and do not re-call for the same profile_url: every hit bills 2 credits, including repeats.","method":"POST","path":"/v1/people/personal-email-finder","scope":"","tier":"extended","kind":"data","domain":"contacts","call_template":"treg call leadmagic.x.personal-email-finder --method POST --data '{\"profile_url\":\"https://www.linkedin.com/in/example\"}'","cost":{"type":"per_success","value":2,"currency":"credit","per":1,"unit":"call","source":"docs","source_url":"https://leadmagic.io/pricing","checked":"2026-07-28","confidence":"documented","note":"2 credits if found; free if not found","usd":0.05},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","added":"2026-07-28","docs_url":"https://leadmagic.io/docs/api-reference/personal-email-finder","has_example":true,"input":{"bodyType":"json","body":{"profile_url":{"type":"string","required":true,"example":"https://www.linkedin.com/in/example"}}},"test_request":{"bodyType":"json","body":{"profile_url":"https://www.linkedin.com/in/example"}},"observed":{"samples":100155,"decided":99953,"ok_rate":0.9917,"p50_ms":743,"p95_ms":2042,"last_ok_days":0,"hit_rate":0.4336,"hit_samples":99121},"reviews":{"teams":0,"samples":[{"usefulness":"not_useful","reason":"Returned a personal Gmail for a common-name profile whose handle and birth-year hint clearly don't match the profile's subject; looks like a name collision, with no confidence score to flag it.","client":"mcp","month":"2026-10"},{"usefulness":"useful","reason":"Found a personal email from a LinkedIn URL that matched another provider's result.","client":"mcp","month":"2026-10"},{"usefulness":"partly","reason":"Deliverable mailbox, but the local part bears no relation to the person's name, so identity is unconfirmed. Matches the accuracy warning in the catalog entry.","client":"mcp","month":"2026-09"}]}},{"id":"limadata.people.email.find.personal","provider":"limadata","provider_display":"LimaData","name":"Find a personal email","summary":"Find a personal email from a work email or social profile URL.","method":"POST","path":"/api/v1/find/email_personal","scope":"any_account","tier":"core","kind":"data","domain":"contacts","call_template":"treg call limadata.people.email.find.personal --method POST --data '{\"work_email\":\"person@example.com\"}'","cost":{"type":"per_success","value":5,"currency":"credit","per":1,"unit":"call","source":"docs","source_url":"https://api.limadata.com/docs/basic_v2","checked":"2026-09-17","confidence":"verified","note":"Five credits only when a result is found; a 404 miss is free.","usd":0.1},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":404,"means":"no personal email found for this identifier — a normal outcome (and free), not an API failure"},"status":null,"status_note":null,"superseded_by":null,"verified":"2026-09-17","added":"2026-09-17","docs_url":"https://api.limadata.com/docs/basic_v2","has_example":true,"input":{"bodyType":"json","body":{"linkedin_url":{"type":"string","required":false},"github_url":{"type":"string","required":false},"x_url":{"type":"string","required":false},"work_email":{"type":"string","required":false,"example":"person@example.com"}},"note":"Provide at least one identifier."},"test_request":{"body":{"work_email":"person@example.com"}},"observed":{"samples":42935,"decided":13314,"ok_rate":1.0,"p50_ms":242,"p95_ms":2392,"last_ok_days":0,"hit_rate":0.5127,"hit_samples":4240},"reviews":{"teams":0,"samples":[{"usefulness":"not_useful","reason":"Limadata hit was a garbled address that the bundled verify marked invalid; still billed as a hit.","client":"mcp","month":"2026-10"},{"usefulness":"useful","reason":"Returned a surname-matched personal Gmail for a home-builder owner; overall batch quality is mixed, with roughly half of results belonging to relatives or unrelated people.","client":"mcp","month":"2026-10"},{"usefulness":"useful","reason":"Returned name-match personal Gmail for Dennis Wills that verified valid","client":"mcp","month":"2026-09"}]}},{"id":"sixtyfour.people.email.find.personal","provider":"sixtyfour","provider_display":"Sixtyfour AI","name":"Find a personal email","summary":"Find a personal email from a person's identifying details.","method":"POST","path":"/find-email","scope":"any_account","tier":"core","kind":"data","domain":"contacts","call_template":"treg call sixtyfour.people.email.find.personal --method POST --data '{\"lead\":{\"linkedin_url\":\"https://www.linkedin.com/in/routing-fixture\"},\"mode\":\"PERSONAL\"}'","cost":{"type":"per_success","value":2,"currency":"credit","unit":"call","reported_charge":{"path":"cost_credits","unit":"credit"},"source":"observed","source_url":"https://docs.sixtyfour.ai/guides/credits-and-pricing","checked":"2026-10-16","confidence":"documented","note":"2 credits for a found personal email; the live miss reported cost_credits 0. Exact cost_credits controls settlement.","usd":0.48},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-10-16","docs_url":"https://docs.sixtyfour.ai/api-reference/endpoint/find-email","has_example":true,"input":{"bodyType":"json","body":{"lead":{"type":"object","required":true,"note":"Person identifiers such as name, company, domain or LinkedIn URL."},"verify_emails":{"type":"boolean","required":false,"default":true},"mode":{"type":"string","required":true,"enum":["PERSONAL"],"example":"PERSONAL"}}},"body_allowlist":true,"test_request":{"body":{"lead":{"linkedin_url":"https://www.linkedin.com/in/routing-fixture"},"mode":"PERSONAL"}},"observed":{"samples":448,"decided":215,"ok_rate":0.9907,"p50_ms":14056,"p95_ms":73258,"last_ok_days":0,"hit_rate":0.6197,"hit_samples":213}}],"related_capabilities":[{"endpoint_id":"treg.people.email.find","capability":"people.email.find","does":"Get, find or look up a person's work email address from their name, company domain or LinkedIn profile"},{"endpoint_id":"treg.people.email.verify","capability":"people.email.verify","does":"Check an email address you ALREADY have is real and deliverable — not for finding one"},{"endpoint_id":"treg.people.enrich","capability":"people.enrich","does":"Fill in a person's profile from a LinkedIn URL or other identifier you already hold — job title, employer, seniority, location"},{"endpoint_id":"treg.people.identity.resolve","capability":"people.identity.resolve","does":"Resolve an email or profile to linked identities"},{"endpoint_id":"treg.people.phone.find","capability":"people.phone.find","does":"Find someone's phone number"}],"routing":{"contract":{"identity":[["linkedin_url"],["linkedin_handle"],["email"]],"output":{"email":{"type":"str","required":true,"note":"a personal mailbox (gmail, outlook, …), not the work address"},"verified":{"type":"bool","note":"the provider says it checked the mailbox"}},"miss":"email == null","derive":{"linkedin_url":"linkedin_url(linkedin_handle)","linkedin_handle":"linkedin_handle(linkedin_url)"}},"plan":[{"endpoint_id":"fiber-ai.people.contacts.reveal.personal","accepts":[["linkedin_url"]],"usd":0.04,"hit_rate":0.3874,"usd_per_hit":0.04,"works":0.9994},{"endpoint_id":"aviato.people.email.find.personal","accepts":[["linkedin_url"]],"usd":0.08,"hit_rate":0.3963,"usd_per_hit":0.08,"works":0.9996},{"endpoint_id":"limadata.people.email.find.personal","accepts":[["linkedin_url"],["email"]],"usd":0.1,"hit_rate":0.5127,"usd_per_hit":0.1,"works":1.0},{"endpoint_id":"contactout.people.contact.personal","accepts":[["linkedin_url"]],"usd":0.25,"hit_rate":0.484,"usd_per_hit":0.25,"works":1.0},{"endpoint_id":"sixtyfour.people.email.find.personal","accepts":[["linkedin_url"]],"usd":0.48,"hit_rate":0.6197,"usd_per_hit":0.48,"works":0.9907}],"also":[{"endpoint_id":"enrichlayer.contacts.personal-email","usd":0.1},{"endpoint_id":"leadmagic.x.personal-email-finder","usd":0.05}],"headers":{"X-Treg-Route-Waterfall":"on by default: a miss tries the next provider; 0 = stop at the first miss","X-Treg-Route-Max-Cost":"USD ceiling for the whole call (default 1.00)","X-Treg-Route-Prefer":"provider[,…]","X-Treg-Route-Exclude":"provider[,…]","X-Treg-Route-Strict-Filters":"1 = never call a provider that cannot apply a filter you sent (answers 422, nothing charged); off by default — the answer names what was ignored in X-Treg-Ignored-Filters","X-Treg-Route-Verify":"true = check a hit with treg.people.email.verify in the same call, at its own price, inside X-Treg-Route-Max-Cost; the answer is _treg.verification {verdict, checked, served_by, cost_micro}"}},"call_template":"treg call treg.people.email.find.personal --method POST --data '{\"linkedin_url\":\"https://www.linkedin.com/in/patrickcollison\"}'","example_response":null,"hints":["treg call treg.people.email.find.personal --method POST --data '{\"linkedin_url\":\"https://www.linkedin.com/in/patrickcollison\"}'   # run it — key injected server-side","treg catalog get aviato.people.email.find.personal   # the same job from aviato"]}