Organization Benchmarking
Warning
Deprecation Notice
The Marketing version 202209 (Marketing September 2022) and below has been sunset and the unversioned APIs are going to be sunset soon. We recommend that you migrate to the versioned APIs as well as migrate to the new Content and Community Management APIs to avoid disruptions. See the Migration page for more details.
If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.
Organization APIs provides access to limited publicly available organization data.
Company Search
Use the Company Search API to find organizations using keywords, industry, location, or some other criteria. The example searches for organizations using the keywords "LinkedIn".
Learn more including searching by facets in the Company Search API.
Sample Response
{
"metadata": {
"primaryType": "COMPANIES",
"facetContainers": [
{
"facetType": "network",
"isPremiumFacet": false,
"hasSelectedFacets": false,
"facetValues": [
{
"count": 12,
"isSelected": false,
"value": "F"
}
],
"shortName": "N",
"numSelectedFacets": 0,
"isNotDecorated": true
},
...
]
},
"elements": [
{
"entity": "urn:li:organization:0000"
},
{
"entity": "urn:li:organization:9195954"
},
{
"entity": "urn:li:organization:2790267"
},
{
"entity": "urn:li:organization:9202023"
},
...
],
"paging": {
"total": 46080,
"count": 10,
"start": 0,
"links": [
{
"rel": "next",
"href": "/search?q=companiesV2&baseSearchParams.searchTrackingInfo.searchId=urn%3Ali%3AdeveloperApplication%3A4992581&start=10&count=10&baseSearchParams.viewerId=149435169&baseSearchParams.searchTrackingInfo.searchType=API_ORGANIZATION&fields=entity&baseSearchParams.keywords=LinkedIn+Corporation",
"type": "application/json"
}
]
}
}
Organization Network Size
The Organization Network Size API provides the ability to retrieve the number of first-degree connections for an organization.
GET https://api.linkedin.com/v2/networkSizes/urn:li:organization:1234567?edgeType=CompanyFollowedByMember
Sample Response
{
"firstDegreeSize": 219145
}
Follower Statistics
Organization administrators can access granular follower information using the Follower Statistics API. This endpoint provides the ability to retrieve both lifetime and time-bound statistics.
Your application will need to request the rw_organization_admin member permission in order for your application to successfully make API calls to this endpoint.
GET https://api.linkedin.com/v2/organizationalEntityFollowerStatistics?q=organizationalEntity&organizationalEntity=urn:li:organization:1234
Sample Response
{
"paging": {
"count": 10,
"start": 0
},
"elements": [
{
"totalFollowerCounts": {
"organicFollowerCount": 33916,
"paidFollowerCount": 268
},
"followerCountsByStaffCountRange": [
{
"followerCounts": {
"organicFollowerCount": 6,
"paidFollowerCount": 0
},
"staffCountRange": "SIZE_1"
},
{
"followerCounts": {
"organicFollowerCount": 29,
"paidFollowerCount": 0
},
"staffCountRange": "SIZE_2_TO_10"
},
{
"followerCounts": {
"organicFollowerCount": 5,
"paidFollowerCount": 0
},
"staffCountRange": "SIZE_11_TO_50"
},
{
"followerCounts": {
"organicFollowerCount": 29,
"paidFollowerCount": 0
},
"staffCountRange": "SIZE_51_TO_200"
},
{
"followerCounts": {
"organicFollowerCount": 2,
"paidFollowerCount": 0
},
"staffCountRange": "SIZE_501_TO_1000"
},
{
"followerCounts": {
"organicFollowerCount": 1,
"paidFollowerCount": 0
},
"staffCountRange": "SIZE_1001_TO_5000"
},
...
],
"organizationalEntity": "urn:li:organization:1234"
}
]
}
Organization Shares
Your application may retrieve shares owned by a specific organization. Just use URNs of format urn:li:organization:{id} to retrieve shares for the relevant entity. The shares per owner finder can return up to 1,000 shares. The results are ordered by creation date in descending order.
GET https://api.linkedin.com/v2/shares?q=owners&owners=urn:li:organization:2414183&sharesPerOwner=1000
Sample Response
{
"elements": [
{
"owner": "urn:li:organization:2414183",
"activity": "urn:li:activity:6271118395911999488",
"edited": false,
"created": {
"time": 1495151137000
},
"id": "6271118395953934336",
"lastModified": {
"time": 1495151137000
},
"text": {
"text": "Business France emmène des start-ups au Web Summit de Lisbonne #airmisconseil"
},
"distribution": {
"linkedInDistributionTarget": {
"visibleToGuest": false
}
},
"content": {
"contentEntities": [
{
"entityLocation": "http://www.lemondeinformatique.fr/actualites/lire-business-france-emmene-des-start-ups-au-web-summit-de-lisbonne-66405.html?utm_source=Sociallymap&utm_medium=Sociallymap&utm_campaign=Sociallymap",
"thumbnails": [
{
"imageSpecificContent": {
"size": 54076,
"width": 650,
"height": 433
},
"resolvedUrl": "http://images.itnewsinfo.com/lmi/articles/grande/000000054391.jpg"
}
],
"entity": "urn:li:article:6994272117874578221"
}
],
"description": "8 start-ups françaises IT ont été sélectionnées parmi 60 candidates par la délégation Business France pour participer au Web Summit 2016 qui aura...",
"title": "Business France emmène des start-ups au Web Summit de Lisbonne - Le Monde Informatique"
}
},
],
"paging": {
"total": 1000,
"count": 1,
"start": 0,
"links": [
{
"rel": "next",
"href": "/v2/shares?count=10&owners=urn%3Ali%3Acompany%3A2414183&q=owners&sharesPerOwner=1000&start=10",
"type": "application/json"
}
]
}
}
Share Social Engagement Metrics
For organizational benchmarking, you may want to collect social engagement metrics like the number of likes and comments associated an organization's shares. In this section, we will look at the most efficient way to query the number of comment and likes on a group of shares.
To collect this data, we will need to make two calls. The first to collect share IDs and the second to collect like and comment counts for each share. To slim down the share response payload, we will append a projection parameter to return only the share IDs and pagination details.
GET https://api.linkedin.com/v2/shares?q=owners&owners=urn:li:organization:2414183&sharesPerOwner=1000count=2&projection=(elements*(id),paging)
Sample Response
{
"elements": [
{
"id": "6271124519444840448"
},
{
"id": "6271124358870106112"
}
],
"paging": {
"count": 2,
"links": [
{
"href": "/v2/shares?count=2&owners=urn%3Ali%3Acompany%3A2414183&projection=%28elements*%28id%29%2Cpaging%29&q=owners&sharesPerOwner=1000&start=2",
"rel": "next",
"type": "application/json"
}
],
"start": 0,
"total": 1000
}
}
Now that we've collected the share IDs, we can fetch the comment and like counts for each share. Notice in the request below, we've transformed the share ID into a share URN using the following format: urn:li:share:{id}
GET https://api.linkedin.com/v2/socialActions?ids=urn:li:share:6271124358870106112&ids=urn:li:share:6271124519444840448
Sample Response
{
"errors": {},
"results": {
"urn:li:share:6271124358870106112": {
"commentsSummary": {
"totalFirstLevelComments": 2
},
"likesSummary": {
"totalLikes": 1
},
"target": "urn:li:activity:6271124358823964673"
},
"urn:li:share:6271124519444840448": {
"likesSummary": {
"totalLikes": 1
},
"target": "urn:li:activity:6271124519398707200"
}
},
"statuses": {}
}
Feedback
Submit and view feedback for