Find people by title and seniority

Filter on title, jobLevel or seniority, then count the people you can reach. Sizing is free.

These three filters describe the person, not the company. title matches job title keywords. jobLevel and seniority match the band of their current role. Use them first, then narrow by place, department or skill.

The filter

Case is exact on the two enums. C-Team works. c-team and CEO do not. Resolve any value with leadocean_list_enum_values (name job_level or seniority). It is free.

Pick jobLevel for a broad band. Pick seniority when you need founders or heads, which jobLevel does not split out.

How many you can reach

Three live counts from leadocean_count_leads, run on 2026-10-01. Each count is mailable people: verified, catch_all_valid or catch_all email, the tool's default. It spent no records.

The third total is above 100,000. The MCP tool reported it as exact. The REST API stops meta.total at 100,000.

Run it from an AI agent

Connect the MCP server at https://api.leadocean.io/mcp (OAuth sign-in, no key pasted), then ask in plain words.

Find Heads of Sales in the US. Size it first, then show me 25.

The agent counts first with the free tool, then calls leadocean_search_leads with this:

{
  "title": ["Head of Sales"],
  "country": ["US"],
  "limit": 25
}

The search costs 1 record per person returned. Rows come back without contact points: profile and resume data, plus has_email, has_phone and email_status flags. We show no sample rows here, because pulling one spends records and we only paste numbers from free calls.

Run it with the API

One flat JSON body to POST /v1/people/search. Filters are arrays of strings, limit is 1 to 100.

curl -X POST "https://api.leadocean.io/v1/people/search" \
  -H "x-api-key: $LEADOCEAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": ["Head of Sales"],
    "country": ["US"],
    "limit": 25
  }'

For the free sizing call, put count=true in the URL (not the body) and set limit to 1.

curl -X POST "https://api.leadocean.io/v1/people/search?count=true" \
  -H "x-api-key: $LEADOCEAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": ["Head of Sales"],
    "country": ["US"],
    "emailStatus": ["verified", "catch_all_valid", "catch_all"],
    "limit": 1
  }'

data comes back empty and meta.countOnly is true. Page through a real search with meta.nextCursor.

Export the list

POST /v1/exports takes the same filters inside a filters object. One export is up to 50,000 rows, and an account can export 500,000 rows a day.

curl -X POST "https://api.leadocean.io/v1/exports" \
  -H "x-api-key: $LEADOCEAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "heads-of-sales-us",
    "filters": {
      "title": ["Head of Sales"],
      "country": ["US"]
    },
    "limit": 5000,
    "preset": "search"
  }'

Poll GET /v1/exports/{id}, then download. Prefer clicking? The Exports page in the app at app.leadocean.io has the filter builder, a column picker, the record price before you start, and a CSV download.

Combine it

• Add country or city to place people. See find people by location.
• Add jobFunction (for example ["Sales & Business Development"]) to reach one department. See find people by department.
• Add keywords to match skills in the person's own profile. See find people by skill.

Once you hold a person, enrich the person for contact details. More ways to build a list are on the lead sources hub.

FAQ