Look the address up in a data source first and guess from a name pattern only when the lookup is empty. A lookup returns a checked address. A shared inbox such as hello@ rarely reaches the owner, and a guess must be verified before you send.
TL;DR
- It takes about 15 minutes to size the audience, find one owner's address and check its status.
- The walkthrough spends about 4 records: up to 3 from the search and 1 from the reveal. Counts are free.
- Send only to
verified,catch_all_validorcatch_all. Anything you guessed gets verified first.
Prerequisites
- A LeadOcean API key from app.leadocean.io. The free plan has 1,000 records, one-off, and no card.
- The key in your shell as
$LEADOCEAN_API_KEY. curlandjq.- A target agency domain. The examples use
acme.com.
export LEADOCEAN_API_KEY="paste-your-key-here"Step 1: Size the agency owner audience for free
Count how many owners you can mail before you spend a record. Send count=true and limit=1 as query parameters. Arrays go comma-separated.
curl -s -G https://api.leadocean.io/v1/people/search \
-H "x-api-key: $LEADOCEAN_API_KEY" \
--data-urlencode "title=Agency Owner,Owner" \
--data-urlencode "industry=Marketing and Advertising" \
--data-urlencode "salesRegion=NORAM" \
--data-urlencode "emailStatus=verified,catch_all_valid,catch_all" \
--data-urlencode "count=true" \
--data-urlencode "limit=1" | jq '.meta | {total, totalIsExact, countOnly}'salesRegion takes NORAM, LATAM, EMEA or APAC. Swap in country=GB for one market. The industry value is an exact string, so check it with GET /v1/enums or leadocean_list_enum_values before you change it. Related values such as Advertising Services and Public Relations and Communications Services widen the list.
Step 2: Find the owner at your target agency
Search by company domain and title. The search returns a thin row with no address in it. The row carries a person_id and flags that say whether we hold an email.
curl -s https://api.leadocean.io/v1/people/search \
-H "x-api-key: $LEADOCEAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"domain": ["acme.com"],
"seniority": ["owner", "founder"],
"limit": 3
}' | jq '.data[] | {person_id: .meta.source_ids.person_id, contact_data}'Each person returned costs 1 record. Keep limit small. Agencies rarely say "owner" in a title. You will see founder, managing director, principal and partner, so the seniority filter catches more than a title keyword does. Check the title before you pick one.
Step 3: Reveal the address
Send the person_id to enrich with reveal_email set to true. Enrich takes exactly one of linkedin_url, email, phone or person_id. There is no name plus domain lookup, which is why Step 2 comes first.
curl -s https://api.leadocean.io/v1/people/enrich \
-H "x-api-key: $LEADOCEAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"person_id": "PERSON_ID_FROM_STEP_2", "reveal_email": true}' \
| jq '.data.contact_data | {email_status, contact_emails}'This costs 1 record. A person we hold nothing for is a 404 and costs nothing. If you only want a deliverable work address, GET /v2/people/email/work with the same person_id returns one current-employer address or null. It costs 1 record per call, even when it finds nothing.
Step 4: Read the status before you send
The status says how far to trust the address. verified was tested. catch_all_valid means we confirmed the mailbox on a domain that accepts everything. catch_all means the domain accepts everything and the mailbox is unproven.
curl -s https://api.leadocean.io/v1/people/enrich \
-H "x-api-key: $LEADOCEAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"person_id": "PERSON_ID_FROM_STEP_2", "reveal_email": true}' \
| jq -r '.data.contact_data
| select(.email_status | IN("verified","catch_all_valid","catch_all"))
| .contact_emails[0].email'Empty output means the status failed the filter. LeadOcean gives no refund for bounced emails, so this check is your only protection. Treat catch_all as sendable at low volume, not as proof.
Step 5: Fall back to a name pattern
When the data holds no address, build candidates from the owner's name and the agency domain. Small agencies use a short shape. Pick the one you can confirm from a known address at the same agency.
| Pattern | Example for Jane Doe at Acme |
|---|---|
| first | jane@acme.com |
| first.last | jane.doe@acme.com |
| first initial, last | jdoe@acme.com |
| first initial dot last | j.doe@acme.com |
first="jane"; last="doe"; domain="acme.com"
printf '%s\n' "$first@$domain" "$first.$last@$domain" "${first:0:1}$last@$domain" "${first:0:1}.$last@$domain"Small agencies often use the first-name pattern, but you must confirm it. Never send to a candidate you have not verified. Run each one through an email verifier you trust first. A domain that accepts all mail cannot confirm a single mailbox, so a guess there stays a guess.
What you get
Step 1 is free. We ran it on 2026-10-21 for each sales region with leadocean_count_leads. The counts are mailable owners (verified, catch_all_valid or catch_all, the tool default), not every owner we hold. The filters are title Agency Owner or Owner with industry Marketing and Advertising.
| Region | Mailable agency owners | All matches, any email state | Exact |
|---|---|---|---|
| NORAM | 1,158 | 6,374 | Yes |
| EMEA | 272 | 1,734 | Yes |
| APAC | 74 | 779 | Yes |
| LATAM | 33 | 228 | Yes |
The gap between the two columns is the point. Many owners sit in the data without a checked address, so the mailable list is the smaller, safer one. Title keywords miss founders and managing directors, so widen with seniority when you need volume.
A revealed person comes back in the shape below. This is the response shape from the API reference, with placeholder values.
{
"success": true,
"data": {
"profile_data": { "...": "name, title, company" },
"contact_data": {
"has_email": true,
"email_status": "verified",
"email_type": "work",
"contact_emails": [
{ "email": "jane.doe@acme.com", "type": "work", "status": "verified" }
]
}
}
}Troubleshooting
| Error | Cause | Fix |
|---|---|---|
| 401 | The x-api-key header is missing, or the key is wrong or revoked. | Copy a fresh key from the app and reload $LEADOCEAN_API_KEY. |
| 402 | Your records are spent. On Free the 1,000 are a one-off allowance and do not reset. | Check GET /v1/account, or move to a paid plan. Paid plans slow down at their fair-use pace instead of answering 402. |
| 429 | You went above your plan's rate limit: 5 requests a second on Free, 200 on Agency. | Wait the Retry-After seconds and retry. |
| Empty results | A filter value is not an exact enum string, such as Marketing for Marketing and Advertising. | Call leadocean_list_enum_values for industry and pass the exact string. |
| 404 on enrich | We hold nothing for that person. | Nothing was charged. Try another person_id or fall back to Step 5. |
| Export refused | One export is capped at 50,000 rows a request and 500,000 rows a day. | Split the job across requests and days, or narrow the filters. |
FAQ
Is it legal to email an agency owner you do not know?
Rules differ by country, and this guide is not legal advice. Check the law where your recipient sits and keep your message relevant to their business. Ask your own counsel about anything in doubt.
Why does the search not show the email?
Search returns a thin row with flags such as has_email and email_status. The address comes from enrich with reveal_email set, and that call costs 1 record.
How many agency owners can I get on the free plan?
You have 1,000 records, one-off. Each owner costs about 2: 1 from search and 1 from the reveal. That is roughly 500 owners, minus any 404s that cost nothing.
Can I pull a whole region at once?
Bulk CSV export is not on Free. On a paid plan the Exports page in the app takes the same filters, shows the record price before you start, and gives you a CSV. POST /v1/exports does the same by API, up to 50,000 rows a request.
What if the owner uses a personal address?
Enrich can return a personal address when we hold one, flagged by email_type. Work addresses are the safer default for business outreach. Filter on email_type before you send.
For the same recipe on other owners, see small business owners and Shopify store owners. To compare tools, read email finder tools for agency owners. More recipes live in the blog hub. Plans are on pricing.
Size your agency owner list free, then pull verified addresses
Free to start. No credit card. 1,000 records to spend whenever you like.
Get your free API key →