Employee Search Endpoint - LobeChat Plugins

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

page_size

string

可选

Tune the maximum results returned per API call.
The default value of this parameter is 200000.
Accepted values for this parameter is an integer ranging from 1 to 200000.
When enrich_profiles=enrich, this parameter accepts value ranging from 1 to 10 and the default value is 100.

示例值:

linkedin_company_profile_url

string

必需

LinkedIn Profile URL of the target company.

示例值:

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

keyword_regex

string

必需

Job title keyword to search for in regular expression format.

The accepted value for this parameter is a case-insensitive regular expression.

示例值:

ceo|cto

country

string

可选

Limit the result set to the country locality of the profile. For example, set the parameter of country=us if you only want profiles from the US.

This parameter accepts a case-insensitive Alpha-2 ISO3166 country code.

Costs an extra 3 credit per result returned.

示例值:

enrich_profiles

string

可选

Get the full profile of employees instead of only their profile urls.

Each request respond with a streaming response of profiles.

The valid values are:

skip (default): lists employee's profile url

enrich: lists full profile of employees

Calling this API endpoint with this parameter would add 1 credit per employee returned.

示例值:

enrich

resolve_numeric_id

string

可选

Enable support for Company Profile URLs with numerical IDs that you most frequently fetch from Sales Navigator.
We achieve this by resolving numerical IDs into vanity IDs with cached company profiles from LinkDB.
For example, we will turn https://www.linkedin.com/company/1234567890 to https://www.linkedin.com/company/acme-corp -- for which the API endpoint only supports the latter.

This parameter accepts the following values:

false (default value) - Will not resolve numerical IDs.

true - Enable support for Company Profile URLs with numerical IDs.
Costs an extra 2 credit on top of the base cost of the endpoint.

示例值:

false

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

List of employees

Body

employees

array[object (Employee) {3}]

可选

A list of employee profiles (if enriched) and their associated profile URL.

profile_url

string

可选

LinkedIn Profile URL of the employee.

profile

可选

last_updated

string | null

可选

ISO 8601 timestamp since the enriched profile was last scraped.

next_page

string | null

可选

The API URI that will lead to the next page of results. This will be null for the final page.

示例

{
    "employees": [
        {
            "profile_url": "https://www.linkedin.com/in/satyanadella",
            "profile": {
                "public_identifier": "williamhgates",
                "profile_pic_url": "https://media.licdn.com/dms/image/C5616AQH9tkBTUhHfng/profile-displaybackgroundimage-shrink_200_800/0/1614530499015?e=2147483647&v=beta&t=VEoCyedtZulnAVYWT9BXfKHi5OFp8avElNjiz8kjSTU",
                "background_cover_image_url": null,
                "first_name": "Bill",
                "last_name": "Gates",
                "full_name": "Bill Gates",
                "occupation": "Co-chair at Bill & Melinda Gates Foundation",
                "headline": "Co-chair, Bill & Melinda Gates Foundation",
                "summary": "Co-chair of the Bill & Melinda Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.",
                "country": "US",
                "country_full_name": "United States of America",
                "city": "Seattle",
                "state": "Washington",
                "experiences": [
                    {
                        "starts_at": {
                            "day": 1,
                            "month": 1,
                            "year": 2015
                        },
                        "ends_at": null,
                        "company": "Breakthrough Energy ",
                        "company_linkedin_profile_url": "https://www.linkedin.com/company/breakthrough-energy/",
                        "title": "Founder",
                        "description": null,
                        "location": null,
                        "logo_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQGwD9vNu044FA/company-logo_400_400/0/1601560874941?e=1672876800&v=beta&t=VKb6OAHEwlnazKYKm4fc9go-y4zkUv2BT6tosOdQ54Y"
                    },
                    {
                        "starts_at": {
                            "day": 1,
                            "month": 1,
                            "year": 2000
                        },
                        "ends_at": null,
                        "company": "Bill & Melinda Gates Foundation",
                        "company_linkedin_profile_url": "https://www.linkedin.com/company/bill-&-melinda-gates-foundation/",
                        "title": "Co-chair",
                        "description": null,
                        "location": null,
                        "logo_url": "https://media-exp1.licdn.com/dms/image/C4E0BAQE7Na_mKQhIJg/company-logo_400_400/0/1633731810932?e=1672876800&v=beta&t=Mz_ntwD4meCMcgo1L3JqDxBQRabFLIesd0Yz2ciAXNs"
                    }
                ],
                "education": [
                    {
                        "starts_at": {
                            "day": 1,
                            "month": 1,
                            "year": 1973
                        },
                        "ends_at": {
                            "day": 31,
                            "month": 12,
                            "year": 1975
                        },
                        "field_of_study": null,
                        "degree_name": null,
                        "school": "Harvard University",
                        "school_linkedin_profile_url": null,
                        "description": null,
                        "logo_url": "https://media-exp1.licdn.com/dms/image/C4E0BAQF5t62bcL0e9g/company-logo_400_400/0/1519855919126?e=1672876800&v=beta&t=9twXof1JlnNHfFprrDMi-C1Kp55HTT4ahINKHRflUHw"
                    },
                    {
                        "starts_at": null,
                        "ends_at": null,
                        "field_of_study": null,
                        "degree_name": null,
                        "school": "Lakeside School",
                        "school_linkedin_profile_url": null,
                        "description": null,
                        "logo_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQENlfOPKBEk3Q/company-logo_400_400/0/1519856497259?e=1672876800&v=beta&t=v7nJTPaJMfH7WOBjb22dyvNKxAgdPdVd8uLCUkMB1LQ"
                    }
                ],
                "languages": [],
                "accomplishment_organisations": [],
                "accomplishment_publications": [],
                "accomplishment_honors_awards": [],
                "accomplishment_patents": [],
                "accomplishment_courses": [],
                "accomplishment_projects": [],
                "accomplishment_test_scores": [],
                "volunteer_work": [],
                "certifications": [],
                "connections": null,
                "people_also_viewed": [],
                "recommendations": [],
                "activities": [],
                "similarly_named_profiles": [],
                "articles": [],
                "groups": []
            },
            "last_updated": "2023-10-26T11:34:30Z"
        }
    ],
    "next_page": null
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障