Entity Monitoring

Article
05/08/2023

We added this feature to monitor activities that does not reference the regulated member directly. The activities returned will be related to the regulated member but not directly associated or performed by the regulated member.

For example, if the regulated member performs a share and another member comments on the share, this feature will capture the comment activity of the second member and return it in the response. Another example can be when the regulated member is an admin of an organization. Any activities done by the organization will be returned in the regulated member's feed.

In these activities, the owner field will always be that of the regulated member. The actor field, however, will be that of the entity that performed it. In the first example, the actor field will be that of the second member.

Supported Use Cases

Comments and Likes on a Share
Comments and Likes on an Article
Comments and Likes on a Work Anniversary
Comments and Likes on a Job Change
Invitations Received
Endorsements Received
Recommendation Requests Received
Recommendations Received
Messages Received
[Coming soon] Organization Shares
[Coming soon] Organization Comments and Likes
[Coming soon] Organization Job Postings

When a regulated member performs a share, any subsequent comments and likes on that share will be captured in the API. The owner field will have the regulated member's personUrn whereas the actor field will have the personUrn who performed the comment/like. See below for an example:

Note

Comment edits made by a non-regulated member will not be captured.

{
  "owner": "urn:li:person:KPA1hpZ1yM",
  "resourceId": "6318971194909560123",
  "configVersion": 24,
  "method": "CREATE",
  "activity": {
    "actor": "urn:li:person:V9W_L_bioc",
    "created": {
      "actor": "urn:li:person:V9W_L_bioc",
      "time": 1506560133675
    },
    "lastModified": {
      "actor": "urn:li:person:V9W_L_bioc",
      "time": 1506560133675
    },
    "id": "6318971194909560832",
    "message": {
      "attributes": [

      ],
      "text": "entity monitoring comment!"
    },
    "object": "urn:li:activity:6318969988023746123"
  },
  "parentSiblingActivities": [

  ],
  "resourceName": "socialActions/comments",
  "resourceUri": "/socialActions/urn:li:activity:6318969988023746123/comments/63189711949095608123",
  "actor": "urn:li:person:V9W_L_bioc",
  "processedAt": 1506560145059,
  "capturedAt": 1506560133816,
  "processedActivity": {
    "actor": "urn:li:person:V9W_L_bioc",
    "actor~": {...},
    "created": {
      "actor": "urn:li:person:V9W_L_bioc",
      "actor~": {...},
      "time": 1506560133675
    },
    "id": "6318971194909560832",
    "lastModified": {
      "actor": "urn:li:person:V9W_L_bioc",
      "actor~": {...},
      "time": 1506560133675
    },
    "message": {
      "attributes": [

      ],
      "text": "entity monitoring comment!"
    },
    "object~": {
      "actor": "urn:li:person:yrZCpj2ZYQ",
      "domainEntity~": {
        "owner": "urn:li:person:yrZCpj2ZYQ",
        "owner~": {...},
        "created": {
          "actor": "urn:li:person:yrZCpj2ZYQ",
          "actor~": {...},
          "time": 1531329595651
        },
        "text": {
          "text": "this is a share"
        },
        "lastModified": {
          "actor": "urn:li:person:yrZCpj2ZYQ",
          "time": 1531329806139
        },
        "distribution": {
          "linkedInDistributionTarget": {
            "visibleToGuest": true
          }
        }
      },
      "actor~": {...},
      "verb": "linkedin:share",
      "domainEntity": "urn:li:share:6422861848344821123",
      "object": "urn:li:share:6422861848344821123"
    },
    "object": "urn:li:activity:6318969988023746561"
  },
  "siblingActivities": [

  ],
  "id": 20744452
}

Comments and Likes on an Article

When a regulated member performs an article, any subsequent comments and likes on that share will be captured in the API. The owner field will have the regulated member's personUrn whereas the actor field will have the personUrn who performed the comment/like. See below for an example:

Note

Comment edits made by a non-regulated member will not be captured.

sample response of a like on an article

