Find B2B contacts by country

Filter on country, salesRegion or city, then count the people you can reach. Sizing is free.

These three filters read where the person is. Each has a twin that reads where the company headquarters is, so you can separate a remote hire in Lisbon from a company based there.

The filter

Country is a code, not a name. DE works. Germany does not.

There is also a continent filter (Africa, Antarctica, Asia, Europe, North America, Oceania, South America). Company-side twins are hqCountry, hqSalesRegion, hqContinent, hqState and hqCity.

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.

These count people, not companies. The person's location is the filter, not the employer's.

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 IT directors in London. Size it first, then show me 25.

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

{
  "country": ["GB"],
  "city": ["London"],
  "jobFunction": ["Information Technology"],
  "jobLevel": ["Director"],
  "limit": 25
}

The search costs 1 record per person returned. Use leadocean_search_companies with hqCountry when you want companies based in a country, not people.

Run it with the API

One flat JSON body to POST /v1/people/search. Filters are arrays of strings.

curl -X POST "https://api.leadocean.io/v1/people/search" \
  -H "x-api-key: $LEADOCEAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "country": ["GB"],
    "city": ["London"],
    "jobFunction": ["Information Technology"],
    "jobLevel": ["Director"],
    "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 '{
    "country": ["GB"],
    "city": ["London"],
    "jobFunction": ["Information Technology"],
    "jobLevel": ["Director"],
    "emailStatus": ["verified", "catch_all_valid", "catch_all"],
    "limit": 1
  }'

data comes back empty and meta.countOnly is true. meta.total stops at 100,000 on the REST API.

Each real result carries has_email, has_phone, email_status and email_type under contact_data. Read email_status before you send.

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": "london-it-directors",
    "filters": {
      "country": ["GB"],
      "city": ["London"],
      "jobFunction": ["Information Technology"],
      "jobLevel": ["Director"]
    },
    "limit": 1200,
    "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 jobFunction and jobLevel to reach one buyer in one market. IT Director in London is the third count above. See find people by department.
• Add title or keywords to narrow by role or skill inside a country. See find people by skill.
• Add employeeRange (for example ["11-50"]) to pick a company size, as in the first count.

More ways to build a people list are on the find people hub.

FAQ