Reactions

Warning

Deprecation Notice: The Marketing Version 202508 (Marketing August 2025) will be sunset on August 17, 2026. We recommend that you migrate to the latest versioned APIs to avoid disruptions. For information on all the supported versions, refer to the migrations documentation. If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.

The Reactions API replaces the likes functionality provided by the existing socialActions endpoint. The new service provides access to "reactions" which are an expansion of likes.

The service currently provides the following methods:

  • Get a Reaction
  • Batch Get a Collection of Reactions
  • Get Reactions on Shares
  • Create a Reaction on a Share
  • Create a Reaction on a Comment
  • Delete a Reaction

For fetching social actions on a share, please visit Social Metadata API. For creating and retrieving a comment, please visit Comments API.

Permissions

Permission Description
w_organization_social_feed Post, comment, and react on posts on behalf of an organization. Restricted to organizations in which the authenticated member has one of the following company page roles:
  • ADMINISTRATOR
  • DIRECT_SPONSORED_CONTENT_POSTER
  • RECRUITING_POSTER
r_organization_social_feed Retrieve organizations' posts, comments, and reactions. Restricted to organizations in which the authenticated member has one of the following company page roles.
  • ADMINISTRATOR
  • DIRECT_SPONSORED_CONTENT_POSTER
w_member_social_feed Post, comment, and react to posts on behalf of an authenticated member.
r_member_social_feed Restricted Retrieve posts, reactions, and likes on behalf of an authenticated member. This permission is granted to select developers only.

For more information about company page roles, refer to Organization Access Control by role.

Reactions

Schema

Field Format Description Required
reactionType Enum String The type of reaction. Possible values are:
  • LIKE: "Like" in the UI
  • PRAISE: "Celebrate" in the UI
  • MAYBE: DEPRECATED. Used to be "Curious" in the UI
  • EMPATHY: "Love" in the UI
  • INTEREST: "Insightful" in the UI
  • APPRECIATION: "Support" in the UI
  • ENTERTAINMENT: "Funny" in the UI
    		•  Yes
    root URN Thread of this social action. For comments on a share, the root of both nested and top level comments would be the share URN. Yes
    created AuditStamp An AuditStamp corresponding to the creation of this resource. Not settable
    lastModified AuditStamp An AuditStamp corresponding to the last modification of this resource. Not settable
    deleted AuditStamp An AuditStamp corresponding to the deletion of this resource. Not settable

    Note

    The MAYBE reactionType (curious in the UI) is deprecated starting from version 202307. Using MAYBE reactionType on CREATE and UPDATE would return 400.

    Get a Reaction

    GET https://api.linkedin.com/rest/reactions/(actor:{encoded personUrn|encoded organizationUrn},entity:{encoded shareUrn|encoded ugcPostUrn|encoded commentUrn})

    Sample Response

    {
    "id": "urn:li:reaction:(urn:li:person:rboDhL7Xsf,urn:li:activity:7067167295080394752)",
    "lastModified": {
        "actor": "urn:li:person:rboDhL7Xsf",
        "time": 1686183251857
    },
    "reactionType": "LIKE",
    "created": {
        "actor": "urn:li:person:rboDhL7Xsf",
        "time": 1686183251857
    },
    "root": "urn:li:activity:7067167295080394752"
}

    Batch Get a Collection of Reactions

    GET https://api.linkedin.com/rest/reactions?ids=List((actor:{encoded personUrn|encoded organizationUrn},entity:{encoded shareUrn|encoded ugcPostUrn|encoded commentUrn}),(actor:{encoded personUrn|encoded organizationUrn},entity:{encoded shareUrn|encoded ugcPostUrn|encoded commentUrn}))

    Sample Response

    {
    "statuses": {
        "(actor:urn%3Ali%3Aperson%3ArboDhL7Xsf,entity:urn%3Ali%3Aactivity%3A7067167295080394752)": 200
    },
    "results": {
        "(actor:urn%3Ali%3Aperson%3ArboDhL7Xsf,entity:urn%3Ali%3Aactivity%3A7067167295080394752)": {
            "id": "urn:li:reaction:(urn:li:person:rboDhL7Xsf,urn:li:activity:7067167295080394752)",
            "lastModified": {
                "actor": "urn:li:person:rboDhL7Xsf",
                "time": 1686183251857
            },
            "reactionType": "LIKE",
            "created": {
                "actor": "urn:li:person:rboDhL7Xsf",
                "time": 1686183251857
            },
            "root": "urn:li:activity:7067167295080394752"
        }
    },
    "errors": {}
}

    Get Reactions on a Share

    Schema

    Field Name Type Description
    sort String (value:CHRONOLOGICAL)- Sort by created date ascending.
    (value:REVERSE_CHRONOLOGICAL) - Sort by created date descending.
    (value:RELEVANCE) - Sort by relevance to the viewer. By default, it's set to (value:REVERSE_CHRONOLOGICAL).    		 
    GET https://api.linkedin.com/rest/reactions/(entity:{entityUrn})?q=entity&sort=(value:REVERSE_CHRONOLOGICAL)

    Sample Response

    {
    "elements": [
        {
            "id": "urn:li:reaction:(urn:li:person:rboDhL7Xsf,urn:li:activity:7067167295080394752)",
            "lastModified": {
                "actor": "urn:li:person:rboDhL7Xsf",
                "time": 1686257332832
            },
            "reactionType": "LIKE",
            "created": {
                "actor": "urn:li:person:rboDhL7Xsf",
                "time": 1686257332832
            },
            "root": "urn:li:activity:7067167295080394752"
        }
    ],
    "paging": {
        "count": 10,
        "start": 0,
        "total": 1,
        "links": []
    }
}

    Create a Reaction on a Share

    Sample Request

    POST https://api.linkedin.com/rest/reactions?actor={encoded organizationUrn|encoded personUrn}

    {
    "root": "{unencoded activityURN for a share|unencoded shareURN|unencoded ugcPostURN}",
    "reactionType": "{REACTION_TYPE}"
}

    Sample Response

    {
    "id": "urn:li:reaction:(urn:li:person:A8xe03Qt10,urn:li:activity:6666)",
    "reactionType": "LIKE",
    "created": {
        "actor": "urn:li:person:A8xe03Qt10",
        "time": 1555543895726
    },
    "root": "urn:li:activity:6666",
    "lastModified": {
        "actor": "urn:li:person:A8xe03Qt10",
        "time": 1555543895726
    }
}

    A successful response returns a 201 Created.

    Create a Reaction on a Comment

    Sample Request

    POST https://api.linkedin.com/rest/reactions?actor={encoded organizationUrn|encoded personUrn}

    {
    "root": "urn:li:comment:(urn:li:activity:6666,120381273128)",
    "reactionType": "{REACTION_TYPE}"
}

    Sample Response

    {
    "id": "urn:li:reaction:(urn:li:person:A8xe03Qt10,urn:li:comment:(urn:li:activity:6666,120381273128)",
    "reactionType": "LIKE",
    "created": {
        "actor": "urn:li:person:A8xe03Qt10",
        "time": 1555543895730
    },
    "root": "urn:li:comment:(urn:li:activity:6666,120381273128)",
    "lastModified": {
        "actor": "urn:li:person:A8xe03Qt10",
        "time": 1555543895730
    }
}

    A successful response returns a 201 Created.

    Delete a Reaction

    DELETE https://api.linkedin.com/rest/reactions/(actor:{encoded personUrn|encoded organizationUrn},entity:{encoded shareUrn|encoded ugcPostUrn|encoded commentUrn})

    A successful response returns a 204 No Content status code.

    • Last updated on