{
  "owner": "urn:li:person:KPA1hpZ1yM",
  "resourceId": "urn:li:article:7980097982484950123",
  "configVersion": 13,
  "method": "CREATE",
  "activity": {
    "actor": "urn:li:person:V9W_L_bioc",
    "created": {
      "actor": "urn:li:person:V9W_L_bioc",
      "time": 1506560737726
    },
    "lastModified": {
      "actor": "urn:li:person:V9W_L_bioc",
      "time": 1506560737726
    },
    "object": "urn:li:article:7980097982484950123"
  },
  "parentSiblingActivities": [

  ],
  "resourceName": "socialActions/likes",
  "resourceUri": "/socialActions/urn:li:article:7980097982484950123/likes/urn:li:person:V9W_L_bioc",
  "actor": "urn:li:person:V9W_L_bioc",
  "processedAt": 1506560767862,
  "capturedAt": 1506560737780,
  "processedActivity": {
    "actor": "urn:li:person:V9W_L_bioc",
    "actor~": {
      "firstName": {
        "localized": {
          "en_US": "Test"
        },
        "preferredLocale": {
          "country": "US",
          "language": "en"
        }
      },
      "lastName": {
        "localized": {
          "en_US": "User"
        },
        "preferredLocale": {
          "country": "US",
          "language": "en"
        }
      },
      "headline": {
        "localized": {
          "en_US": "Partner Engineer at LinkedIn",

        },
        "preferredLocale": {
          "country": "US",
          "language": "en"
        }
      }
    },
    "created": {
      "actor": "urn:li:person:V9W_L_bioc",
      "actor~": {
        "firstName": {
          "localized": {
            "en_US": "Test"
          },
          "preferredLocale": {
            "country": "US",
            "language": "en"
          }
        },
        "lastName": {
          "localized": {
            "en_US": "User"
          },
          "preferredLocale": {
            "country": "US",
            "language": "en"
          }
        },
        "headline": {
          "localized": {
            "en_US": "Partner Engineer at LinkedIn"
          },
          "preferredLocale": {
            "country": "US",
            "language": "en"
          }
        }
      },
      "time": 1506560737726
    },
    "lastModified": {
      "actor": "urn:li:person:V9W_L_bioc",
      "actor~": {
        "firstName": {
          "localized": {
            "en_US": "Test"
          },
          "preferredLocale": {
            "country": "US",
            "language": "en"
          }
        },
        "lastName": {
          "localized": {
            "en_US": "User"
          },
          "preferredLocale": {
            "country": "US",
            "language": "en"
          }
        },
        "headline": {
          "localized": {
            "en_US": "Partner Engineer at LinkedIn"
          },
          "preferredLocale": {
            "country": "US",
            "language": "en"
          }
        }
      },
      "time": 1506560737726
    },
    "object~": {
      "summary": "It works well with the like!",
      "fullText": "It works well with the like!",
      "publishedOn": 1506560719000,
      "active": true,
      "id": 7980097982484950731,
      "source": {
        "name": "linkedin.com",
        "url": "https://www.linkedin.com/pulse/demo-article-entity-monitoring-bobby-smith",
        "entity": "urn:li:company:0000"
      },
      "title": "A New Article about Entity Monitoring",
      "url": "https://www.linkedin.com/pulse/demo-article-entity-monitoring-bobby-smith"
    },
    "object": "urn:li:article:7980097982484950123"
  },
  "siblingActivities": [

  ],
  "id": 20748924
}

Comments and Likes on a Work Anniversary

When a regulated member has a work anniversary, LinkedIn creates a post on the feed to notify the member's connections of the work anniversary. Any comments and likes on that work anniversary post will now surface on the API. The owner field will have the regulated member's personUrn whereas the actor field will have the personUrn who performed the comment/like. See below for examples:

Sample response of a comment on a work anniversary

