Company Search Endpoint

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

country

string

可选

Filter companies with an office based in this country.
This parameter accepts a case-insensitive Alpha-2 ISO3166 country code.

示例值:

region

string

可选

Filter companies with an office based in this country.
This parameter accepts a case-insensitive Alpha-2 ISO3166 country code.

示例值:

United States

city

string

可选

Filter companies based in cities matching the provided search expression.

示例值:

new AND york

type

string

可选

Filter companies of the provided LinkedIn type.

Possible values:

EDUCATIONAL: Educational Institution

GOVERNMENT_AGENCY: Government Agency

NON_PROFIT : Nonprofit

PARTNERSHIP : Partnership

PRIVATELY_HELD : Privately Held

PUBLIC_COMPANY : Public Company

SELF_EMPLOYED : Self-Employed

SELF_OWNED : Sole Proprietorship

示例值:

PRIVATELY_HELD

follower_count_min

string

可选

Filter companies with a LinkedIn follower count more than this value.

示例值:

1000

follower_count_max

string

可选

Filter companies with a LinkedIn follower count less than this value.

示例值:

1000

name

string

可选

Filter companies with a name matching the provided search expression.

示例值:

google OR apple

industry

string

可选

Filter companies belonging to an industry that matches the provided search expression. The industry attribute, found in a LinkedIn Company profile, describes the industry in which the company operates. The value of this attribute is an enumerator. This CSV file provides an exhaustive list of possible values for this attribute.

示例值:

technology

employee_count_max

string

可选

Filter companies with at most this many employees.

示例值:

1000

employee_count_min

string

可选

Filter companies with at least this many employees.

示例值:

1000

description

string

可选

Filter companies with a description matching the provided search expression.

示例值:

medical device

founded_after_year

string

可选

Filter companies founded after this year.

示例值:

1999

founded_before_year

string

可选

Filter companies founded before this year.

示例值:

1999

funding_amount_max

string

可选

Filter companies that have raised at most this much (USD) funding amount.

示例值:

1000000

funding_amount_min

string

可选

Filter companies that have raised at least this much (USD) funding amount.

示例值:

1000000

funding_raised_after

string

可选

Filter companies that have raised funding after this date.

示例值:

2019-12-30

funding_raised_before

string

可选

Filter companies that have raised funding before this date.

示例值:

2019-12-30

public_identifier_in_list

string

可选

A list of public identifiers (the identifying portion of the company’s profile URL).
The target company’s identifier must be a member of this list.

示例值:

stripe,amazon

public_identifier_not_in_list

string

可选

A list of public identifiers (the identifying portion of the company’s profile URL).
The target company’s identifier must not be a member of this list.

示例值:

stripe,amazon

page_size

string

可选

Tune the maximum results returned per API call.

The default value of this parameter is 100.

Accepted values for this parameter is an integer ranging from 1 to 100.

When enrich_profiles=enrich, this parameter accepts value ranging from 1 to 10.

示例值:

enrich_profiles

string

可选

Get the company's complete profile data rather than just the URLs to their LinkedIn profiles.

Each request respond with a streaming response of profiles.

The valid values are:

skip (default): lists company's profile url

enrich: include company's profile data in the list

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

示例值:

enrich

use_cache

string

可选

Define the freshness guarantee on the results returned.

This parameter accepts the following values:
if-present (default value) - Returns result as it is without any freshness guarantee
if-recent - Will make a best effort to return results of profiles no older than 29 days. Costs 1 extra credit
per result on top of the base cost of the endpoint for users on the Growth or larger subscription. For all other
users, it will cost 2 extra credits per result on top of the base cost of the endpoint.

Note: If use_cache=if-recent, page_size is limited to a value of 10 or smaller.

示例值:

if-present

返回响应

🟢200成功

application/json

List of LinkedIn (Company) Profile URL

Body

results

array[object (CompanyResult) {3}]

可选

A list of CompanyResult objects.

linkedin_profile_url

string

可选

The LinkedIn Profile URL of the company

profile

可选

last_updated

string | null

可选

ISO 8601 timestamp since the enriched profile was last scraped.

next_page

string | null

可选

The URL to the next page of search results. This will be null for the final page.

total_result_count

integer

可选

Total number of results found. Not filtered by freshness, as use_cache=if-recent only affects served results, not the count calculation.

示例

