Ocean.io
Authentication Type: API Key Description: B2B data enrichment and company/people search platform for finding and enriching business contacts and company information.
Companies
Search and discover companies using comprehensive filtering options including industry, size, location, revenue, and technology stack.
Search Companies
Find companies in the Ocean.io database using filters like industry, company size, location, revenue range, technology stack, and employee count. Results include detailed company information, contact details, and business intelligence data.
Operation Type: Mutation (Write)
Parameters:
- size
number
(default: 50): Number of companies to return (1-10000) - searchAfter
string
(nullable): Pagination token from previous request - industries
array of strings
(nullable): Array of industries to search for (e.g., ["Software", "Technology", "SaaS"]). Available values at /v2/data-fields endpoint. - companySizes
array of strings
(nullable): Array of company sizes (e.g., ["1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001-50000", "50001-100000", "100001-500000", ">500000"]) - includeDomains
array of strings
(nullable): Only return these specific domains (e.g., ["google.com", "microsoft.com"]) - excludeDomains
array of strings
(nullable): Exclude these domains from results (e.g., ["spam.com", "test.com"]) - countries
array of strings
(nullable): Country codes to search (ISO 3166 alpha-2, e.g., ["us", "uk", "ca", "de"]) - ecommerce
boolean
(nullable): Filter by ecommerce companies: true=only ecommerce, false=exclude ecommerce, null=include all - revenues
array of strings
(nullable): Revenue ranges (e.g., ["0-1M", "1-10M", "10-100M", "100-500M", "500-1000M", ">1000M"]) - companiesFiltersJson
string
(nullable): Advanced company filters as JSON. Available filters: lookalikeDomains, yearFounded, countriesCount, employeeCountOcean, mobileApps, locationsCount, departmentSizes, employeeCountLinkedin, industryCategories, excludeIndustries, excludeIndustryCategories, linkedinIndustries, excludeLinkedinIndustries, fundingRound, primaryLocations, otherLocations, webTraffic, socialMedias, technologies, keywords, minRelevance, maxRelevance, headcountGrowth, departmentHeadcountGrowth - peopleFiltersJson
string
(nullable): People filters as JSON to find companies with matching people. Available filters: seniorities, skills, jobTitleKeywords, allJobDescriptions, currentJobDescription, profileDescription, states, excludeStates, excludeCountries, cities, names, departments, fieldsExist, fieldsNotExist, changedPositionAfter, changedPositionBefore, countries, includePeopleIds, includeLinkedinHandles, excludePeopleIds, excludeLinkedinHandles
Returns:
- searchAfter
string
(nullable): Pagination token for next request - detail
string
: Query execution details - total
number
: Total number of matching companies - missingDomains
object
(nullable): Domains that were not found - redirectMap
object
(nullable): Domain redirects mapping - companies
array of objects
: Array of matching companies- company
object
: Company information- domain
string
(nullable): Company domain - name
string
(nullable): Company name - legalName
string
(nullable): Legal company name - description
string
(nullable): Company description - countries
array of strings
(nullable): Countries where company operates - primaryCountry
string
(nullable): Primary country of operation - companySize
string
(nullable): Company size category - industryCategories
array of strings
(nullable): Industry categories - industries
array of strings
(nullable): Specific industries - linkedinIndustry
string
(nullable): LinkedIn industry classification - ecommerce
boolean
(nullable): Whether company is ecommerce - keywords
array of strings
(nullable): Company keywords - employeeCountOcean
number
(nullable): Employee count from Ocean.io - employeeCountLinkedin
number
(nullable): Employee count from LinkedIn - revenue
string
(nullable): Revenue range - yearFounded
number
(nullable): Year company was founded - emails
array of strings
(nullable): Company email addresses - phones
array of objects
(nullable): Company phone numbers- country
string
(nullable): Phone country code - number
string
(nullable): Phone number - primary
boolean
(nullable): Whether this is primary phone
- country
- logo
string
(nullable): Company logo URL - technologies
array of strings
(nullable): Technologies used - technologyCategories
array of strings
(nullable): Technology categories - locations
array of objects
(nullable): Company locations- primary
boolean
(nullable): Whether this is primary location - latitude
number
(nullable): Location latitude - longitude
number
(nullable): Location longitude - country
string
(nullable): Country - locality
string
(nullable): City/locality - region
string
(nullable): Region/state - postalCode
string
(nullable): Postal code - streetAddress
string
(nullable): Street address
- primary
- webTraffic
object
(nullable): Web traffic data- bounceRate
number
(nullable): Website bounce rate - pageViews
number
(nullable): Monthly page views - pagesPerVisit
number
(nullable): Average pages per visit - visits
number
(nullable): Monthly visits
- bounceRate
- fundingRound
object
(nullable): Latest funding information- cbUrl
string
(nullable): Crunchbase URL - date
string
(nullable): Funding date - moneyRaisedInUsd
number
(nullable): Amount raised in USD - type
string
(nullable): Funding round type
- cbUrl
- domain
- relevance
string
(nullable): Search relevance score
- company
Example Usage:
{
"size": 25,
"industries": ["Software", "Technology", "SaaS"],
"companySizes": ["51-200", "201-500"],
"countries": ["us", "ca"],
"ecommerce": false,
"revenues": ["1-10M", "10-100M"]
}
People
Search and enrich people profiles with detailed professional information, work history, and contact data.
Search People
Find people in the Ocean.io database using filters like seniority, department, location, job title, and company criteria. Results include professional profiles with work history, skills, and company information.
Operation Type: Mutation (Write)
Parameters:
- size
number
(default: 50): Number of people to return (1-10000) - searchAfter
string
(nullable): Pagination token from previous request - peoplePerCompany
number
(nullable): Number of people to return per company. Leave null to return all people. - jobTitleThreshold
number
(default: 0.8): Job title similarity threshold (0-1). Default is 0.8 - seniorities
array of strings
(nullable): Array of seniorities (e.g., ["C-Level", "Founder", "Manager", "Individual Contributor"]). Available values at /v2/data-fields endpoint. - departments
array of strings
(nullable): Array of departments (e.g., ["Engineering", "Sales", "Marketing and Advertising"]). Available values at /v2/data-fields endpoint. - countries
array of strings
(nullable): Country codes for people (ISO 3166 alpha-2, e.g., ["us", "uk", "ca"]) - names
array of strings
(nullable): Filter by specific names (e.g., ["John Doe", "Jane Smith"]) - peopleFiltersJson
string
(nullable): Advanced people filters as JSON. Available filters: lookalikeLinkedinHandles, includePeopleIds, includeLinkedinHandles, excludePeopleIds, excludeLinkedinHandles, skills, jobTitleKeywords, allJobDescriptions, currentJobDescription, profileDescription, states, excludeStates, excludeCountries, cities, fieldsExist, fieldsNotExist, changedPositionAfter, changedPositionBefore - companiesFiltersJson
string
(nullable): Company filters as JSON to find people from matching companies. Same filters as searchCompanies endpoint.
Returns:
- people
array of objects
: Array of matching people- id
string
(nullable): Ocean.io person ID - domain
string
(nullable): Company domain - name
string
(nullable): Full name - firstName
string
(nullable): First name - lastName
string
(nullable): Last name - country
string
(nullable): Person's country - state
string
(nullable): Person's state/region - location
string
(nullable): Person's location - linkedinUrl
string
(nullable): LinkedIn profile URL - seniorities
array of strings
(nullable): Seniority levels - departments
array of strings
(nullable): Departments - photo
string
(nullable): Profile photo URL - jobTitle
string
(nullable): Current job title - jobTitleEnglish
string
(nullable): Job title in English - currentJobDescription
string
(nullable): Current job description - summary
string
(nullable): Professional summary - skills
array of strings
(nullable): Professional skills - phone
object
(nullable): Phone information- numbers
array of strings
(nullable): Phone numbers - status
string
(nullable): Phone verification status
- numbers
- email
object
(nullable): Email information- address
string
(nullable): Email address - status
string
(nullable): Email verification status
- address
- company
object
(nullable): Current company- companySize
string
(nullable): Company size - logo
string
(nullable): Company logo URL - name
string
(nullable): Company name
- companySize
- experiences
array of objects
(nullable): Work experience- dateFrom
string
(nullable): Start date - dateTo
string
(nullable): End date - description
string
(nullable): Job description - domain
string
(nullable): Company domain - jobTitle
string
(nullable): Job title
- dateFrom
- id
- detail
string
: Query execution details - total
number
: Total number of matching people - searchAfter
string
(nullable): Pagination token for next request - lookalikePeopleStatuses
object
(nullable): Status of lookalike people searches - redirectMap
object
(nullable): Domain redirects mapping
Example Usage:
{
"size": 50,
"seniorities": ["C-Level", "Manager"],
"departments": ["Engineering", "Sales"],
"countries": ["us", "uk"],
"companiesFiltersJson": "{\"industries\": [\"Software\", \"Technology\"], \"companySizes\": [\"51-200\", \"201-500\"]}"
}
Enrich Person
Enrich a person's profile with detailed professional information, work history, skills, and verified contact data. Supports email and phone reveal with webhook processing for async results.
Operation Type: Mutation (Write)
Parameters:
- oceanId
string
(nullable): Ocean.io person ID if known (e.g., "b8952796be57982d") - name
string
(nullable): Full name of the person (e.g., "John Doe") - firstName
string
(nullable): First name (e.g., "John") - lastName
string
(nullable): Last name (e.g., "Doe") - email
string
(nullable): Email address (e.g., "john.doe@company.com") - jobTitle
string
(nullable): Job title (e.g., "CEO", "Software Engineer") - phone
string
(nullable): Phone number (e.g., "+1 555-123-4567") - linkedin
string
(nullable): LinkedIn profile URL (e.g., "https://www.linkedin.com/in/johndoe") - twitter
string
(nullable): Twitter profile URL (e.g., "https://twitter.com/johndoe") - facebook
string
(nullable): Facebook profile URL (e.g., "https://www.facebook.com/johndoe") - country
string
(nullable): Country code (e.g., "us", "uk", "dk") - companyName
string
(nullable): Company name (e.g., "Ocean ApS", "Google") - companyDomain
string
(nullable): Company domain (e.g., "ocean.io", "google.com") - companyEmail
string
(nullable): Company email (e.g., "hello@ocean.io") - companyPhone
string
(nullable): Company phone (e.g., "+45 12345678") - companyCountry
string
(nullable): Company country code (e.g., "dk", "us") - companyState
string
(nullable): Company state/region (e.g., "California", "Arkansas") - companyCity
string
(nullable): Company city (e.g., "Copenhagen", "San Francisco") - companyAddress
string
(nullable): Company full address (e.g., "Strandgade 6, 1401 Copenhagen") - companyLinkedin
string
(nullable): Company LinkedIn URL (e.g., "https://www.linkedin.com/company/oceanio") - includeEmails
boolean
(default: false): Include verified emails (costs 1 email credit per verified email). REQUIRES webhookUrl for async processing. - includePhones
boolean
(default: false): Include verified phones (costs 1 phone credit per verified phone). REQUIRES webhookUrl for async processing. - webhookUrl
string
(nullable): REQUIRED webhook URL if includeEmails or includePhones is true. Ocean.io will POST results to this URL asynchronously. - personJson
string
(nullable): Advanced person data as JSON string (for complex person matching not covered by above fields)
Returns:
- id
string
(nullable): Ocean.io person ID - domain
string
(nullable): Company domain - name
string
(nullable): Full name - firstName
string
(nullable): First name - lastName
string
(nullable): Last name - country
string
(nullable): Person's country - state
string
(nullable): Person's state/region - location
string
(nullable): Person's location - linkedinUrl
string
(nullable): LinkedIn profile URL - seniorities
array of strings
(nullable): Seniority levels - departments
array of strings
(nullable): Departments - photo
string
(nullable): Profile photo URL - jobTitle
string
(nullable): Current job title - jobTitleEnglish
string
(nullable): Job title in English - currentJobDescription
string
(nullable): Current job description - summary
string
(nullable): Professional summary - skills
array of strings
(nullable): Professional skills - phone
object
(nullable): Phone information- numbers
array of strings
(nullable): Phone numbers - status
string
(nullable): Phone verification status
- numbers
- email
object
(nullable): Email information- address
string
(nullable): Email address - status
string
(nullable): Email verification status
- address
- company
object
(nullable): Current company information- companySize
string
(nullable): Company size - logo
string
(nullable): Company logo URL - name
string
(nullable): Company name
- companySize
- experiences
array of objects
(nullable): Work experience history- dateFrom
string
(nullable): Start date - dateTo
string
(nullable): End date - description
string
(nullable): Job description - domain
string
(nullable): Company domain - jobTitle
string
(nullable): Job title
- dateFrom
Example Usage:
{
"name": "John Doe",
"email": "john.doe@techcorp.com",
"jobTitle": "Senior Software Engineer",
"companyName": "TechCorp",
"companyDomain": "techcorp.com",
"linkedin": "https://www.linkedin.com/in/johndoe",
"includeEmails": false,
"includePhones": false
}
Common Use Cases
Lead Generation:
- Search for companies matching your ideal customer profile by industry and size
- Find decision makers at target companies using seniority and department filters
- Discover companies with specific technology stacks or revenue ranges
- Generate qualified prospect lists with verified contact information
Sales Intelligence:
- Enrich existing leads with comprehensive company and personal data
- Research prospects before outreach with detailed professional backgrounds
- Identify key contacts across departments within target organizations
- Track company growth metrics and funding information for timing outreach
Market Research:
- Analyze company landscapes within specific industries or regions
- Identify emerging companies and growth trends in target markets
- Research competitive intelligence and technology adoption patterns
- Build comprehensive databases of market participants and key players
Data Enrichment:
- Enhance CRM records with up-to-date company and contact information
- Validate and update existing contact databases with current job titles
- Fill in missing data points for leads and prospects automatically
- Maintain data accuracy with real-time professional profile updates