{
  "owner": "urn:li:person:yrZCpj2ZYQ",
  "resourceId": "123456789",
  "configVersion": 24,
  "method": "CREATE",
  "activity": {
    "actor": "urn:li:person:2qXA98-mVk",
    "created": {
      "actor": "urn:li:person:2qXA98-mVk",
      "time": 1561681023517
    },
    "id": "123456789",
    "lastModified": {
      "actor": "urn:li:person:2qXA98-mVk",
      "time": 1561681023517
    },
    "message": {
      "attributes": [],
      "text": "Congrats!"
    },
    "likesSummary": {
      "selectedLikes": [],
      "likedByCurrentUser": false,
      "aggregatedTotalLikes": 0,
      "totalLikes": 0
    },
    "object": "urn:li:activity:123456789"
  },
  "parentSiblingActivities": [],
  "resourceName": "socialActions/comments",
  "resourceUri": "/socialActions/urn:li:activity:123456789/comments/6550164963657420800",
  "actor": "urn:li:person:2qXA98-mVk",
  "activityId": "c3bcc9b1-20cd-4bd0-bf71-42723c54ae16",
  "processedAt": 1561681053889,
  "capturedAt": 1561681023595,
  "processedActivity": {
    "actor": "urn:li:person:2qXA98-mVk",
    "actor~": {...},
    "created": {...},
    "id": "6550164963657420800",
    "lastModified": {...},
    "message": {
      "attributes": [],
      "text": "Congrats!"
    },
    "object~": {
      "actor": "urn:li:person:yrZCpj2ZYQ",
      "object~": {
        "companyName": {
          "localized": {
            "en_US": "LinkedIn"
          },
          "preferredLocale": {
            "country": "US",
            "language": "en"
          }
        },
        "title": {
          "localized": {
            "en_US": "API Developer"
          },
          "preferredLocale": {
            "country": "US",
            "language": "en"
          }
        }
      },
      "domainEntity~": {
        "createdAt": 1524166778647,
        "detail": {
          "com.linkedin.props.WorkAnniversary": {
            "date": {
              "month": 6,
              "year": 2014,
              "day": 27
            },
            "numberOfYears": 5,
            "affiliate!": {
              "companyName": {
                "localized": {
                  "en_US": "LinkedIn"
                },
                "preferredLocale": {
                  "country": "US",
                  "language": "en"
                }
              },
              "title": {
                "localized": {
                  "en_US": "API Developer"
                },
                "preferredLocale": {
                  "country": "US",
                  "language": "en"
                }
              }
            },
            "affiliate": "urn:li:position:(urn:li:person:yrZCpj2ZYQ,717780123)"
          }
        }
      },
      "actor~": {...},
      "verb": "linkedin:anniversary",
      "domainEntity": "urn:li:prop:(WORK_ANNIVERSARY,BobSmith123456)",
      "object": "urn:li:position:(urn:li:person:yrZCpj2ZYQ,717780123)"
    },
    "object": "urn:li:activity:123456789"
  },
  "siblingActivities": [],
  "id": 699288116
}

Sample response of a like on a work anniversary

{
  "owner": "urn:li:person:yrZCpj2ZYQ",
  "resourceId": "urn:li:activity:123456789",
  "configVersion": 16,
  "method": "CREATE",
  "activity": {
    "actor": "urn:li:person:2qXA98-mVk",
    "created": {
      "actor": "urn:li:person:2qXA98-mVk",
      "time": 1561681015656
    },
    "lastModified": {
      "actor": "urn:li:person:2qXA98-mVk",
      "time": 1561681015656
    },
    "object": "urn:li:activity:123456789"
  },
  "parentSiblingActivities": [],
  "resourceName": "socialActions/likes",
  "resourceUri": "/socialActions/urn:li:activity:123456789/likes/urn:li:person:2qXA98-mVk",
  "actor": "urn:li:person:2qXA98-mVk",
  "activityId": "ed39d05d-c366-4ecb-be09-3f80bb3cbed6",
  "processedAt": 1561681045974,
  "capturedAt": 1561681015663,
  "processedActivity": {
    "actor": "urn:li:person:2qXA98-mVk",
    "actor~": {...},
    "created": {...},
    "lastModified": {...},
    "object~": {
      "actor": "urn:li:person:yrZCpj2ZYQ",
      "object~": {
        "companyName": {
          "localized": {
            "en_US": "LinkedIn"
          },
          "preferredLocale": {
            "country": "US",
            "language": "en"
          }
        },
        "title": {
          "localized": {
            "en_US": "API Developer"
          },
          "preferredLocale": {
            "country": "US",
            "language": "en"
          }
        }
      },
      "domainEntity~": {
        "createdAt": 1524166778647,
        "detail": {
          "com.linkedin.props.WorkAnniversary": {
            "date": {
              "month": 6,
              "year": 2014,
              "day": 27
            },
            "numberOfYears": 5,
            "affiliate!": {
              "companyName": {
                "localized": {
                  "en_US": "LinkedIn"
                },
                "preferredLocale": {
                  "country": "US",
                  "language": "en"
                }
              },
              "title": {
                "localized": {
                  "en_US": "API Developer"
                },
                "preferredLocale": {
                  "country": "US",
                  "language": "en"
                }
              }
            },
            "affiliate": "urn:li:position:(urn:li:person:yrZCpj2ZYQ,717780123)"
          }
        }
      },
      "actor~": {...},
      "verb": "linkedin:anniversary",
      "domainEntity": "urn:li:prop:(WORK_ANNIVERSARY,BobSmith123456)",
      "object": "urn:li:position:(urn:li:person:yrZCpj2ZYQ,717780123)"
    },
    "object": "urn:li:activity:123456789"
  },
  "siblingActivities": [],
  "id": 699288100
}

