# Oceanio Search ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/oceanio/search` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 1 credit per call | | **Documentation** | https://www.piloterr.com/library/oceanio-search | ## Description Search the Ocean.io B2B database by domain to find similar companies, retrieve contact details, employee profiles, and social network links. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/oceanio/search' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Search by domain 'google.com' ```json { "total": 1, "people": { "google.com": [ { "photo": "https://media-exp1.licdn.com/dms/image/C4D03AQE1A-2kuJR5ZA/profile-displayphoto-shrink_800_800/0/1580256970663?e=2147483647&v=beta&t=-oVy6tYUx0VZVHtdl1RdRyuWre7K4CJ8kJUByWCct8U", "last_name": "Condemi", "first_name": "Raffaella" }, { "photo": "https://media-exp1.licdn.com/dms/image/C4D03AQE29O-Tbfkb_A/profile-displayphoto-shrink_200_200/0/1519574142787?e=1661385600&v=beta&t=9Y2_zDDSmNVhN3EPvq7fxWJ9GJOzdlB3xZigyiqCOUk", "last_name": "Grosz", "first_name": "Djonathan" }, { "photo": "https://media-exp1.licdn.com/dms/image/C4D03AQE2TJZJg4fTmg/profile-displayphoto-shrink_200_200/0/1595665580098?e=1639612800&v=beta&t=4giKv9r-DedYwI3fLVNpWCrWoZDllfwtYp1UcUbotEI", "last_name": "Kholani", "first_name": "Huda" } ], "yandex.com": [ { "photo": "https://media-exp1.licdn.com/dms/image/C4D03AQGH7itIEWYS-w/profile-displayphoto-shrink_200_200/0/1607512053171?e=1648684800&v=beta&t=ye8K6s5vpUNR5XiBD57-rquOgum6LqMRzoY0_R2Amgc", "last_name": "Prusakov", "first_name": "Vladimir" }, { "photo": "https://media-exp1.licdn.com/dms/image/C4D03AQHkYhsoMlKqEQ/profile-displayphoto-shrink_200_200/0/1607423522134?e=1654732800&v=beta&t=adcIrj63Iuzy0CzRyRi7EqMS-kR1H-WATl-UZ58ozgE", "last_name": "narbaev", "first_name": "nadir" }, { "photo": "https://media-exp1.licdn.com/dms/image/C4E03AQE17ocokf07AQ/profile-displayphoto-shrink_200_200/0?e=1597881600&v=beta&t=T65vXjzo5EB12QoGqS3CY2XJIqRaosyYESiKVasvJKI", "last_name": "BAYRAM", "first_name": "AKIN" } ], "marcombo.com": [ { "photo": "https://media.licdn.com/dms/image/v2/C4E03AQFzXVASaHow2g/profile-displayphoto-shrink_800_800/profile-displayphoto-shrink_800_800/0/1624357782605?e=1771459200&t=7r-Gy_1gYbScL1-kq86EdZyjJ5HME4ENJ4MEhl1MAEU&v=beta", "last_name": "Soler", "first_name": "Valentina" }, { "photo": "https://media.licdn.com/dms/image/v2/C4E03AQGdnGevR24XVw/profile-displayphoto-shrink_800_800/profile-displayphoto-shrink_800_800/0/1548251057058?e=1770854400&t=Ibp4s1aIEw6ZZuYNMAHHHjsWsaDUdOkH-6GEyapAbY0&v=beta", "last_name": "Lloria Colome", "first_name": "Josep" }, { "photo": "https://media.licdn.com/dms/image/v2/C4E03AQH6GNoNLV5lwA/profile-displayphoto-shrink_800_800/profile-displayphoto-shrink_800_800/0/1600184152971?e=1770249600&t=9AtVLPrJgHXmzwos33T3NsZt01UAOxTKX7TOfAZH3Ds&v=beta", "last_name": "Pazos", "first_name": "Cristina" } ], "wordcruncher.com": { "photo": "https://media.licdn.com/dms/image/v2/D5603AQF5grN6qUa68Q/profile-displayphoto-shrink_200_200/B56ZewOYgIHQAY-/0/1751008250509?e=1770249600&t=S4LIILGC00UAvWEcr4eo8DA_jNVtOZkPg1HkufCqr2g&v=beta", "last_name": "Simpson", "first_name": "Mariah" } }, "results": [ { "url": "https://yandex.com/", "logo": "https://cdn.ocean.io/logos/yandex.com/06e6d49be593e44ad146aca4fd704e7b95827e0c.png", "name": "Yandex", "score": 1, "domain": "yandex.com", "phones": [ { "number": "+7 495 739-70-00", "country": "ru", "primary": true }, { "number": "+7 495 974-35-81", "country": "ru" }, { "number": "+7 499 110-11-33", "country": "ru" }, { "number": "+7 499 646-00-32", "country": "ru" }, { "number": "+31 20 206 6970", "country": "nl" } ], "countries": [ "br", "by", "ch", "cl", "cn", "cz", "fi", "id", "il", "kz", "nl", "ru", "tr", "us" ], "company_size": "I", "people_count": 16417, "website_status": 3, "social_networks": [ { "url": "https://www.facebook.com/yandex.gamesdev/", "platform": "facebook" }, { "url": "https://www.linkedin.com/company/yandex", "platform": "linkedin" }, { "url": "https://www.instagram.com/yandex/_gamesdev/", "platform": "instagram" }, { "url": "https://www.youtube.com/@yandexgamesdev", "platform": "youtube" } ] }, { "url": "https://wordcruncher.com/", "logo": "https://cdn.ocean.io/logos/wordcruncher.com/8255cc5617d89709428e9d5e932be29d0bf5d0ad.png", "name": "WordCruncher", "score": 0.6465531587600708, "domain": "wordcruncher.com", "countries": [ "us" ], "company_size": "11-50", "people_count": 2, "website_status": 1, "social_networks": [ { "url": "https://www.facebook.com/WordCruncherBYU", "platform": "facebook" }, { "url": "https://www.linkedin.com/company/wordcruncher", "platform": "linkedin" } ] }, { "url": "https://www.marcombo.com/", "logo": "https://cdn2.ocean.io/logos/marcombo.com/eae96911bde77e56e8051d5e52391a579512b44b.png", "name": "Ediciones Marcombo", "score": 0.6397462487220764, "domain": "marcombo.com", "emails": "rie@marcombo.com", "phones": [ { "number": "+34 933 18 00 79", "country": "es", "primary": true } ], "countries": [ "es" ], "company_size": "11-50", "people_count": 13, "website_status": 1, "social_networks": [ { "url": "https://www.facebook.com/EdicionesMarcombo/", "platform": "facebook" }, { "url": "https://www.linkedin.com/company/marcombo-ediciones-t-cnicas", "platform": "linkedin" }, { "url": "https://www.instagram.com/edicionesmarcombo/", "platform": "instagram" }, { "url": "https://www.youtube.com/user/MarcomboEditorial", "platform": "youtube" } ] } ], "companies": [ { "url": "https://www.google.com/", "logo": "https://cdn.ocean.io/logos/google.com/695712165c77cdf4b1c56c68bbf5cb6951e03d6c.png", "name": "Google", "domain": "google.com", "emails": [ "account-withdrawal@google.com" ], "phones": [ { "number": "+33 1 85 14 96 65", "country": "fr" }, { "number": "+34 912 15 86 27", "country": "es" }, { "number": "+353 1 533 9837", "country": "ie" } ], "countries": [ "ar", "au", "br", "ca", "ch", "cl", "cn", "co", "de", "es", "fr", "gb", "ie", "il", "in", "it", "mx", "nl", "ph", "pl", "se", "sg", "us" ], "company_size": "I", "people_count": 350846, "social_networks": [ { "url": "https://www.facebook.com/Google", "platform": "facebook" }, { "url": "https://www.linkedin.com/company/google", "platform": "linkedin" }, { "url": "https://kids.youtube.com/privacynotice", "platform": "youtube" }, { "url": "https://www.xing.com/companies/yellowsocks", "platform": "xing" } ] } ] } ``` ### Search by domain 'stripe.com' ```json { "total": 1, "people": { "stripe.com": [ { "photo": "https://media-exp1.licdn.com/dms/image/C4E03AQGItpH9zt3tNg/profile-displayphoto-shrink_200_200/0/1516805094096?e=1652313600&v=beta&t=Bc20n3NFssJjyf995Q-XDPQeLeZTB04yI-qWiWEC6Uw", "last_name": "Patrick", "first_name": "Edigbe" }, { "photo": "https://media.licdn.cn/dms/image/v2/C5103AQGORriAduAmow/profile-displayphoto-shrink_800_800/profile-displayphoto-shrink_800_800/0/1561024414569?e=1769040000&t=Dc4zZfEx_1-lLO8uLRemeDsY4iMUaZguDYp41FcOZs4&v=beta", "last_name": "Asano", "first_name": "Yuki" }, { "photo": "https://media.licdn.cn/dms/image/v2/C5603AQGy0BKMdJikvQ/profile-displayphoto-shrink_800_800/profile-displayphoto-shrink_800_800/0/1560672631328?e=1770854400&t=5x-o1tqczwMpd80UeZDp23-CLGc2vtegCYgFYldbn-E&v=beta", "last_name": "Yang", "first_name": "Maria" } ] }, "results": [], "companies": [ { "url": "https://stripe.com/en-fi", "logo": "https://cdn.ocean.io/logos/stripe.com/008f1d0fbdd803ca864ffb5dc9769e2399a06c7a.png", "name": "Stripe", "domain": "stripe.com", "emails": "androiddashboard@stripe.com", "phones": [ { "number": "+1 458-555-2863", "country": "us", "primary": true }, { "number": "+358 44 5559997", "country": "fi" }, { "number": "+1 647-748-5253", "country": "ca" }, { "number": "+65 6222 3322", "country": "sg" }, { "number": "+44 1234 567890", "country": "gb" }, { "number": "+1 888-926-2289", "country": "us" } ], "countries": [ "au", "br", "ca", "fi", "fr", "gb", "ie", "in", "jp", "ke", "mx", "nl", "sg", "us", "za" ], "company_size": "10001-50000", "people_count": 11670, "social_networks": [ { "url": "https://www.facebook.com/StripeHQ", "platform": "facebook" }, { "url": "https://www.linkedin.com/company/stripe", "platform": "linkedin" }, { "url": "https://youtube.com/@stripe", "platform": "youtube" }, { "url": "https://www.xing.com/companies/stripe", "platform": "xing" } ] } ] } ``` ## Documentation ## Overview The Oceanio Search endpoint queries the Ocean.io B2B intelligence database to find companies similar to or matching a given domain. It returns ranked lookalike results with contact information, key employee profiles, and social network links: ideal for prospecting, competitive analysis, and lead enrichment. ## Quickstart ``` GET https://api.piloterr.com/v2/oceanio/search?query=google.com ``` ## Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `query` | string | yes | Domain name or keyword to search (e.g. `google.com`) | ## Response fields | Field | Type | Description | |---|---|---| | `total` | integer | Number of exact domain matches found | | `people` | object | Map of domain → array of LinkedIn employee profiles | | `results` | array | Semantically similar companies ranked by relevance score | | `results[].score` | number | Relevance score from 0 to 1 | | `results[].domain` | string | Company domain | | `results[].emails` | array/string | Company contact email(s) | | `results[].phones` | array | Phone numbers with country codes | | `results[].countries` | array | ISO country codes where the company is active | | `results[].company_size` | string | Employee count range | | `results[].social_networks` | array | Social media profiles | | `companies` | array | Exact domain match with full company profile | ## Notes - `results` contains semantically similar companies ranked by relevance score; `companies` is the exact match. - Employee profile photos are hosted on LinkedIn CDN and may expire. - When no similar companies exist, `results` may be an empty array. ## Main use cases - Find lookalike companies similar to a competitor for market mapping and prospecting - Enrich CRM records with phone numbers, emails, and social profiles from a domain - Build targeted B2B lead lists by discovering companies in the same niche - Identify key employees at target accounts for outbound sales campaigns