{"slug":"outreach","domain":"web","title":"Contacts: who to write to, and where","summary":"Companies matching a description, the people at them, and their addresses — derived from the company's format, found by a finder, or verified against a mail server.","help":"outreach: building a list of people to write to, as JSON.\n\nRETURNS\n  One JSON object on stdout. `outreach` with no arguments prints every study\n  and what it takes.\n\nFOUR STUDIES, ONE PIPELINE\n  `companies find` turns a description of a market into companies with their\n  mail domains — every name checked against a directory, so a company nobody\n  has a record of is dropped rather than reported. The domain is what the rest\n  of this command takes.\n\n  `email list` is who works there: people from the directory, each with a\n  name, a position and a department, and an address where the company's\n  format is already on file — learned from a real address or a probe, never\n  guessed. With no format on file the people come back without addresses.\n\n  `email search` places ONE named person — by the filed format, a probe, or a\n  finder that charges only when it finds an address — which is how it answers\n  for a new joiner or anybody the directory does not list.\n\n  `contacts expand` goes furthest: colleagues from the directory, addresses\n  derived from the format, and each one checked against a mail server before\n  it comes back. It is the only study that verifies.\n\n  `email person` runs the other way: from an address you already have — a\n  signup, a reply — to who it belongs to, with their name, position, company\n  and LinkedIn, from the people directory. `found: false` is an answer, not a\n  failure: the directory was asked and knows nobody, and a miss is not billed.\n\nWHAT TO GIVE IT\n  A company name is enough. A domain is surer. Surest of all is one address\n  you already have there — it names the domain outright, so there is no lookup\n  to land on the wrong firm.\n\nNOTES\n  A CONFIDENCE IS NOT A DELIVERY CHECK. It says the address follows the\n  company's format; only `contacts expand` opens a mailbox, and that is on\n  unless you turn it off. A company that accepts mail to any local part comes\n  back with `accept_all`, which is worth reading before anybody counts a\n  delivery as proof the person exists.\n\n  Role addresses — info@, sales@ — are MARKED, not dropped. They are the right\n  address for some jobs and the wrong one for outreach, and only the caller\n  knows which.\n\n  `companies find` reports how many names were PROPOSED before checking. The\n  gap between that and what came back is the invention rate: two of twenty\n  means the description is wrong, not that the market is empty.\n\nStudies:\n  companies find  \u003cprompt\u003e\n      a description of a market, and the companies that match it — each one checked to exist\n  email list      \u003ccompany_name\u003e\n      every address a company has published, with positions and the format\n  email verify    \u003cemail\u003e\n      whether one address you already have reaches a mailbox\n  email person    \u003cemail\u003e\n      who is behind one address you already have: their name, job, company and profile\n  email search    \u003ccompany_name\u003e \u003cname\u003e\n      one named person's address — published on the web (with the pages), from the company's format, accepted by its mail server, or from a directory; `basis` says which and `confirmed` whether the server accepted it. `risk` says how far to trust it: confirmed, published, format, unchecked or guess — treat `guess` as no address before sending\n  contacts expand \u003ccompany_name\u003e\n      colleagues at a company with their addresses derived and checked — the one study that verifies\n  people role     \u003ccompany\u003e\n      who holds a role at a company now, from public profile pages, each with the page — a tenth of a cent where a directory charges a third of a dollar; pass the name to `email search` next\n  people find     \u003ctitles\u003e\n      people who describe themselves this way — a title, skills, a place — with no company named, from public profile pages, each with the page: the sourcer's search for candidates, reps or experts\n\nJSON to stdout, so it composes: pipe to `jq` to pick a field, or `\u003e /tmp/…` to keep it.\nRun a study with no arguments — `outreach companies find` — to see what it takes.\n","example_command":"outreach email list argenx","example_output":"","cost_class":"upstream-fetch","tier":"metered","billing_items":["peopledatalabs","millionverifier","trykitt","quickenrich"],"price_per_1k_calls":2.225,"price_is_from":true,"status":"available","commands":["outreach"],"studies":[{"call":"companies find","about":"a description of a market, and the companies that match it — each one checked to exist","args":[{"name":"prompt","positional":true,"list":false,"hint":"who you are trying to reach, as a sentence"},{"name":"size","positional":false,"list":false,"hint":"how many companies to name"}]},{"call":"email list","about":"every address a company has published, with positions and the format","args":[{"name":"company_name","positional":true,"list":false,"hint":"the company's name, or its domain"},{"name":"seed_email","positional":false,"list":false,"hint":"one address you already have there — the surest input"},{"name":"domain","positional":false,"list":false,"hint":"the mail domain, if you know it — beats the name"},{"name":"size","positional":false,"list":false,"hint":"how many to return, 1-25"}]},{"call":"email verify","about":"whether one address you already have reaches a mailbox","args":[{"name":"email","positional":true,"list":false,"hint":"the address to check"}]},{"call":"email person","about":"who is behind one address you already have: their name, job, company and profile","args":[{"name":"email","positional":true,"list":false,"hint":"the address whose owner you want"}]},{"call":"email search","about":"one named person's address — published on the web (with the pages), from the company's format, accepted by its mail server, or from a directory; `basis` says which and `confirmed` whether the server accepted it. `risk` says how far to trust it: confirmed, published, format, unchecked or guess — treat `guess` as no address before sending","args":[{"name":"company_name","positional":true,"list":false,"hint":"the company's name, or its domain"},{"name":"name","positional":true,"list":false,"hint":"the person, as written: \"Sam Jones\""},{"name":"domain","positional":false,"list":false,"hint":"the mail domain, if you know it — beats the name"}]},{"call":"contacts expand","about":"colleagues at a company with their addresses derived and checked — the one study that verifies","args":[{"name":"company_name","positional":true,"list":false,"hint":"the company's name, or its domain"},{"name":"domain","positional":false,"list":false,"hint":"the mail domain, if you know it — skips a lookup that costs and can miss"},{"name":"seed_email","positional":false,"list":false,"hint":"one address you already have there — teaches the format outright"},{"name":"seed_name","positional":false,"list":false,"hint":"the seed's display name, where the format cannot be read without it"},{"name":"titles","positional":false,"list":true,"hint":"comma-separated titles worth writing to; omit for whatever the directory returns"},{"name":"size","positional":false,"list":false,"hint":"how many colleagues to buy — a bill, not a preference"},{"name":"verify","positional":false,"list":false,"hint":"true | false — check each address against a mail server. ON unless you say otherwise"}]},{"call":"people role","about":"who holds a role at a company now, from public profile pages, each with the page — a tenth of a cent where a directory charges a third of a dollar; pass the name to `email search` next","args":[{"name":"company","positional":true,"list":false,"hint":"the company as people write it on their profiles"},{"name":"roles","positional":false,"list":true,"hint":"comma-separated, most wanted first: CTO,VP Engineering,Head of Engineering — default CEO,Founder,CTO"}]},{"call":"people find","about":"people who describe themselves this way — a title, skills, a place — with no company named, from public profile pages, each with the page: the sourcer's search for candidates, reps or experts","args":[{"name":"titles","positional":true,"list":true,"hint":"comma-separated, what the people call themselves: independent sales rep,fractional SDR,ICU nurse"},{"name":"skills","positional":false,"list":true,"hint":"comma-separated words the profile must also carry, any of: SaaS,AI,Kubernetes"},{"name":"with","positional":false,"list":true,"hint":"comma-separated words the profile must carry, every one: commission only,1099"},{"name":"location","positional":false,"list":false,"hint":"where they are, as a profile writes it: Texas, London, Bengaluru"},{"name":"exclude","positional":false,"list":true,"hint":"comma-separated words that rule a profile out: a firm's name, recruiter"},{"name":"size","positional":false,"list":false,"hint":"how many people, 1-50; every ten is one search"}]}],"default_enabled":false,"first_seen":"2026-09-24T13:28:11.419176Z","enabled":false}