Comments and Likes on a Job Change

When a regulated member has a job change, LinkedIn creates a post on the feed to notify the member's connections of the job change. Any comments and likes on that job change post will now surface on the API. The owner field will have the regulated member's personUrn whereas the actor field will have the personUrn who performed the comment/like. See below for examples:

Sample response of a comment on a job change

{
  "owner": "urn:li:person:yrZCpj2ZYQ",
  "resourceId": "123456789",
  "configVersion": 24,
  "method": "CREATE",
  "activity": {
    "actor": "urn:li:person:2qXA98-mVk",
    "created": {
      "actor": "urn:li:person:2qXA98-mVk",
      "time": 1561681023517
    },
    "id": "123456789",
    "lastModified": {
      "actor": "urn:li:person:2qXA98-mVk",
      "time": 1561681023517
    },
    "message": {
      "attributes": [],
      "text": "Congrats!"
    },
    "likesSummary": {
      "selectedLikes": [],
      "likedByCurrentUser": false,
      "aggregatedTotalLikes": 0,
      "totalLikes": 0
    },
    "object": "urn:li:activity:123456789"
  },
  "parentSiblingActivities": [],
  "resourceName": "socialActions/comments",
  "resourceUri": "/socialActions/urn:li:activity:123456789/comments/6550164963657420800",
  "actor": "urn:li:person:2qXA98-mVk",
  "activityId": "c3bcc9b1-20cd-4bd0-bf71-42723c54ae16",
  "processedAt": 1561681053889,
  "capturedAt": 1561681023595,
  "processedActivity": {
    "actor": "urn:li:person:2qXA98-mVk",
    "actor~": {...},
    "created": {...},
    "id": "6550164963657420800",
    "lastModified": {...},
    "message": {
      "attributes": [],
      "text": "Congrats!"
    },
    "object~": {
      "actor": "urn:li:person:yrZCpj2ZYQ",
      "domainEntity~": {
        "createdAt": 1561680484539,
        "detail": {
          "com.linkedin.props.PositionChange": {
            "newPosition~": {
              "companyName": {
                "localized": {
                  "en_US": "New Company 123"
                },
                "preferredLocale": {
                  "country": "US",
                  "language": "en"
                }
              },
              "title": {
                "localized": {
                  "en_US": "Developer"
                },
                "preferredLocale": {
                  "country": "US",
                  "language": "en"
                }
              }
            },
            "newPosition": "urn:li:position:(urn:li:person:yrZCpj2ZYQ,1481872774)",
            "oldPosition~": {
              "companyName": {
                "localized": {
                  "en_US": "Old Company"
                },
                "preferredLocale": {
                  "country": "US",
                  "language": "en"
                }
              },
              "title": {
                "localized": {
                  "en_US": "Developer"
                },
                "preferredLocale": {
                  "country": "US",
                  "language": "en"
                }
              }
            },
            "oldPosition": "urn:li:position:(urn:li:person:yrZCpj2ZYQ,1223451594)"
          }
        }
      },
      "actor~": {...},
      "verb": "linkedin:profile-change-position",
      "domainEntity": "urn:li:prop:(JOB_CHANGE,_01dp6deYvcQlJFn7yyD144qyQvskJL-HXBriApaxNymYM=)",
      "object": "urn:li:prop:(JOB_CHANGE,_01dp6deYvcQlJFn7yyD144qyQvskJL-HXBriApaxNymYM=)"
    },
    "object": "urn:li:activity:123456789"
  },
  "siblingActivities": [],
  "id": 699288116
}

