Check Companies

Check Companies

Description

Validate whether companies exist in the Workforce dataset before searching employee data. You can check up to 100 companies in a single request, using their LinkedIn company identifiers, to confirm data availability and avoid searching employees for companies that are not in the dataset.

Billing: Please contact Sales

Endpoint

POST api/v1/realtime/social/workforce/v1/company-employees/check-companies

Parameters

Param	Required	Param Type	Description
linkedin_identifiers	Yes	Body Param	List | List of LinkedIn company identifiers to validate. Minimum 1, maximum 100 identifiers per request. For example ["google", "microsoft", "apple", "nonexistent-company"]

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/social/workforce/v1/company-employees/check-companies' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "linkedin_identifiers" : ["test123", "google"]
}'

Example Response

{
    "companies": [
        {
            "linkedin_identifier": "test123",
            "found": false
        },
        {
            "linkedin_identifier": "google",
            "found": true
        }
    ]
}

Each item in the companies array contains:

• linkedin_identifier: The original LinkedIn identifier from the request

• found: Boolean indicating whether the company exists in the dataset.