Organization Lookup

The Organization Lookup API searches organizations and brand profiles.

Unless otherwise noted, the following rules apply when specifying input parameters:

  • All strings are case insensitive.
  • Multiple words should be joined with a space. The input is URL encoded, so a space translates to "%20". For example, Apple Inc. is encoded to Apple%20Inc.
  • If a search includes multiple words, the complete string is searched. =
  • Wildcards and boolean logic are not supported. For example, *, ?, AND, and OR are unsupported.

For information on how to find organizations with partial or incomplete information, refer to our Organization Search documentation.

Important

Some of these API calls require that the authenticated member has the role type ADMINISTRATOR for the requested organization or organization brand. See Organization Access Control for information on how to retrieve roles through the API.

APIs that do not require administrative access will only return the following fields: id, name, localizedName, vanityName, logoV2, and location. APIs that require administrative access will return all available Organization and Organization Brand fields.

Retrieve Organizations

Use the Organization Lookup API to find organizations using an organization id, a vanity name, or an email domain.

Organization URNs are in the format urn:li:organization:{organization id} and represent a LinkedIn Company Page.

Retrieve an Administered Organization

You can use the 'organization ID' to lookup Organization information on behalf of authenticated members with role type ADMINISTRATOR for that organization. API calls with insufficient permissions receive a 403 Forbidden response.

Sample Request

GET https://api.linkedin.com/v2/organizations/{organization ID}

Retrieve Organization Details by URN Decoration

You can use decoration on any organization URN to get the id, name, localizedName, vanityName, logoV2, and location in the request via the projection query parameter.

For example:

&projection=(elements*(entity~(vanityName)))

Sample Response

{
    "elements": [
        {
            "entity~": {
                "vanityName": "linked-it"
            },
            "entity": "urn:li:organization:1032984"
        }
    ]
}

Find Organization by Vanity Name

You can look up the id, name, localizedName, vanityName, logoV2, and location of any organization using vanityName.

Sample Request

GET https://api.linkedin.com/v2/organizations?q=vanityName&vanityName=Linkedin

Find Organization by Email Domain

You can lookup the id, name, localizedName, vanityName, logoV2, and location of any organization using emailDomain. This returns an array of organizations that match the specified email domain.

Sample Request

GET https://api.linkedin.com/v2/organizations?q=emailDomain&emailDomain=linkedin.com

Sample Response

