Share via

Organization Network Size

  • Article

Warning

Deprecation Notice
The Marketing version 202304 (Marketing April 2023) 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.

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": {}
}