Sample response of a like on a job change

{
  "owner": "urn:li:person:yrZCpj2ZYQ",
  "resourceId": "urn:li:activity:123456789",
  "configVersion": 16,
  "method": "CREATE",
  "activity": {
    "actor": "urn:li:person:2qXA98-mVk",
    "created": {
      "actor": "urn:li:person:2qXA98-mVk",
      "time": 1561681015656
    },
    "lastModified": {
      "actor": "urn:li:person:2qXA98-mVk",
      "time": 1561681015656
    },
    "object": "urn:li:activity:123456789"
  },
  "parentSiblingActivities": [],
  "resourceName": "socialActions/likes",
  "resourceUri": "/socialActions/urn:li:activity:123456789/likes/urn:li:person:2qXA98-mVk",
  "actor": "urn:li:person:2qXA98-mVk",
  "activityId": "ed39d05d-c366-4ecb-be09-3f80bb3cbed6",
  "processedAt": 1561681045974,
  "capturedAt": 1561681015663,
  "processedActivity": {
    "actor": "urn:li:person:2qXA98-mVk",
    "actor~": {...},
    "created": {...},
    "lastModified": {...},
    "object~": {
      "actor": "urn:li:person:yrZCpj2ZYQ",
      "domainEntity~": {
        "createdAt": 1561680484539,
        "detail": {
          "com.linkedin.props.PositionChange": {
            "newPosition~": {
              "companyName": {
                "localized": {
                  "en_US": "New Company 123"
                },
                "preferredLocale": {
                  "country": "US",
                  "language": "en"
                }
              },
              "title": {
                "localized": {
                  "en_US": "Developer"
                },
                "preferredLocale": {
                  "country": "US",
                  "language": "en"
                }
              }
            },
            "newPosition": "urn:li:position:(urn:li:person:yrZCpj2ZYQ,1481872774)",
            "oldPosition~": {
              "companyName": {
                "localized": {
                  "en_US": "Old Company"
                },
                "preferredLocale": {
                  "country": "US",
                  "language": "en"
                }
              },
              "title": {
                "localized": {
                  "en_US": "Developer"
                },
                "preferredLocale": {
                  "country": "US",
                  "language": "en"
                }
              }
            },
            "oldPosition": "urn:li:position:(urn:li:person:yrZCpj2ZYQ,1223451594)"
          }
        }
      },
      "actor~": {...},
      "verb": "linkedin:profile-change-position",
      "domainEntity": "urn:li:prop:(JOB_CHANGE,_01dp6deYvcQlJFn7yyD144qyQvskJL-HXBriApaxNymYM=)",
      "object": "urn:li:prop:(JOB_CHANGE,_01dp6deYvcQlJFn7yyD144qyQvskJL-HXBriApaxNymYM=)"
    },
    "object": "urn:li:activity:123456789"
  },
  "siblingActivities": [],
  "id": 699288100
}

Invitations Received

When a regulated member receives an invitation request from another member, that action will now be captured in the API. The owner field will have the regulated member's personUrn whereas the actor field will have the personUrn who performed the invitation request. See below for an example:

sample response of an invitation request

{
  "owner": "urn:li:person:2qXA98-mVk",
  "resourceId": "urn:li:invitation:6418245652337160192",
  "configVersion": 11,
  "method": "CREATE",
  "activity": {
    "inviter": "urn:li:person:yrZCpj2ZYQ",
    "invitee": "urn:li:person:2qXA98-mVk",
    "trackingId": "\u009a\u00038ì@ F\u001e¶ú¸w\u0085\u0086æ;"
  },
  "resourceName": "invitations",
  "resourceUri": "/invitations/urn:li:invitation:6418245652337160192",
  "actor": "urn:li:person:yrZCpj2ZYQ",
  "activityId": "ab6247e4-4b51-44bb-a82e-7afc312543cc",
  "processedAt": 1530229039261,
  "capturedAt": 1530229008941,
  "processedActivity": {
    "invitee~": {...},
    "inviter~": {...},
    "inviter": "urn:li:person:yrZCpj2ZYQ",
    "invitee": "urn:li:person:2qXA98-mVk"
  },
  "id": 97287545
}

