Activity Feed API

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.

Note

This API is deprecated. Access is no longer being granted.

activityFeeds allows you to integrate a member's LinkedIn feed into your applications. The API response includes a list of shares created by a member's first-degree network. Only public shares are included in the feed.

Network Shares

Use networkShares to get a member's feed in the form of share URNs. Share URNs can be resolved to expose share details. Shares are sorted in reverse chronological order by time. LinkedIn's homepage and mobile feeds are ordered by relevance algorithms, so there may be an ordering discrepancy between shares returned through the API and shares presented on the LinkedIn homepage.

Parameters

Parameter Required Possible Values
q yes Must be networkShares
before no shareUrn before which to retrieve activities
after no shareUrn after which to retrieve activities
count no The number of shares returned in the elements array. The default is ten.

Network Shares Finder

GET https://api.linkedin.com/v2/activityFeeds?q=networkShares&count=2

Sample Response

{
    "elements": [
        {
            "reference": "urn:li:share:6296467508169965568"
        },
        {
            "reference": "urn:li:share:6296449807997370368"
        }
    ],
    "metadata": {
        "after": "urn:li:share:6296467508169965568",
        "before": "urn:li:share:6296449807997370368"
    },
    "paging": {
        "count": 2,
        "links": [
            {
                "href": "/v2/activityFeeds?count=2&q=networkShares&start=2",
                "rel": "next",
                "type": "application/json"
            }
        ],
        "start": 0,
        "total": 422
    }
}

Resolve Share Details

To access additional details about a share, append a projection parameter to the end of the request and decorate the share URN. For more information on the schema, see Shares API.

Sample Request

GET https://api.linkedin.com/v2/activityFeeds?q=networkShares&after=urn:li:share:6296449807997370368&count=2&projection=(paging,elements*(reference~))

Sample Response

{
    "elements": [
        {
            "reference": "urn:li:share:62964770199161113131",
            "reference~": {
                "activity": "urn:li:activity:62964770198741688323",
                "content": {
                    "contentEntities": [
                        {
                            "description": "I can remember watching 2001: A Space Odyssey, Aliens, and the Terminator being captivated by their provocative ideas and just-out-of-reach technology",
                            "entity": "urn:li:article:8385856535341416181",
                            "entityLocation": "https://www.linkedin.com/pulse/stop-training-jedi-dark-side-tom-radwich",
                            "title": "Stop Training Jedi for the Dark Side"
                        }
                    ],
                    "description": "I can remember watching 2001: A Space Odyssey, Aliens, and the Terminator being captivated by their provocative ideas and just-out-of-reach technology",
                    "shareMediaCategory": "ARTICLE",
                    "title": "Stop Training Jedi for the Dark Side"
                },
                "created": {
                    "actor": "urn:li:person:A7H9RiuFEK",
                    "time": 1501197104000
                },
                "distribution": {
                    "linkedInDistributionTarget": {
                        "visibleToGuest": true
                    }
                },
                "edited": false,
                "id": "6296477019916111872",
                "lastModified": {
                    "actor": "urn:li:person:A7H9RiuFEK",
                    "time": 1501197104000
                },
                "owner": "urn:li:person:A7H9RiuFEK",
                "text": {
                    "annotations": [
                        {
                            "entity": "urn:li:person:B45A7H9Riu",
                            "length": 11,
                            "start": 14
                        }
                    ],
                    "text": "Great article Dwight!"
                }
            }
        },
        {
            "reference": "urn:li:share:62964438685105848323",
            "reference~": {
                "activity": "urn:li:activity:6296467508157390848",
                "content": {
                    "contentEntities": [
                        {
                            "description": "Following up on our list of the #LinkedInTopCompanies people want to work for, my colleague Maya Pope-Chappell wrote about the skills that hiring managers at these companies are looking for. This list is helpful, but it's also generic. Sure, tech companies are looking to hire people with Web Programming or Java Development skills, but can we get more specific than that?",
                            "entity": "urn:li:article:7250224946801247668",
                            "entityLocation": "https://lnkd.in/gDmAebT",
                            "thumbnails": [
                                {
                                    "imageSpecificContent": {
                                        "height": 1319,
                                        "width": 2000
                                    },
                                    "resolvedUrl": "https://media.licdn.com/media-proxy/ext?w=2000&h=1319&f=n&hash=N0UGQsRULCPktm3%2FlTJ08wxFodg%3D&ora=1%2CaFBCTXdkRmpGL2lvQUFBPQ%2CxAVta5g-0R66gRQekFEy8LyCqUH95VRUQJbPTHPhGXz0oYnCfiS2JNjaebKgo0JTOHBewVBnK_LoAmWnS8b7NonqeIkgj5HlOZHjZwRLPRlg0CRNtIM6dEEl58CkUr2nOShLiqEJOH7qYe-6MQRpRC8n-g"
                                }
                            ],
                            "title": "The SPECIFIC Skills That Can Help you Land That Dream Job in 2021"
                        }
                    ],
                    "description": "Following up on our list of the #LinkedInTopCompanies people want to work for, my colleague Maya Pope-Chappell wrote about the skills that hiring managers at these companies are looking for. This list is helpful, but it's also generic. Sure, tech companies are looking to hire people with Web Programming or Java Development skills, but can we get more specific than that?",
                    "shareMediaCategory": "ARTICLE",
                    "title": "The SPECIFIC Skills That Can Help you Land That Dream Job in 2021"
                },
                "created": {
                    "actor": "urn:li:person:uKOX2SiXO_",
                    "time": 1501194836000
                },
                "distribution": {
                    "linkedInDistributionTarget": {
                        "visibleToGuest": true
                    }
                },
                "edited": false,
                "id": "6296467508169965568",
                "lastModified": {
                    "actor": "urn:li:person:uKOX2SiXO_",
                    "time": 1501194836000
                },
                "originalShare": "urn:li:share:62964438685105848323",
                "owner": "urn:li:person:uKOX2SiXO_",
                "resharedShare": "urn:li:share:62964438685105848323"
            }
        }
    ]
}