{
    "results": [
        {
            "linkedin_profile_url": "https://www.linkedin.com/company/apple/",
            "profile": {
                "linkedin_internal_id": "1441",
                "description": "A problem isn't truly solved until it's solved for all. Googlers build products that help create opportunities for everyone, whether down the street or across the globe. Bring your insight, imagination and a healthy disregard for the impossible. Bring everything that makes you unique. Together, we can build for everyone.\n\nCheck out our career opportunities at careers.google.com.",
                "website": "https://goo.gle/3m1IN7m",
                "industry": "Software Development",
                "company_size": [
                    10001,
                    null
                ],
                "company_size_on_linkedin": 319856,
                "hq": {
                    "country": "US",
                    "city": "Mountain View",
                    "postal_code": "94043",
                    "line_1": "1600 Amphitheatre Parkway",
                    "is_hq": true,
                    "state": "CA"
                },
                "company_type": "PUBLIC_COMPANY",
                "founded_year": null,
                "specialities": [
                    "search",
                    "ads"
                ],
                "locations": [
                    {
                        "country": "US",
                        "city": "Mountain View",
                        "postal_code": "94043",
                        "line_1": "1600 Amphitheatre Parkway",
                        "is_hq": true,
                        "state": "CA"
                    },
                    {
                        "country": "US",
                        "city": "New York",
                        "postal_code": "10011",
                        "line_1": "111 8th Ave",
                        "is_hq": false,
                        "state": "NY"
                    }
                ],
                "name": "Google",
                "tagline": null,
                "universal_name_id": "google",
                "profile_pic_url": "https://s3.us-west-000.backblazeb2.com/proxycurl/company/google/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request&X-Amz-Date=20230119T060024Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=0d3500b39da8db1d2d8f5727a9ac39a7c4a88b4632ed68209dee12f06bc79aca",
                "background_cover_image_url": "https://s3.us-west-000.backblazeb2.com/proxycurl/company/google/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request&X-Amz-Date=20230119T060024Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=abb7a4b87583cffda8db24d58d906c644998fae8cbb99e98c69a35720fcd0050",
                "search_id": "1441",
                "similar_companies": [
                    {
                        "name": "Amazon",
                        "link": "https://www.linkedin.com/company/amazon",
                        "industry": "Software Development",
                        "location": "Seattle, WA"
                    },
                    {
                        "name": "Microsoft",
                        "link": "https://www.linkedin.com/company/microsoft",
                        "industry": "Software Development",
                        "location": "Redmond, Washington"
                    }
                ],
                "affiliated_companies": [
                    {
                        "name": "YouTube",
                        "link": "https://www.linkedin.com/company/youtube",
                        "industry": "Software Development",
                        "location": "San Bruno, CA"
                    },
                    {
                        "name": "Google Cloud",
                        "link": "https://www.linkedin.com/showcase/google-cloud",
                        "industry": "Software Development",
                        "location": "Mountain View, California"
                    }
                ],
                "updates": [
                    {
                        "article_link": null,
                        "image": "https://media.licdn.com/dms/image/C5605AQFthnjiTD6Mvg/videocover-high/0/1660754102856?e=2147483647&v=beta&t=PPOsA9J3vCTXWhuZclqSBQl7DLSDLvy5hKWlkHI85YE",
                        "posted_on": {
                            "day": 13,
                            "month": 9,
                            "year": 2022
                        },
                        "text": "Want to kick start your #LifeAtGoogle but not sure where to begin? Explore our Build Your Future site, where you can learn about developmental programs, learn tips for future interviews, sign up for informational events, and even hear real stories from Googlers who’ve been where you are now. Get started → https://bit.ly/3SKPzQB",
                        "total_likes": 4267
                    },
                    {
                        "article_link": null,
                        "image": "https://media.licdn.com/dms/image/C4D22AQGcvTlKRR3qvQ/feedshare-shrink_2048_1536/0/1672854668558?e=1676505600&v=beta&t=whRRx9ULPEuyw_FgUg4Z3N3O9iksyJW7ewCGZA6ujdg",
                        "posted_on": null,
                        "text": "Ariana, welcome to Google. Here’s to a year full of growth, learning, and experiences at #LifeAtGoogle! 🎉",
                        "total_likes": 397
                    }
                ],
                "follower_count": 27472792
            },
            "last_updated": "2023-10-26T11:34:30Z"
        }
    ],
    "next_page": null,
    "total_result_count": 1
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障

请求参数

示例代码

返回响应