Endorsements Received

When a regulated member receives an endorsement from another member, that action will now be captured in the API. The owner field will have the regulated member's personUrn whereas the actor field will have the personUrn who performed the endorsement. See below for an example:

sample response of an endorsement received

{
    "activity": {
        "endorser": "urn:li:person:J1CQ1YfAGi", 
        "item": {
            "nonStandardEntity": {
                "entityPhrase": "Java", 
                "entityType": "PROFILE_SKILL"
            }
        }, 
        "location": "neptune-skills-section", 
        "recipient": "urn:li:person:2qXA98-mVk", 
        "status": "ACCEPTED"
    }, 
    "activityId": "466ac44d-cd76-41fe-8a75-b7abae47a7e1", 
    "actor": "urn:li:person:J1CQ1YfAGi", 
    "capturedAt": 1530144904331, 
    "configVersion": 5, 
    "id": 122650466, 
    "method": "CREATE", 
    "owner": "urn:li:person:2qXA98-mVk", 
    "parentSiblingActivities": [], 
    "processedActivity": {
        "endorser": "urn:li:person:J1CQ1YfAGi", 
        "endorser~": {
            "firstName": {
                "localized": {
                    "en_US": "Jenny"
                }, 
                "preferredLocale": {
                    "country": "US", 
                    "language": "en"
                }
            }, 
            "headline": {
                "localized": {
                    "en_US": "Senior Partner Engineer at LinkedIn"
                }, 
                "preferredLocale": {
                    "country": "US", 
                    "language": "en"
                }
            }, 
            "lastName": {
                "localized": {
                    "en_US": "Green"
                }, 
                "preferredLocale": {
                    "country": "US", 
                    "language": "en"
                }
            }, 
            "localizedFirstName": "Jenny", 
            "localizedHeadline": "Senior Partner Engineer at LinkedIn", 
            "localizedLastName": "Green", 
            "profilePicture": {
                "displayImage": "urn:li:digitalmediaAsset:C5603AQG7VF4Hn8ABow", 
                "displayImage~": {
                    "elements": [
                       {
                              "identifiers": [...]
                       },
                       {...}
                    ]
                }
            }
        }, 
        "item": {
            "nonStandardEntity": {
                "entityPhrase": "Java", 
                "entityType": "PROFILE_SKILL"
            }
        }, 
        "location": "neptune-skills-section", 
        "recipient": "urn:li:person:2qXA98-mVk", 
        "recipient~": {
            "firstName": {
                "localized": {
                    "en_US": "Bob"
                }, 
                "preferredLocale": {
                    "country": "US", 
                    "language": "en"
                }
            }, 
            "headline": {
                "localized": {
                    "en_US": "Partner Engineer at LinkedIn"
                }, 
                "preferredLocale": {
                    "country": "US", 
                    "language": "en"
                }
            }, 
            "lastName": {
                "localized": {
                    "en_US": "Smith"
                }, 
                "preferredLocale": {
                    "country": "US", 
                    "language": "en"
                }
            }, 
            "localizedFirstName": "Bob", 
            "localizedHeadline": "Partner Engineer at LinkedIn", 
            "localizedLastName": "Smith", 
            "profilePicture": {
                "displayImage": "urn:li:digitalmediaAsset:C5603AQG7VF4Hn8ABow", 
                "displayImage~": {
                    "elements": [
                       {
                              "identifiers": [...]
                       },
                       {...}
                    ]
                }
            }
        }, 
        "status": "ACCEPTED"
    }, 
    "processedAt": 1530144934471, 
    "resourceId": "urn:li:endorsement:(urn:li:person:2qXA98-mVk,71104380844)", 
    "resourceName": "endorsement", 
    "resourceUri": "/endorsement/urn:li:endorsement:(urn:li:person:2qXA98-mVk,71104380123)"
}

Recommendation Requests Received

When a regulated member receives a recommendation requests from another member, the activity will be captured in the API. The owner field will have the regulated member's personUrn whereas the actor field will have the personUrn who performed the recommendation request. See below for example:

