Ocean.io
Connect to Ocean.io to search and enrich companies and people, inspect data fields, reveal contact details, and manage segmentations.
Authentication
| Method | Kind | Status | Details |
|---|---|---|---|
| API Key | api_key | available | — |
Call a tool
import { createClient } from "@open-connector/sdk";const oc = createClient({ baseUrl: "https://api.openconnector.dev", apiKey: process.env.OPEN_CONNECTOR_API_KEY!,});const result = await oc.executeTool({ slug: "OCEAN_IO_ADD_MARKED_DOMAINS", connectedAccountId: "conn_...", arguments: { /* match this tool's input schema */ },});import Composio from "@composio/client";const composio = new Composio({ baseURL: "https://api.openconnector.dev/composio", apiKey: process.env.OPEN_CONNECTOR_API_KEY!,});const result = await composio.tools.execute("OCEAN_IO_ADD_MARKED_DOMAINS", { connected_account_id: "conn_...", arguments: { /* match this tool's input schema */ },});oc tools execute OCEAN_IO_ADD_MARKED_DOMAINS --data '{ }'Tool catalog
Available tools
26 callable operations
Add domains to the positive or negative list of a segmentationOCEAN_IO_ADD_MARKED_DOMAINSAppend domains to the positive or negative list of an existing segmentation to steer future results toward good-fit companies and away from poor-fit ones.Connection
Append domains to the positive or negative list of an existing segmentation to steer future results toward good-fit companies and away from poor-fit ones.
Authentication
Connected account requiredTags
Attribute domains to segmentsOCEAN_IO_ATTRIBUTE_SEGMENTATION_DOMAINSAssign each input domain to the closest segment in a segmentation, with a 0-1 match score. The segmentation must have completed successfully first.Connection
Assign each input domain to the closest segment in a segmentation, with a 0-1 match score. The segmentation must have completed successfully first.
Authentication
Connected account requiredTags
Autocomplete companiesOCEAN_IO_AUTO_COMPLETE_COMPANYAuto complete the name searchConnection
Auto complete the name search
Authentication
Connected account requiredTags
Autocomplete job titlesOCEAN_IO_AUTO_COMPLETE_JOB_TITLESAuto complete the job title search.Connection
Auto complete the job title search.
Authentication
Connected account requiredTags
Autocomplete keywordsOCEAN_IO_AUTO_COMPLETE_KEYWORDSAuto complete the keyword search.Connection
Auto complete the keyword search.
Authentication
Connected account requiredTags
Autocomplete locationsOCEAN_IO_AUTO_COMPLETE_LOCATIONSAuto complete the location searchConnection
Auto complete the location search
Authentication
Connected account requiredTags
Autocomplete skillsOCEAN_IO_AUTO_COMPLETE_SKILLSAuto complete the skill search.Connection
Auto complete the skill search.
Authentication
Connected account requiredTags
Create segmentationOCEAN_IO_CREATE_SEGMENTATIONCreate a new segmentation from a list of company domains. Runs asynchronously — poll [Get Segmentation](/docs/getSegmentation) until `status` is `SUCCESSFUL` to read the resulting segments.Connection
Create a new segmentation from a list of company domains. Runs asynchronously — poll [Get Segmentation](/docs/getSegmentation) until `status` is `SUCCESSFUL` to read the resulting segments.
Authentication
Connected account requiredTags
Enrich companiesOCEAN_IO_ENRICH_COMPANIESMatch companies with our database and enrich it with additional information. **Webhook result:** [Documentation](/docs/webhooks/enrich_companies)Connection
Match companies with our database and enrich it with additional information. **Webhook result:** [Documentation](/docs/webhooks/enrich_companies)
Authentication
Connected account requiredTags
Enrich companyOCEAN_IO_ENRICH_COMPANYMatch a company with our database and enrich it with additional information. **Webhook result:** [Documentation](/docs/webhooks/enrich_person_email)Connection
Match a company with our database and enrich it with additional information. **Webhook result:** [Documentation](/docs/webhooks/enrich_person_email)
Authentication
Connected account requiredTags
Enrich peopleOCEAN_IO_ENRICH_PEOPLEMatch people with our database and enrich it with additional information. **Webhook result:** [Documentation](/docs/webhooks/enrich_people)Connection
Match people with our database and enrich it with additional information. **Webhook result:** [Documentation](/docs/webhooks/enrich_people)
Authentication
Connected account requiredTags
Enrich personOCEAN_IO_ENRICH_PERSONMatch a person with our database and enrich it with additional information. **Webhook result:** [Documentation](/docs/webhooks/enrich_person_phone)Connection
Match a person with our database and enrich it with additional information. **Webhook result:** [Documentation](/docs/webhooks/enrich_person_phone)
Authentication
Connected account requiredTags
Get credit balanceOCEAN_IO_GET_CREDIT_BALANCEGet credit balanceConnection
Get credit balance
Authentication
Connected account requiredTags
Get data fieldsOCEAN_IO_GET_DATA_FIELDS_PUBLICProvides a list of all industries and industry categories, technologies and regions searchable by Ocean.io. Calling this endpoint does not consume any credits.Connection
Provides a list of all industries and industry categories, technologies and regions searchable by Ocean.io. Calling this endpoint does not consume any credits.
Authentication
Connected account requiredTags
Get segmentationOCEAN_IO_GET_SEGMENTATIONRetrieve a segmentation by its id, including its segments, traits, and CRM metrics once `status` is `SUCCESSFUL`.Connection
Retrieve a segmentation by its id, including its segments, traits, and CRM metrics once `status` is `SUCCESSFUL`.
Authentication
Connected account requiredTags
Lookup multiple companies by domainOCEAN_IO_LOOKUP_COMPANIESLookup and enrich multiple companies by domain (max 1000). This endpoint provides simple, per-result pricing. **Key features:** - Batch lookup up to 1000 company domains - Domain redirections are handled automatically Returns enriched company data for each domain. Companies not found will have `company: null` in the result.Connection
Lookup and enrich multiple companies by domain (max 1000). This endpoint provides simple, per-result pricing. **Key features:** - Batch lookup up to 1000 company domains - Domain redirections are handled automatically Returns enriched company data for each domain. Companies not found will have `company: null` in the result.
Authentication
Connected account requiredTags
Lookup multiple people by LinkedIn handle or Ocean IDOCEAN_IO_LOOKUP_PEOPLELookup and enrich multiple people by LinkedIn handles and/or Ocean.io IDs (max 1000 total). This endpoint provides simple, per-result pricing. **Key features:** - Batch lookup up to 1000 people (combined total of linkedinHandles + oceanIds) - Provide either linkedinHandles, oceanIds, or both lists Returns only successfully matched people in the response.Connection
Lookup and enrich multiple people by LinkedIn handles and/or Ocean.io IDs (max 1000 total). This endpoint provides simple, per-result pricing. **Key features:** - Batch lookup up to 1000 people (combined total of linkedinHandles + oceanIds) - Provide either linkedinHandles, oceanIds, or both lists Returns only successfully matched people in the response.
Authentication
Connected account requiredTags
Preview - Lookalike companiesOCEAN_IO_PREVIEW_SEARCH_COMPANIES_V3Preview search companies using filters. **Only available for enterprise API customers.**Connection
Preview search companies using filters. **Only available for enterprise API customers.**
Authentication
Connected account requiredTags
Reveal emailsOCEAN_IO_REVEAL_EMAILSGet emails and email statuses for people. **Webhook result:** [Documentation](/docs/webhooks/reveal_emails)Connection
Get emails and email statuses for people. **Webhook result:** [Documentation](/docs/webhooks/reveal_emails)
Authentication
Connected account requiredTags
Reveal phonesOCEAN_IO_REVEAL_PHONESGet phones and phone statuses for people. **Webhook result:** [Documentation](/docs/webhooks/reveal_phones)Connection
Get phones and phone statuses for people. **Webhook result:** [Documentation](/docs/webhooks/reveal_phones)
Authentication
Connected account requiredTags
Lookalike companies search (deprecated)OCEAN_IO_SEARCH_COMPANIESSearch companies using filters.Connection
Search companies using filters.
Authentication
Connected account requiredTags
Lookalike companies searchOCEAN_IO_SEARCH_COMPANIES_V3Search companies using filters. Looking for the legacy endpoint? [Access it here](/docs/searchCompanies)Connection
Search companies using filters. Looking for the legacy endpoint? [Access it here](/docs/searchCompanies)
Authentication
Connected account requiredTags
Search people (deprecated)OCEAN_IO_SEARCH_PEOPLESearch people using filters and/or people IdsConnection
Search people using filters and/or people Ids
Authentication
Connected account requiredTags
Lookalike people searchOCEAN_IO_SEARCH_PEOPLE_V3Search people using filters and/or people Ids Looking for the legacy endpoint? [Access it here](/docs/searchPeople) **Webhook result:** [Email results](/docs/webhooks/people_search_emails) [Phone results](/docs/webhooks/people_search_phones)Connection
Search people using filters and/or people Ids Looking for the legacy endpoint? [Access it here](/docs/searchPeople) **Webhook result:** [Email results](/docs/webhooks/people_search_emails) [Phone results](/docs/webhooks/people_search_phones)
Authentication
Connected account requiredTags
Preview - Lookalike peopleOCEAN_IO_SEARCH_PEOPLE_V3_PREVIEWPreview search people with company information. **Only available for enterprise API customers.**Connection
Preview search people with company information. **Only available for enterprise API customers.**
Authentication
Connected account requiredTags
Warmup companiesOCEAN_IO_WARMUP_COMPANIESCheck available companies in Ocean's database and trigger process of data gathering for the missing ones. Calling this endpoint does not consume any creditsConnection
Check available companies in Ocean's database and trigger process of data gathering for the missing ones. Calling this endpoint does not consume any credits
Authentication
Connected account requiredTags