Piloterr

Oceanio Search

Search the Ocean.io B2B database by domain to find similar companies, retrieve contact details, employee profiles, and social network links.

Credit cost: 1 credit per call

GET
/v2/oceanio/search

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Domain name or keyword to search for similar companies in the Ocean.io B2B database.

Required. Accepts:

  • A domain name (e.g. google.com, stripe.com)
  • A company name or keyword

Example:

google.com

Notes:

  • results contains semantically similar companies ranked by relevance score (0–1).
  • companies contains the exact company matching the queried domain.
  • Employee LinkedIn profiles are returned in the people field, keyed by domain.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/oceanio/search?query=string"

{
  "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"
        }
      ]
    }
  ]
}

{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}