Enrich company
Match a company with our database and enrich it with additional information.
Cost calculation:
- request contains company domain - 1 credit
- request does not contain company domain - 5 credits
POST /v2/enrich/company
curl \
-X POST https://api.ocean.io/v2/enrich/company?apiToken=string \
-H "Content-Type: application/json" \
-d '{"company":{"name":"Ocean ApS","registrationNumber":"123456789","email":"hello@ocean.io","phone":"+45 12345678","countryCode":"dk","state":"Arkansas","city":"Copenhagen","streetAddress":"Strandgade 6","postalCode":"1401","address":"Strandgade 6, 1401 Copenhagen","facebook":"https://www.facebook.com/oceanio","twitter":"https://twitter.com/oceanio","linkedin":"https://www.linkedin.com/company/oceanio","instagram":"https://www.instagram.com/oceanio","xing":"https://www.xing.com/oceanio","domain":"ocean.io","youtube":"https://www.youtube.com/oceanio"},"people":[{"id":"b8952796be57982d","name":"John Doe","firstName":"John","lastName":"Doe","jobTitle":"CEO","email":"john.doe@example.com","phone":"+45 12345678","facebook":"https://www.facebook.com/johndoe","twitter":"https://twitter.com/johndoe","linkedin":"https://www.linkedin.com/in/johndoe","country":"dk"}]}'
Request examples
{
"company": {
"name": "Ocean ApS",
"registrationNumber": "123456789",
"email": "hello@ocean.io",
"phone": "+45 12345678",
"countryCode": "dk",
"state": "Arkansas",
"city": "Copenhagen",
"streetAddress": "Strandgade 6",
"postalCode": "1401",
"address": "Strandgade 6, 1401 Copenhagen",
"facebook": "https://www.facebook.com/oceanio",
"twitter": "https://twitter.com/oceanio",
"linkedin": "https://www.linkedin.com/company/oceanio",
"instagram": "https://www.instagram.com/oceanio",
"xing": "https://www.xing.com/oceanio",
"domain": "ocean.io",
"youtube": "https://www.youtube.com/oceanio"
},
"people": [
{
"id": "b8952796be57982d",
"name": "John Doe",
"firstName": "John",
"lastName": "Doe",
"jobTitle": "CEO",
"email": "john.doe@example.com",
"phone": "+45 12345678",
"facebook": "https://www.facebook.com/johndoe",
"twitter": "https://twitter.com/johndoe",
"linkedin": "https://www.linkedin.com/in/johndoe",
"country": "dk"
}
]
}
Response examples (200)
{
"domain": "dundermifflinpaper.com",
"countries": [
"us",
"ca"
],
"primaryCountry": "us",
"companySize": "2-10",
"industryCategories": [
"Consumer Electronics",
"Hardware"
],
"industries": [
"Audio",
"Electronics"
],
"ecommerce": true,
"keywords": [
"paper",
"premium copy paper"
],
"employeeCountOcean": 57,
"employeeCountLinkedin": 70,
"revenue": "1-10M",
"yearFounded": 1999,
"description": "Dunder Mifflin Paper Company, Inc. is a fictional paper and office supplies wholesale company featured in the American television series The Office.",
"emails": [
"email1@domain.com",
"email2@domain.com"
],
"phones": [
{
"number": "+1 212 456 7890",
"country": "us",
"primary": true
},
{
"number": "+1 250 555 0199",
"country": "ca"
}
],
"logo": "https://cdn2.ocean.io/companies-logos-v1/domain.com/020539e284d9318e805301b672ad23047c30818a.png",
"technologies": [
"Accesso",
"Adcash",
"Atlassian Jira"
],
"technologyCategories": [
"Security",
"Analytics",
"Blogs"
],
"mobileApps": [
{
"link": "https://www.my.app.com/",
"name": "My awesome app"
}
],
"webTraffic": {
"visits": 10000,
"pageViews": 2155984,
"bounceRate": 0.5227,
"pagesPerVisit": 4.88
},
"medias": {
"linkedin": {
"url": "https://www.linkedin.com/company/dunder-mifflin",
"name": "Dunder Mifflin Paper Company, Inc.",
"handle": "dunder-mifflin"
},
"twitter": {
"url": "https://twitter.com/dunder-mifflin",
"name": "Dunder Mifflin Paper Company, Inc.",
"handle": "dunder-mifflin"
},
"youtube": {
"url": "https://youtube.com/channel/dunder-mifflin",
"name": "Dunder Mifflin Paper Company, Inc.",
"handle": "dunder-mifflin"
},
"facebook": {
"url": "https://facebook.com/dunder-mifflin",
"name": "Dunder Mifflin Paper Company, Inc.",
"handle": "dunder-mifflin"
},
"xing": {
"url": "https://xing.com/dunder-mifflin",
"name": "Dunder Mifflin Paper Company, Inc.",
"handle": "dunder-mifflin"
},
"tiktok": {
"url": "https://tiktok.com/dunder-mifflin",
"name": "Dunder Mifflin Paper Company, Inc.",
"handle": "dunder-mifflin"
},
"instagram": {
"url": "https://instagram.com/dunder-mifflin",
"name": "Dunder Mifflin Paper Company, Inc.",
"handle": "dunder-mifflin"
}
},
"name": "Dunder Mifflin Paper Company",
"legalName": "Dunder Mifflin Paper Company, Inc.",
"locations": [
{
"primary": true,
"latitude": 43.6471,
"longitude": -79.3971,
"country": "us",
"locality": "Scranton",
"region": "Lackawanna County",
"postalCode": "18505",
"streetAddress": "Scranton Business Park, 1725 Slough Ave Suit 200",
"state": "pa",
"regionCode": "PA"
}
],
"departmentSizes": [
{
"size": 10,
"department": "Accounting and Finance"
},
{
"size": 15,
"department": "Sales"
}
],
"rootUrl": "https://dundermifflinpaper.com/",
"faxes": [
{
"number": "5709045026",
"country": "us",
"primary": true
}
],
"impressum": {
"company": "Dunder Mifflin Paper Company, Inc.",
"address": "Scranton Business Park, 1725 Slough Ave Suit 200, Scranton, USA",
"email": "email@dundermifflin.com",
"phone": "+35123456789",
"fax": "+35123456790",
"vat": "123456",
"url": "https://dundermifflinpaper.com/impressum",
"people": [
{
"name": "Michael Scott",
"position": "Regional Manager"
}
]
}
}
Response examples (422)
{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}