Get company

GET /v1/company $0.0400 per request

Get the LinkedIn company.

Get the LinkedIn company. Required at least one of the query parameters

Try it

Runs against the sandbox, so it is free and needs no API key. The response shape is identical to the live endpoint.

GET /v1/company

Sandbox · free

Parameters

search required

universalName required

url required

Billed equivalent

With a real key this call costs at Starter, less your tier discount.

Response

Query parameters

At least one of url, universalName, search is required.

Parameter	Example	Description
`search` required	—	Company name. It will use LinkedIn search and return the most relevant result.
`universalName` required	—	Universal name of the LinkedIn company profile, can be found in URL (optional)
`url` required	https://www.linkedin.com/company/google/	URL of the LinkedIn company (optional)

Code

curl 'https://api.enricho.io/v1/company?url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fgoogle%2F' \
  -H 'X-API-Key: YOUR_API_KEY'

import requests

response = requests.get(
    "https://api.enricho.io/v1/company",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
    &#039;url': 'https://www.linkedin.com/company/google/',
},
    timeout=30,
)

response.raise_for_status()

# Every response reports what it cost and what is left.
print(response.headers["X-Request-Cost"], response.headers["X-Balance-Remaining"])
print(response.json())

const params = new URLSearchParams({
    "url": "https://www.linkedin.com/company/google/"
});

const response = await fetch(`https://api.enricho.io/v1/company?${params}`, {
  headers: { &#039;X-API-Key': 'YOUR_API_KEY' },
});

if (!response.ok) {
  throw new Error(`${response.status}: ${(await response.json()).error.message}`);
}

console.log(response.headers.get(&#039;X-Request-Cost'));
console.log(await response.json());

$client = new GuzzleHttp\Client();

$response = $client->get(&#039;https://api.enricho.io/v1/company', [
    &#039;headers' => ['X-API-Key' => 'YOUR_API_KEY'],
    &#039;query' => [
        &#039;url' => 'https://www.linkedin.com/company/google/',
    ],
    &#039;timeout' => 30,
]);

echo $response->getHeaderLine(&#039;X-Request-Cost');

$data = json_decode((string) $response->getBody(), true);

Example response

{
    "error": "You need to provide one of the arguments: url, universalName or companyId",
    "status": 400,
    "element": null,
    "query": {
        "searchQuery": {
            "companyUniversalNames": [],
            "companySearches": []
        }
    }
}

Error response

Full list of codes on the errors page.

{
    "error": {
        "code": "invalid_params",
        "message": "company requires at least one of: url, universalName, search.",
        "docs": "https://enricho.io/docs/errors#invalid_params",
        "required_one_of": [
            "url",
            "universalName",
            "search"
        ]
    }
}