Resolve Share Owner Details

To get additional details about the creator of the share, apply another decoration to the share owner field.

Sample Request

GET https://api.linkedin.com/v2/activityFeeds?q=networkShares&after=urn:li:share:6296449807997370368&count=1&projection=(paging,elements*(reference~(content,text,created,owner~(id,pictureInfo,localizedFirstName,localizedLastName))))

Sample Response

{
    "elements": [
        {
            "reference": "urn:li:share:629679729347981313131",
            "reference~": {
                "content": {
                    "contentEntities": [
                        {
                            "description": "Microlearning.",
                            "entity": "urn:li:article:8449006968247939303",
                            "entityLocation": "https://learning.linkedin.com/blog/learning-thought-leadership/what_s-good-and-whats-bad-about-microlearning",
                            "thumbnails": [
                                {
                                    "imageSpecificContent": {
                                        "height": 1498,
                                        "size": 453272,
                                        "width": 2254
                                    },
                                    "resolvedUrl": "https://learning.linkedin.com/content/dam/me/learning/blog/2021/Junepics/MicroLearning.jpg"
                                }
                            ],
                            "title": "What\u2019s Good and What\u2019s Bad About Microlearning"
                        }
                    ],
                    "description": "Microlearning.",
                    "shareMediaCategory": "ARTICLE",
                    "title": "What\u2019s Good and What\u2019s Bad About Microlearning"
                },
                "created": {
                    "actor": "urn:li:person:6dRJzSjeZJ",
                    "time": 1501273463000
                },
                "owner": "urn:li:person:6dRJzSjeZJ",
                "owner~": {
                    "croppedImage": "urn:li:media:/AAEAAQAAAAAAAAMlAAAAJDdmNDhlYmEyLTQzMTEtNGFmYS1iMDdiLTg3OTQwNDNlZjFjOA.jpg",
                    "id": "6dRJzSjeZJ",
                    "localizedFirstName": "Hudson",
                    "localizedLastName": "Stanley",
                    "vanityName": "shudson"
                },
                "text": {
                    "text": "In case you missed it...Microlearning and deep learning both have their place..."
                }
            }
        }
    ],
    "paging": {
        "count": 1,
        "links": [
            {
                "href": "/v2/activityFeeds?after=urn%3Ali%3Ashare%3A6296449807997370368&count=1&projection=%28paging%2Celements*%28reference%7E%28content%2Ctext%2Ccreated%2Cowner%7E%28id%2ClocalizedFirstName%2ClocalizedLastName%29%29%29%29&q=networkShares&start=1",
                "rel": "next",
                "type": "application/json"
            }
        ],
        "start": 0,
        "total": 60
    }
}

Comment and Like Counts

It is possible to display the number of comments and likes on a given share in the user interface. To access social action counts, collect all the share URNs returned in the activity feed's response and make an additional batch call to socialActions. For more information, see Social Actions.