sample response of a member asking a recommendation for a regulated member

{
  "owner": "urn:li:person:yrZCpj2ZYQ",
  "resourceId": "urn:li:recommendationRequest:(urn:li:person:2SqvgON4PZ,1279897764)",
  "configVersion": 6,
  "method": "CREATE",
  "activity": {
    "requester": "urn:li:person:2SqvgON4PZ",
    "notification": {
      "created": 1530209450079,
      "subject": "Recommendation Request",
      "lastModified": 1530209450079,
      "message": "Hi Bob, can you write me a recommendation?\n\nWrite Jenny a recommendation:\nhttps://www.linkedin.com/recs/give?senderId=12345"
    },
    "requestee": "urn:li:person:yrZCpj2ZYQ",
    "requesterEntity": "urn:li:position:(urn:li:person:2SqvgON4PZ,1214669864)",
    "relationship": "WORKED_IN_SAME_GROUP",
    "status": "PENDING"
  },
  "resourceName": "recRequests",
  "resourceUri": "/recRequests/urn:li:recommendationRequest:(urn:li:person:2SqvgON4PZ,1279897764)",
  "actor": "urn:li:person:2SqvgON4PZ",
  "activityId": "e22a8826-77d6-4ae3-8600-24878e03b90b",
  "processedAt": 1530209480364,
  "capturedAt": 1530209450109,
  "processedActivity": {
    "requester": "urn:li:person:2SqvgON4PZ",
    "notification": {
      "created": 1530209450079,
      "subject": "Recommendation Request",
      "lastModified": 1530209450079,
      "message": "Hi Bob, can you write me a recommendation?\n\nWrite Jenny a recommendation:\nhttps://www.linkedin.com/recs/give?senderId=12345"
    },
    "requestee": "urn:li:person:yrZCpj2ZYQ",
    "requester~": {...},
    "requestee~": {...},
    "requesterEntity": "urn:li:position:(urn:li:person:2SqvgON4PZ,1214669864)",
    "requesterEntity~": {
      "localizedCompanyName": "LinkedIn",
      "localizedTitle": "Technical Lead"
    },
    "relationship": "WORKED_IN_SAME_GROUP",
    "status": "PENDING"
  },
  "id": 122943450
}

Recommendations Received

When a regulated member receives a recommendation from a member, the activity will be captured in the API. The owner field will have the regulated member's personUrn whereas the actor field will have the personUrn who performed the recommendation. See below for example:

sample response of a member giving a recommendation to a regulated member

{
  "owner": "urn:li:person:yrZCpj2ZYQ",
  "resourceId": "urn:li:recommendation:(urn:li:person:2SqvgON4PZ,634676834)",
  "configVersion": 6,
  "method": "CREATE",
  "activity": {
    "recommendee": "urn:li:person:yrZCpj2ZYQ",
    "recommendationText": "Bob was awesome at understanding my requirements as a client and completing the project on time!",
    "recommendeeEntity": "urn:li:position:(urn:li:person:yrZCpj2ZYQ,1223451594)",
    "visibilityForRecommender": "EVERYONE",
    "message": "Dhar sent you a recommendation\n\nReview Recommendation:\nhttps://www.linkedin.com/recs/received?senderId=12345",
    "relationship": "RECOMMENDER_IS_CLIENT_OF_RECOMMENDEE",
    "recommender": "urn:li:person:2SqvgON4PZ",
    "status": "PENDING"
  },
  "resourceName": "recs",
  "resourceUri": "/recs/urn:li:recommendation:(urn:li:person:2SqvgON4PZ,634676834)",
  "actor": "urn:li:person:2SqvgON4PZ",
  "activityId": "aad5e4c4-01ee-477b-81c5-c96131c2cbe9",
  "processedAt": 1530210168941,
  "capturedAt": 1530210138512,
  "processedActivity": {
    "recommender~": {...},
    "recommendee~": {...},
    "recommendee": "urn:li:person:yrZCpj2ZYQ",
    "recommendationText": "Bob was awesome at understanding my requirements as a client and completing the project on time!",
    "recommendeeEntity": "urn:li:position:(urn:li:person:yrZCpj2ZYQ,1223451594)",
    "visibilityForRecommender": "EVERYONE",
    "message": "Dhar sent you a recommendation\n\nReview Recommendation:\nhttps://www.linkedin.com/recs/received?senderId=12345",
    "relationship": "RECOMMENDER_IS_CLIENT_OF_RECOMMENDEE",
    "recommender": "urn:li:person:2SqvgON4PZ",
    "status": "PENDING"
  },
  "id": 122943586
}

