Industry

Try in Postman

The Industry Taxonomy Versions - Standardized Data API provides standardized industry data across the LinkedIn platform. The API offers a hierarchical/tree structure to easily navigate through a comprehensive list of 400+ industries that are aligned with NAICS. This API doesn’t share member personal data as part of the API response.

Industries classify organizations on LinkedIn. They are visible on company pages in the "About" section.

Note

This API may also be referred to as "NAICS Industry" or "Industry Classification" in other contexts.

The service provides the following methods:

  • Get an industry entity by its ID.
  • Batch get industries by their IDs.
  • Get all industries.

How to Retrieve Industry IDs

Use GET_ALL with pagination to list all industries. Industry IDs also appear in responses from other DMA APIs such as Organizational Page Profiles.

Permissions

Permission Description
r_dma_admin_pages_content Retrieve your organization’s posts, comments, reactions, and other engagement data. Retrieve your organization’s pages and their reporting data (including follower, visitor and content analytics).

See Organization Access Control for more information on company page roles.

Member Data Obfuscation

This DMA API has no member data that is obfuscated.

Schema

Field Format Description Required
id integer Industry ID Yes
name MultiLocaleString Industry name in various locales Yes

Retrieve Industry Data

GET

Sample Request

GET https://api.linkedin.com/rest/dmaStandardizedIndustries/{INDUSTRY_ID}?locale=(language:en,country:US)

Sample Response

{
  "name": {
    "localized": {
      "en_US": "Non-profit Organization Management"
    }
  },
  "id": 100
}

Parameters

Field Name Sub-Field Name Description Required Example
locale The locale the country/region data is requested in. "en_US" locale will be used if locale is not provided or not supported. No locale=(language:en,country:US)
language A lowercase two-letter language code as defined by ISO-639. No language:en
country An uppercase two-letter country code as defined by ISO-3166. No country:US

BATCH_GET

Sample Request

GET https://api.linkedin.com/rest/dmaStandardizedIndustries?ids=List(INDUSTRY_ID_1,INDUSTRY_ID_2)&locale=(language:en,country:US)

Sample Response

{
  "results": {
    "100": {
      "name": {
        "localized": {
          "en_US": "Non-profit Organization Management"
        }
      },
      "id": 100
    },
    "101": {
      "name": {
        "localized": {
          "en_US": "Fundraising"
        }
      },
      "id": 101
    }
  },
  "statuses": {},
  "errors": {}
}

Parameters

Field Name Sub-Field Name Description Required Example
ids List of industry IDs. Yes ids=List(INDUSTRY_ID_1,INDUSTRY_ID_2,INDUSTRY_ID_3)
locale The locale the country/region data is requested in. "en_US" locale will be used if locale is not provided or not supported. No locale=(language:en,country:US)
language A lowercase two-letter language code as defined by ISO-639. No language:en
country An uppercase two-letter country code as defined by ISO-3166. No country:US

GET_ALL

Sample Request

GET https://api.linkedin.com/rest/dmaStandardizedIndustries?locale=(language:en,country:US)&start=5&count=3

Sample Response

{
  "paging": {
    "start": 5,
    "count": 3,
    "links": [
      {
        "type": "application/json",
        "rel": "prev",
        "href": "/rest/dmaStandardizedIndustries?start=2&count=3&locale=(country:US,language:en)"
      },
      {
        "type": "application/json",
        "rel": "next",
        "href": "/rest/dmaStandardizedIndustries?start=8&count=3&locale=(country:US,language:en)"
      }
    ]
  },
  "elements": [
    {
      "name": {
        "localized": {
          "en_US": "Semiconductors"
        }
      },
      "id": 7
    },
    {
      "name": {
        "localized": {
          "en_US": "Telecommunications"
        }
      },
      "id": 8
    },
    {
      "name": {
        "localized": {
          "en_US": "Law Practice"
        }
      },
      "id": 9
    }
  ]
}

Parameters

Field Name Sub-Field Name Description Required Example
locale The locale the country/region data is requested in. "en_US" locale will be used if locale is not provided or not supported. No locale=(language:en,country:US)
language A lowercase two-letter language code as defined by ISO-639. No language:en
country An uppercase two-letter country code as defined by ISO-3166. No country:US
start The index of the first item you want results for. Defaults to 0. No start=0
count The number of items you want included on each page of results. There could be fewer items remaining than the value you specify. Defaults to 10. No count=3

API Error Details

HTTP Status Code ERROR MESSAGE DESCRIPTION ERROR RESOLUTION
400 BAD_REQUEST Invalid request. Please verify the API input. Use a valid URL and parameters.
401 EMPTY_ACCESS_TOKEN Empty or expired OAuth2 access token. Use a valid member access token.
403 FORBIDDEN Access to the resource is forbidden. Please check your permissions for this resource. Make sure your developer application is provisioned with the required permissions.
404 NOT_FOUND Could not find entity. Verify the provided entity ID is correct.
500 INTERNAL_SERVER_ERROR Server encountered an unexpected condition that prevented it from fulfilling the request. N/A
  • Last updated on