Employee Count Endpoint

正式环境

https://nubela.co/proxycurl

GET

/api/linkedin/company/employees/count

Company API

Cost: 1 credit / successful request.
Get a number of total employees of a Company.

Get an employee count of this company from various sources.

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

coy_name_match

string

可选

Include profiles that match the company name. The Employee Count Endpoint works by identifying individual profiles with work experience that provides an exact match to the LinkedIn Company Profile URL provided. Including this option also allows profiles with at least one work experience that exactly matches the specified company name to be included.

This parameter accepts the following values:

include (default value) - Include employees whose profiles match the company name.

exclude - Exclude employees by company name match.

示例值:

include

at_date

string

可选

Time travel back in time and fetch the employee count of a company at any particular date. This parameter takes an ISO8601 timestamp with the representation of "YYYY-MM-DD".

Costs 1 extra credit on top of the base cost of the endpoint for users on the Growth or larger subscription. For all other users, it will cost 5 extra credits.

示例值:

2023-12-31

use_cache

string

可选

if-present: The default behavior. Fetches data from LinkDB cache regardless of age of profile.

if-recent: API will make a best effort to return a fresh data no older than 29 days. Costs an extra 1 credit on top of the cost of the base endpoint.

Note: When use_cache=if-recent, the linkedin_employee_count parameter must be included with a value of 'include'.

示例值:

if-present

linkedin_employee_count

string

可选

Option to include a scraped employee count value from the target company's LinkedIn profile.

Valid values are include and exclude:

exclude (default) : To exclude the scraped employee count.

include : To include the scraped employee count.

Costs an extra 1 credit on top of the base cost of the endpoint.

示例值:

include

employment_status

string

可选

Parameter to tell the API to filter past or current employees.

Valid values are current, past, and all:

current (default) : count current employees

past : count past employees

all : count current & past employees

示例值:

current

url

string

必需

URL of the LinkedIn Company Profile to target.

URL should be in the format of https://www.linkedin.com/company/<public_identifier>

示例值:

https://www.linkedin.com/company/apple/

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://nubela.co/proxycurl/api/linkedin/company/employees/count?url=https://www.linkedin.com/company/apple/'

返回响应

🟢200成功

application/json

Number of employees in a company

Body

total_employee

integer

可选

linkedin_employee_count

integer | null

可选

The scraped value of employee count of this company from it's LinkedIn profile. This value does not respect employement_status parameter. It will always return the curent employee count of this company from LinkedIn.

linkdb_employee_count

integer

可选

The total number of employees found in LinkDB for this company. This value is limited by pre-crawled LinkedIn profiles stored in LinkDB

deprecation_notice

string

可选

示例

{
    "linkedin_employee_count": 529274,
    "linkdb_employee_count": 3
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障

Employee Listing Endpoint

Company Profile Picture Endpoint