Messages Received

When a regualted member receives a message, the activity will be captured in the API. The owner field will have the regulated member's personUrn whereas the actor field will have the personUrn who performed the message. See below for example:

sample response of the message received

{
  "owner": "urn:li:person:Ylpq-RobP9",
  "resourceId": "0-VTYzNjI4MjU0OTA3NTkyMDA3NjhfNTAw",
  "configVersion": 5,
  "method": "CREATE",
  "activity": {
    "owner": "urn:li:person:fb9JdiOYTc",
    "createdAt": 1517015812663,
    "author": "urn:li:person:fb9JdiOYTc",
    "id": "0-VTYzNjI4MjU0OTA3NTkyMDA3NjhfNTAw",
    "thread": "urn:li:messagingThread:0-NjIzNDYxMzI4NzYwMjkyNTU2OA==",
    "readAt": 1517015812000,
    "content": {
      "format": "TEXT",
      "fallback": "",
      "formatVersion": 1,
      "content": {
        "string": "HELLO!"
      }
    }
  },
  "parentSiblingActivities": [

  ],
  "resourceName": "messages",
  "resourceUri": "/messages/0-VTYzNjI4MjU0OTA3NTkyMDA3NjhfNTAw",
  "actor": "urn:li:person:fb9JdiOYTc",
  "activityId": "ce1b1f56-391a-4945-b505-0b62a063770f",
  "processedAt": 1517015814445,
  "capturedAt": 1517015812830,
  "processedActivity": {
    "owner": "urn:li:person:fb9JdiOYTc",
    "createdAt": 1517015812663,
    "owner~": {...},
    "author~": {...},
    "thread~": {
      "owner": "urn:li:person:fb9JdiOYTc",
      "membership": [
        {
          "createdAt": 0,
          "identity~": {...},
          "identity": "urn:li:person:Ylpq-RobP9"
        },
        {
          "createdAt": 0,
          "identity~": {...},
          "identity": "urn:li:person:fb9JdiOYTc"
        }
      ]
    },
    "author": "urn:li:person:fb9JdiOYTc",
    "id": "0-VTYzNjI4MjU0OTA3NTkyMDA3NjhfNTAw",
    "thread": "urn:li:messagingThread:0-NjIzNDYxMzI4NzYwMjkyNTU2OA==",
    "readAt": 1517015812000,
    "content": {
      "format": "TEXT",
      "fallback": "",
      "formatVersion": 1,
      "content": {
        "string": "HELLO!"
      }
    }
  },
  "id": 623563
}

Share via

Entity Monitoring

Supported Use Cases

Comments and Likes on an Article

sample response of a like on an article

Comments and Likes on a Work Anniversary

Sample response of a comment on a work anniversary

Sample response of a like on a work anniversary

Comments and Likes on a Job Change

Sample response of a comment on a job change

Sample response of a like on a job change

Invitations Received

sample response of an invitation request

Endorsements Received

sample response of an endorsement received

Recommendation Requests Received

sample response of a member asking a recommendation for a regulated member

Recommendations Received

sample response of a member giving a recommendation to a regulated member

Messages Received

sample response of the message received

Feedback

Additional resources

Share via

Entity Monitoring

Supported Use Cases

Comments and Likes on a Share

sample response of a comment on a share

Comments and Likes on an Article

sample response of a like on an article

Comments and Likes on a Work Anniversary

Sample response of a comment on a work anniversary

Sample response of a like on a work anniversary

Comments and Likes on a Job Change

Sample response of a comment on a job change

Sample response of a like on a job change

Invitations Received

sample response of an invitation request

Endorsements Received

sample response of an endorsement received

Recommendation Requests Received

sample response of a member asking a recommendation for a regulated member

Recommendations Received

sample response of a member giving a recommendation to a regulated member

Messages Received

sample response of the message received

Feedback

Additional resources