{
    "elements": [
        {
            "id": 1337,
            "localizedName": "LinkedIn",
            "logoV2": {
                "cropped": "urn:li:digitalmediaAsset:C4D0BAQHnSQoLUKZxqA",
                "cropInfo": {
                    "x": 0,
                    "width": 0,
                    "y": 0,
                    "height": 0
                }
            },
            "name": {
                "localized": {
                    "cs_CZ": "LinkedIn",
                    "da_DK": "LinkedIn",
                    "de_DE": "LinkedIn",
                    "en_US": "LinkedIn",
                    "es_ES": "LinkedIn",
                    "fr_FR": "LinkedIn",
                    "in_ID": "LinkedIn",
                    "it_IT": "LinkedIn",
                    "ja_JP": "LinkedIn",
                    "ko_KR": "LinkedIn",
                    "ms_MY": "LinkedIn",
                    "nl_NL": "LinkedIn",
                    "no_NO": "LinkedIn",
                    "pl_PL": "LinkedIn",
                    "pt_BR": "LinkedIn",
                    "ro_RO": "LinkedIn",
                    "ru_RU": "LinkedIn",
                    "sv_SE": "LinkedIn",
                    "th_TH": "LinkedIn",
                    "tr_TR": "LinkedIn",
                    "zh_CN": "LinkedIn (\u9886\u82f1)",
                    "zh_TW": "LinkedIn"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "vanityName": "linkedin"
        }
    ],
    "paging": {
        "total": 10,
        "count": 10,
        "start": 0,
        "links": []
    }
}

Retrieve Organization Follower Count

The Organization Network Size API provides the ability to retrieve the number of first-degree connections (followers) for any organization.

Sample Request

GET https://api.linkedin.com/v2/networkSizes/urn:li:organization:1234567?edgeType=CompanyFollowedByMember

Sample Response

{
  "firstDegreeSize": 219145
}

Retrieve Organization Brands

Use the Organization Lookup API to find organization brands using an organization brand ID, parent organization ID, or a vanity name.

Organization brand URNs are in the format urn:li:organizationBrand:{id} and represent LinkedIn Showcase Pages.

Retrieve an Administered Organization Brand

You can use the 'organization brand ID' to lookup Organization Brands information on behalf of authenticated members with role type ADMINISTRATOR for that brand. API calls with insufficient permissions receive a 403 Forbidden response.

Sample Request

GET https://api.linkedin.com/v2/organizationBrands/{organization brand ID}

Sample Response

{
    "$URN": "urn:li:organizationBrand:11111111",
    "alternativeNames": [],
    "autoCreated": false,
    "defaultLocale": {
        "country": "US",
        "language": "en"
    },
    "description": {
        "localized": {
            "en_US": "Please follow LinkedIn's Company Page at https://www.linkedin.com/company/linkedin."
        },
        "preferredLocale": {
            "country": "US",
            "language": "en"
        }
    },
    "id": 11111111,
    "industries": [
        "urn:li:industry:94"
    ],
    "localizedDescription": "Please follow LinkedIn's Company Page at https://www.linkedin.com/company/linkedin.",
    "localizedName": "example.com",
    "localizedSpecialties": [],
    "localizedWebsite": "http://www.example.com/",
    "name": {
        "localized": {
            "en_US": "test_product"
        },
        "preferredLocale": {
            "country": "US",
            "language": "en"
        }
    },
    "parentRelationship": {
        "parent": "urn:li:organization:2222222"
    },
    "specialties": [],
    "vanityName": "example.com",
    "versionTag": "2",
    "website": {
        "localized": {
            "en_US": "http://www.example.com/"
        },
        "preferredLocale": {
            "country": "US",
            "language": "en"
        }
    }
}

Find Administered Organization Brands by Parent Organization

You can use this API to look up information about Organization Brands using the parent organization URN on behalf of authenticated members with role type ADMINISTRATOR. This returns an array of brands that belong to the specified parent organization and only brands that are administered by the authenticated member are returned.

Sample Request

GET https://api.linkedin.com/v2/organizations?q=parentOrganization&parent={organization URN}

Sample Response

{
    "elements": [
        {
            "id": 7777777,
            "localizedDescription": "When your friends & colleagues make the news, we make sure you know.",
            "localizedName": "Example",
            "logo": {
                "cropInfo": {
                    "height": 0,
                    "width": 0,
                    "x": 0,
                    "y": 0
                },
                "cropped": "urn:li:media:/p/8/000/206/3de/1111111.png",
                "original": "urn:li:media:/p/8/000/206/3de/1111111.png"
            },
            "name": {
                "localized": {
                    "en_US": "Example"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "staffCountRange": "SIZE_2_TO_10",
            "vanityName": "example"
        },
        {
            "id": 6666666,
            "localizedDescription": "Please follow LinkedIn's Company Page at https://www.linkedin.com/company/linkedin.",
            "localizedName": "Example2.com",
            "logo": {
                "cropInfo": {
                    "height": 0,
                    "width": 0,
                    "x": 0,
                    "y": 0
                },
                "cropped": "urn:li:media:/p/6/000/21b/39d/1221222.png",
                "original": "urn:li:media:/p/6/000/21b/39d/1221222.png"
            },
            "name": {
                "localized": {
                    "en_US": "Example2.com"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "staffCountRange": "SIZE_51_TO_200",
            "vanityName": "example2.com"
        }
    ],
    "paging": {
        "count": 10,
        "links": [],
        "start": 0,
        "total": 2
    }
}

Retrieve Organization Brand Details by URN Decoration

You can use decoration on any organization Brand URN to get the id, name, localizedName, vanityName, logoV2, and location in the request via the projection query parameter.

For example:

&projection=(elements*(entity~(vanityName)))

Sample Response

{
    "elements": [
        {
            "entity~": {
                "vanityName": "linked-it"
            },
            "entity": "urn:li:organizationBrand:11111111"
        }
    ]
}

Find Organization Brand by Vanity Name

You can look up the id, name, localizedName, vanityName, logoV2, and location of any organization brand using vanityName.

Sample Request

GET https://api.linkedin.com/v2/organizationBrands?q=vanityName&vanityName=Linkedin

Retrieve Organization Logos & Cover Photos

The following media fields are returned by the Organization Lookup API for both organizations and organization brands:

The value formats are digitalmediaAsset URNs. For example, urn:li:digitalmediaAsset:123ABC. These URNs need to be decorated in order to return image URLs. Include ~:playableStreams in the projection parameter to request the image URLs. For example:

projection=(elements(*(logoV2(original~:playableStreams))))

For more information, see Digital Media Asset URNs.

Sample Request

GET https://api.linkedin.com/v2/organizations/{organization ID}?projection=(coverPhotoV2(original~:playableStreams,cropped~:playableStreams,cropInfo),logoV2(original~:playableStreams,cropped~:playableStreams,cropInfo))

Schema

Organization

Field Name Type Description
alternativeNames LocaleString [] Alternative names of the entity. There can be multiple names per locale.
coverPhoto CroppedImage Will be deprecated on December 1, 2018. See coverPhotoV2. The entity's background cover image.
coverPhotoV2 CroppedImage The entity's background cover image. The sizes may vary, so clients should handle the given height and width accordingly.
defaultLocale Locale Default locale of the entity.
deleted.time long Deleted timestamp
description MultiLocaleString Description for the entity.
foundedOn Date Date when the entity was founded.
groups GroupUrn[] Groups featured by the organizational entity. Default to empty array.
id long Unique identifier for the entity.
industries IndustryURN[] The industries associated with the entity.
localizedDescription string The locale-specific description of the entity.
localizedName string The locale-specific name of the entity.
localizedSpecialties string[] The locale-specific, admin-defined specialty tags of the entity.
localizedWebsite string The locale-specific website of the entity.
locations LocationInfo[] List of locations for the entity.
name MultiLocaleString Entity's name.
parentRelationship. parent string URN of the parent organization.
parentRelationship. organizationRelationshipType string Type of relationship from child to parent organizations. Possible values:
  • SUBSIDIARY: This organization is a subsidiary of the parent.
  • ACQUISITION: This organization was acquired by the parent.
  • SCHOOL: An associated school of the parent organization. For example, a University's School of Law or a remote campus, or a company-owned university.
parentRelationship. relationshipStatus string The status of a relationship between organizations. Possible values:
  • ACTIVE: The relationship is active.
  • INACTIVE: The relationship is inactive.
specialties.tags[] string [] Admin-defined specialty tags of the entity.
vanityName string Entity's unique name used in URLs.
versionTag string Tag indicating version.
website MultiLocaleString Entity's website.
staffCountRange string Range of the number of staff associated with this entity. Possible values:
  • SIZE_1
  • SIZE_2_TO_10
  • SIZE_11_TO_50
  • SIZE_51_TO_200
  • SIZE_201_TO_500
  • SIZE_501_TO_1000
  • SIZE_1001_TO_5000
  • SIZE_5001_TO_10000
  • SIZE_10001_OR_MORE
schoolAttributes SchoolAttributes School-specific attributes of the organization. If this field exists, then this entity is a school.
overviewPhoto CroppedImage Will be deprecated on December 1, 2018. See overviewPhotoV2. The image used in the Overview tab on the organization's page.
overviewPhotoV2 CroppedImage The image used in the Overview tab on the organization's page.
logo CroppedImage Will be deprecated on December 1, 2018. See logoV2. The entity’s logo.
logoV2 CroppedImage The entity’s logo. The sizes may vary greatly, i.e., 50x50, 100x60, 400x400, so clients should handle the given height and width accordingly.
organizationStatus string Status of the organization, such as operating or out of business. Possible values:
  • OPERATING: Currently operating
  • OPERATING_SUBSIDIARY: Operating as a subsidiary
  • REORGANIZING: Undergoing reorganization
  • OUT_OF_BUSINESS: Out of business
  • ACQUIRED: Acquired by another organization
organizationType string Type of organization. Possible values:
  • PUBLIC_COMPANY: A public company
  • EDUCATIONAL: An educational institution
  • SELF_EMPLOYED: A self-employed business
  • GOVERNMENT_AGENCY: A government agency
  • NON_PROFIT: A non-profit organization
  • SELF_OWNED: A self-owned business
  • PRIVATELY_HELD: A privately held business
  • PARTNERSHIP: A partnership
  • OrganizationBrand

    Field Name Type Description
    alternativeNames LocaleString [] Alternative names of the entity. There can be multiple names per locale.
    coverPhoto CroppedImage Will be deprecated on December 1, 2018. See coverPhotoV2. The entity's background cover image.
    coverPhotoV2 CroppedImage The entity's background cover image. The sizes may vary, so clients should handle the given height and width accordingly.
    defaultLocale Locale Default locale of the entity.
    description MultiLocaleString Map of locale to localized entity's description.
    foundedOn Date Date when the entity was founded.
    id long Unique identifier for the entity.
    industries IndustryURN[] The industries associated with the entity.
    localizedDescription string The locale-specific description of the entity.
    localizedName string The locale-specific name of the entity.
    localizedSpecialties string[] The locale-specific, admin-defined specialty tags of the entity.
    localizedWebsite string The locale-specific website of the entity.
    name MultiLocaleString Entity's name.
    parentRelationship. parent string URN of the parent organization.
    specialties.tags[] string [] Admin-defined specialty tags of the entity.
    vanityName string Entity's unique name used in URLs.
    versionTag string Tag indicating version.
    website MultiLocaleStrin g Entity's website.
    logo CroppedImage Will be deprecated on December 1, 2018. See logoV2. The entity’s logo.
    logoV2 CroppedImage The entity’s logo. The sizes may vary greatly, i.e., 50x50, 100x60, 400x400, so clients should handle the given height and width accordingly.
    pinnedPost string The URN of the entity's pinned post.
    autoCreated boolean Whether the entity was auto-created.

    CroppedImage

    Field Name Type Description
    height int Height of the image
    width int Width of the image
    x int X coordinate of the corner
    y int Y coordinate of the corner
    cropped string Location of the cropped image
    original string Location of the original image

    Date

    Field Name Type Description
    day int Day
    month int Month
    year int Year

    Locale

    Field Name Type Description
    country string An uppercase, two-letter country code as defined by ISO-3166.
    language string A lowercase, two-letter language code as defined by ISO-639.

    LocaleString

    Field Name Type Description
    locale Locale Locale key
    value string String value for locale

    MultiLocaleString

    Field Name Type Description
    localized map (string->string) Map of locale to localized entity's description.
    preferredLocale string The preferred locale to use for entity’s description.

    SchoolAttributes

    Field Name Type Description
    hierarchyClassification string The classification for school hierarchy. Possible values:
    • CONSORTIUM_SYSTEM: A collection of schools and education providers.
    • UNIVERSITY: A university, typically containing individual schools within it.
    • INDEPENDENT_SCHOOL_COLLEGE_PROVIDER: Provides degrees, certs, etc., but typically does not contain individual schools within it.
    • REMOTE_CAMPUS: A separate campus that is at a distance from the primary college area.
    • DISTANCE_LEARNING: A school that provides education solely through online channels.
    legacySchool string Legacy school urn for the organization.
    type string The type of institution. Possible values:
    • PUBLIC: A public school operated by the state, as opposed to being a private enterprise.
    • PRIVATE: A private school, also known as independent school, non-governmental, or non-state school, not administered by a government.
    • PROFIT: A for-profit school operated by a private, profit-seeking business.
    yearLevel string Classification of the length of the institution's educational programs. These levels are defined by the National Center for Education Statistics (http://nces.ed.gov/pubs2015/2015097rev.pdf). Possible values:
    • UNDER_TWO_YEAR: As defined by National Center for Education Statistics: 'This group includes any postsecondary institution that offers programs of less than 2 years’ duration below the baccalaureate level, as well as occupational and vocational schools with programs that do not exceed 1,800 contact hours.'
    • TWO_YEAR: As defined by the National Center for Education Statistics: ': Any postsecondary institution that offers programs of at least 2 but less than 4 years’ duration, as well as occupational and vocational schools with programs of at least 1,800 hours and academic institutions with programs of less than 4 years. Does not include bachelor's-degree-granting institutions where the baccalaureate program can be completed in 3 years.'
    • FOUR_YEAR: As defined by the National Center for Education Statistics: 'Any postsecondary institution that offers programs of at least 4 years’ duration or one that offers programs at or above the baccalaureate level, as well as schools that offer postbaccalaureate certificates only or those that offer graduate programs only.'