Piloterr

Oceanio Search

GET
/v2/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

Authentification

ApiKeyAuth
x-api-key<token>

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

In: header

Paramètres de requête

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.

Corps de la réponse

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.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"}