Filter on industry, employeeRange and hqCountry, then count the people you can reach at those companies. Sizing is free.
These three filters build most company lists: what the company does, how big it is, where it is headquartered. The company search endpoint takes 34 filters in total. The same three work on people search, so one filter set sizes, searches and exports.
The filter
| Filter | Type | Example values | Note |
|---|---|---|---|
industry | array of enum | ["Software Development"], ["Hospitals and Health Care"] | One of 534 exact strings. Resolve with leadocean_list_enum_values (name industry). excludeIndustry takes the same list. |
employeeRange | array of enum | ["11-50"], ["51-200"], ["10001+"] | One of 8 brackets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. |
hqCountry | array of enum | ["US"], ["GB"], ["DE"] | ISO 3166-1 alpha-2, one of 254 values. Resolve with leadocean_list_enum_values (name country). |
Industry strings are exact. Software Development works. SaaS does not. Several near-duplicates exist (Computer Software, Software Development), so search the list first and pick the one your target uses.
How many you can reach
Three live counts from leadocean_count_leads, run on 2026-10-01. Each counts mailable people at the matching companies, not companies: verified, catch_all_valid or catch_all email, the tool's default. None spent a record.
| Filters | Mailable people |
|---|---|
industry Software Development, employeeRange 51-200, hqCountry US, jobLevel C-Team | 28,793 |
industry Hospitals and Health Care, employeeRange 201-500, hqCountry GB, jobLevel C-Team and VP | 329 |
industry Financial Services, employeeRange 11-50, hqCountry DE, jobLevel C-Team | 551 |
The first count also returns a breakdown, with no names and no spent records. Of the 28,793 people, 15,739 are c_suite and 13,054 are owner. 15,824 are located in the US, 806 in IN and 512 in GB: a company headquartered in the US can employ people anywhere.
A company row comes back in four objects: company_data, company_detected_technologies, company_metrics and meta. We did not pull rows for this page, because a row costs a record.
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.
List software companies headquartered in the US with 51 to 200 employees. Size the C-level contacts first, then show me 25 companies.
The agent counts first with the free tool. Then it calls leadocean_search_companies with this:
{
"industry": ["Software Development"],
"employeeRange": ["51-200"],
"hqCountry": ["US"],
"limit": 25
}The search costs 1 record per company returned.
Run it with the API
One flat JSON body to POST /v1/companies/search. Filters are arrays of strings. limit runs 1 to 100, and you page with meta.nextCursor.
curl -X POST "https://api.leadocean.io/v1/companies/search" \
-H "x-api-key: $LEADOCEAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"industry": ["Software Development"],
"employeeRange": ["51-200"],
"hqCountry": ["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/companies/search?count=true" \
-H "x-api-key: $LEADOCEAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"industry": ["Software Development"],
"employeeRange": ["51-200"],
"hqCountry": ["US"],
"limit": 1
}'data comes back empty and meta.countOnly is true. meta.total stops at 100,000. One search pages through at most 10,000 rows, so narrow the filters rather than paging harder.
Export the list
POST /v1/exports takes the same filters inside a filters object and writes people at the matching companies. 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": "us-software-51-200-c-level",
"filters": {
"industry": ["Software Development"],
"employeeRange": ["51-200"],
"hqCountry": ["US"],
"jobLevel": ["C-Team"]
},
"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
technologiesortechnologyCategoriesto keep companies that run a product. See find companies by technology. - Swap
employeeRangeforminEmployeesandmaxEmployeeswhen a bracket is too wide. See find companies by headcount. - Add
investorsorminLastFundingYearto keep funded companies. See find companies by investor and find new companies. The count tool does not take funding filters, so size without them. They narrow the list further at search time.
FAQ
Does the count show companies or people?
People. leadocean_count_leads counts mailable people at companies that match your filters. To see companies, run the search with limit 1 to 100 and read meta.count, which costs 1 record per company returned.
How do I find the exact industry string?
Call leadocean_list_enum_values with name industry and a word in q, such as software. It is free and returns the exact strings. The REST equivalent is GET /v1/enums.
Why is a headquarters country count different from a person country count?
hqCountry filters on where the company is headquartered. country filters on where the person lives. A US company with staff in India matches hqCountry US and country IN.
What does it cost?
Counting is free, as are list_filters and list_enum_values. A search costs 1 record per company returned. The free plan has 1,000 records, one-off, no card. Pro is $499 a month. See pricing.
Size your company list for free, then pull it
Free to start. No credit card. 1,000 records to spend whenever you like.
Get your free API key →