Enrich
Enrich company
Match a company with our database and enrich it with additional information.
Webhook result: Documentation
Query Parameters
apiToken?string | null
Header Parameters
x-api-token?string | null
company?Company
The company to match with
people?array<Person>
The people to match company with
fields?array<CompanyField>
Fields to return in the Company objects. Only requesting the fields that are needed will use less bandwidth and result in faster responses. If not specified, all fields are returned that can be seen in the examples.
Example
["domain","countries","primaryCountry","companySize","industryCategories","industries","linkedinIndustry","ecommerce","keywords","employeeCountOcean","employeeCountLinkedin","revenue","yearFounded","description","emails","phones","logo","technologies","technologyCategories","mobileApps","webTraffic","medias","name","legalName","locations","departmentSizes","rootUrl","faxes","impressum","fundingRound"]Response Body
curl -X POST "https://api.ocean.io/v2/enrich/company?apiToken=string" \
-H "x-api-token: string" \
-H "Content-Type: application/json" \
-d '{}'{
"domain": "dundermifflinpaper.com",
"countries": [
"us",
"ca"
],
"primaryCountry": "us",
"companySize": "2-10",
"industryCategories": [
"Consumer Electronics",
"Hardware"
],
"industries": [
"Audio",
"Electronics"
],
"linkedinIndustry": "Computer Software",
"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": [
"[email protected]",
"[email protected]"
],
"phones": [
{
"country": "us",
"number": "+1 212 456 7890",
"primary": true
},
{
"country": "ca",
"number": "+1 250 555 0199"
}
],
"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": {
"bounceRate": 0.5227,
"pageViews": 2155984,
"pagesPerVisit": 4.88,
"visits": 10000
},
"medias": {
"linkedin": {
"handle": "dunder-mifflin",
"name": "Dunder Mifflin Paper Company, Inc.",
"url": "https://www.linkedin.com/company/dunder-mifflin"
},
"twitter": {
"handle": "dunder-mifflin",
"name": "Dunder Mifflin Paper Company, Inc.",
"url": "https://twitter.com/dunder-mifflin"
},
"youtube": {
"handle": "dunder-mifflin",
"name": "Dunder Mifflin Paper Company, Inc.",
"url": "https://youtube.com/channel/dunder-mifflin"
},
"facebook": {
"handle": "dunder-mifflin",
"name": "Dunder Mifflin Paper Company, Inc.",
"url": "https://facebook.com/dunder-mifflin"
},
"xing": {
"handle": "dunder-mifflin",
"name": "Dunder Mifflin Paper Company, Inc.",
"url": "https://xing.com/dunder-mifflin"
},
"tiktok": {
"handle": "dunder-mifflin",
"name": "Dunder Mifflin Paper Company, Inc.",
"url": "https://tiktok.com/dunder-mifflin"
},
"instagram": {
"handle": "dunder-mifflin",
"name": "Dunder Mifflin Paper Company, Inc.",
"url": "https://instagram.com/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": [
{
"department": "Accounting and Finance",
"size": 10
},
{
"department": "Sales",
"size": 15
}
],
"rootUrl": "https://dundermifflinpaper.com/",
"faxes": [
{
"country": "us",
"number": "5709045026",
"primary": true
}
],
"impressum": {
"company": "Dunder Mifflin Paper Company, Inc.",
"address": "Scranton Business Park, 1725 Slough Ave Suit 200, Scranton, USA",
"email": "[email protected]",
"phone": "+35123456789",
"fax": "+35123456790",
"vat": "123456",
"url": "https://dundermifflinpaper.com/impressum",
"people": [
{
"name": "Michael Scott",
"position": "Regional Manager"
}
]
},
"fundingRound": {
"cbUrl": "https://www.crunchbase.com/funding_round/orderyoyo-post-ipo-equity--5c26b0c0",
"date": "2020-01-01",
"moneyRaisedInUsd": 1000000,
"type": "Seed"
},
"redirectedFrom": [
"pol.dk",
"pressen.nu"
],
"headcountGrowth": {
"sixMonths": 10,
"sixMonthsPercentage": 0.2,
"threeMonths": 5,
"threeMonthsPercentage": 0.1,
"twelveMonths": 15,
"twelveMonthsPercentage": 0.3
},
"headcountGrowthPerDepartment": [
{
"department": "Accounting and Finance",
"growth": {
"sixMonths": 10,
"sixMonthsPercentage": 0.2,
"threeMonths": 5,
"threeMonthsPercentage": 0.1,
"twelveMonths": 15,
"twelveMonthsPercentage": 0.3
}
}
]
}{
"detail": "Data gathering process has started. Please try again later."
}{
"detail": "Conflicting API tokens provided in query parameters and headers"
}{
"detail": "Insufficient credits"
}{
"detail": "API token should be provided in headers or query parameters"
}Empty
{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}