UGC Posts

The identity of the resourceName is ugcPosts. This resource captures all user generated posts. The three methods available are: CREATE, UPDATE,and DELETE.

To retrieve and download the media file of the video, you will access URL listed in the identifier . There are several mediaType : application/vnd.apple.mpegurl , video/webm , video/mp4 , image/jpeg and more. The identifier can be a public or private URL depending on the domain. It is public if it's dms.licdn.com and private if it's api.linkedin.com . In order to access the private URL, you will need to supply the same OAuth2 access token in the request.

To remediate an UGC Post, please refer here.

ugc Post activity - share a group

{
  "resourceId": "urn:li:ugcPost:6604919668283068416",
  "resourceName": "ugcPosts",
  "resourceUri": "/ugcPosts/urn:li:ugcPost:123456789",
  "configVersion": 71,
  "method": "CREATE",
  "activity": {
    "specificContent": {
      "com.linkedin.ugc.ShareContent": {
        "shareMediaCategory": "URN_REFERENCE",
        "shareFeatures": {
          "hashtags": []
        },
        "shareCommentary": {
          "text": "HELLO!"
        },
        "media": [
          {
            "media": "urn:li:group:12107512",
            "status": "READY"
          }
        ],
      }
    },
    ...
  },
  "processedActivity": {
    "specificContent": {
      "com.linkedin.ugc.ShareContent": {
        "shareMediaCategory": "URN_REFERENCE",
        "shareFeatures": {
          "hashtags": []
        },
        "shareCommentary": {
          "text": "HELLO!"
        },
        "media": [
          {
            "media": "urn:li:group:12107512",
            "media~": {
              "created": {
                "actor": "urn:li:person:123ABC",
                "actor~": {...},
                "time": 1522194788
              },
              "description": {
                "locale": {
                  "country": "US",
                  "language": "en"
                },
                "value": "hi"
              },
              "id": 12107512,
              "lastModified": {
                "actor": "urn:li:person:123ABC",
                "actor~": {...},
                "time": 1522194788
              },
              "title": {
                "locale": {
                  "country": "US",
                  "language": "en"
                },
                "value": "Group Title"
              },
              "type": "STANDARD"
            },
            "status": "READY"
          }
        ],
      }
    },
    ...
  },
  ...
}

ugc Post activity - share on an event page

{
  "owner": "urn:li:person:Ylpq-RobP9",
  "resourceId": "urn:li:ugcPost:123456789",
  "configVersion": 53,
  "method": "CREATE",
  "activity": {
    "lifecycleState": "PUBLISHED",
    "visibility": {
      "com.linkedin.ugc.MemberNetworkVisibility": "CONTAINER"
    },
    "specificContent": {
      "com.linkedin.ugc.ShareContent": {
        "shareMediaCategory": "NONE",
        "shareFeatures": {
          "hashtags": []
        },
        "shareCommentary": {
          "text": "Hello!"
        },
        "media": [],
        "shareCategorization": {}
      }
    },
    "firstPublishedActor": {
      "member": "urn:li:person:Ylpq-RobP9"
    },
    "author": "urn:li:person:Ylpq-RobP9",
    "created": {
      "actor": "urn:li:person:Ylpq-RobP9",
      "time": 1569543293839
    },
    "versionTag": "1",
    "distribution": {
      "feedDistribution": "MAIN_FEED"
    },
    "ugcOrigin": "DESKTOP",
    "containerEntity": "urn:li:event:123456789",
    "id": "urn:li:ugcPost:123456789",
    "lastModified": {
      "time": 1569543293912
    },
    "firstPublishedAt": 1569543293839
  },
  "resourceName": "ugcPosts",
  "resourceUri": "/ugcPosts/urn:li:ugcPost:123456789",
  "actor": "urn:li:person:Ylpq-RobP9",
  "activityId": "1b36d266-cfd6-4d8a-ad4d-0ed6c478f233",
  "processedAt": 1558380117783,
  "capturedAt": 1558380087104,
  "processedActivity": {
    "lifecycleState": "PUBLISHED",
    "specificContent": {
      "com.linkedin.ugc.ShareContent": {
        "shareMediaCategory": "NONE",
        "shareFeatures": {
          "hashtags": []
        },
        "shareCommentary": {
          "text": "Hello!"
        },
        "media": [],
        "shareCategorization": {}
      }
    },
    "author~": {...},
    "visibility": {
      "com.linkedin.ugc.MemberNetworkVisibility": "CONTAINER"
    },
    "author": "urn:li:person:2qXA98-mVk",
    "created": {
      "actor": "urn:li:person:2qXA98-mVk",
      "actor~": {...},
      "time": 1569543293839
    },
    "distribution": {
      "feedDistribution": "MAIN_FEED"
    },
    "ugcOrigin": "DESKTOP",
    "containerEntity": "urn:li:event:123456789",
    "containerEntity~": {
      "created": {
        "actor": "urn:li:person:2qXA98-mVk",
        "actor~": {...},
        "time": 1569542293839
      },
      "localizedName": "My Event",
      "address": {
        "geographicArea": "California",
        "country": "US",
        "city": "San Francisco"
      },
      "organizer~": {...},
      "organizer": "urn:li:person:2qXA98-mVk",
      "name": {
        "localized": {
          "en_US": "My Event"
        },
        "preferredLocale": {
          "country": "US",
          "language": "en"
        }
      },
      "description": {
        "localized": {
          "en_US": {
            "rawText": "My Event Description"
          }
        },
        "preferredLocale": {
          "country": "US",
          "language": "en"
        }
      },
      "id": 123456789,
      "localizedDescription": {
        "rawText": "Hello!"
      },
      "timeRange": {
        "start": 1570633200000,
        "end": 1570636800000
      }
    },
    "id": "urn:li:ugcPost:123456789",
    "firstPublishedAt": 1569543293839,
    "lastModified": {
      "time": 1569543293912
    }
  },
  "id": 841260
}

ugc Post activity - share an event

{
  "owner": "urn:li:person:Ylpq-RobP9",
  "resourceId": "urn:li:ugcPost:123456789",
  "configVersion": 53,
  "method": "CREATE",
  "activity": {
    "lifecycleState": "PUBLISHED",
    "visibility": {
      "com.linkedin.ugc.MemberNetworkVisibility": "PUBLIC"
    },
    "specificContent": {
      "com.linkedin.ugc.ShareContent": {
        "shareMediaCategory": "URN_REFERENCE",
        "shareFeatures": {
          "hashtags": [
            "urn:li:hashtag:testevent"
          ]
        },
        "shareCommentary": {
          "attributes": [
            {
              "start": 97,
              "length": 16,
              "value": {
                "com.linkedin.common.HashtagAttributedEntity": {
                  "hashtag": "urn:li:hashtag:testevent"
                }
              }
            }
          ],
          "text": "Excited to organize Test Event!\n#testevent\n"
        },
        "media": [
          {
            "media": "urn:li:event:123456789",
            "status": "READY"
          }
        ]
      }
    },
    "author": "urn:li:person:Ylpq-RobP9",
    "created": {
      "actor": "urn:li:person:Ylpq-RobP9",
      "time": 1558380086653
    },
    "ugcOrigin": "DESKTOP",
    "versionTag": "1",
    "id": "urn:li:ugcPost:123456789",
    "lastModified": {
      "time": 1558380086863
    },
    "firstPublishedAt": 1558380086653,
    "distribution": {
      "feedDistribution": "MAIN_FEED"
    }
  },
  "resourceName": "ugcPosts",
  "resourceUri": "/ugcPosts/urn:li:ugcPost:123456789",
  "actor": "urn:li:person:Ylpq-RobP9",
  "activityId": "1b36d266-cfd6-4d8a-ad4d-0ed6c478f233",
  "processedAt": 1558380117783,
  "capturedAt": 1558380087104,
  "processedActivity": {
    "lifecycleState": "PUBLISHED",
    "author~": {...},
    "specificContent": {
      "com.linkedin.ugc.ShareContent": {
        "shareMediaCategory": "URN_REFERENCE",
        "shareFeatures": {
          "hashtags": [
            "urn:li:hashtag:testevent"
          ]
        },
        "shareCommentary": {
          "attributes": [
            {
              "start": 97,
              "length": 16,
              "value": {
                "com.linkedin.common.HashtagAttributedEntity": {
                  "hashtag": "urn:li:hashtag:testevent"
                }
              }
            }
          ],
          "text": "Excited to organize Test Event!\n#testevent\n"
        },
        "media": [
          {
            "media": "urn:li:event:123456789",
            "media~": {
              "created": {
                "actor": "urn:li:person:Ylpq-RobP9",
                "actor~": {...},
                "time": 1558380086653
              },
              "localizedName": "Test Event",
              "address": {
                "geographicArea": "California",
                "country": "US",
                "city": "San Francisco"
              },
              "organizer": "urn:li:person:Ylpq-RobP9",
              "organizer~": {...},
              "logo~": {...},
              "name": {
                "localized": {
                  "en_US": "Test Event"
                },
                "preferredLocale": {
                  "country": "US",
                  "language": "en"
                }
              },
              "venueDetails": {
                "localized": {
                  "en_US": {
                    "rawText": "1st Floor"
                  }
                },
                "preferredLocale": {
                  "country": "US",
                  "language": "en"
                }
              },
              "logo": "urn:li:digitalmediaAsset:123456789",
              "description": {
                "localized": {
                  "en_US": {
                    "rawText": "Come by to join!"
                  }
                },
                "preferredLocale": {
                  "country": "US",
                  "language": "en"
                }
              },
              "id": 123456789,
              "localizedDescription": {
                "rawText": "Come by to join!"
              },
              "timeRange": {
                "start": 1559577600000,
                "end": 1559581200000
              }
            },
            "status": "READY"
          }
        ]
      }
    },
    "visibility": {
      "com.linkedin.ugc.MemberNetworkVisibility": "PUBLIC"
    },
    "author": "urn:li:person:Ylpq-RobP9",
    "created": {
      "actor": "urn:li:person:Ylpq-RobP9",
      "actor~": {...},
      "time": 1558380086653
    },
    "ugcOrigin": "DESKTOP",
    "firstPublishedAt": 1558380086653,
    "id": "urn:li:ugcPost:123456789",
    "lastModified": {
      "time": 1558380086863
    },
    "distribution": {
      "feedDistribution": "MAIN_FEED"
    }
  },
  "id": 841260
}

ugc Post activity - publishing a Marketplace Platform Opportunity share

{
  "owner": "urn:li:person:yrZCpj2ZYQ",
  "resourceId": "urn:li:ugcPost:123456789",
  "configVersion": 36,
  "method": "CREATE",
  "activity": {
    "lifecycleState": "PUBLISHED",
    "visibility": {
      "com.linkedin.ugc.MemberNetworkVisibility": "PUBLIC"
    },
    "specificContent": {
      "com.linkedin.ugc.ShareContent": {
        "shareMediaCategory": "URN_REFERENCE",
        "shareCommentary": {
          "inferredLocale": "en_US",
          "text": "Looking for a plumber!"
        },
        "media": [
          {
            "media": "urn:li:marketplacePlatformOpportunity:(123456789,SERVICE_MARKETPLACE)"
          }
        ],
        "shareCategorization": {}
      }
    },
    "author": "urn:li:person:yrZCpj2ZYQ",
    "id": "urn:li:ugcPost:123456789",
    ...
  },
  "resourceName": "ugcPosts",
  "resourceUri": "/ugcPosts/urn:li:ugcPost:123456789",
  "actor": "urn:li:person:yrZCpj2ZYQ",
  "activityId": "8561f816-517e-49fb-901d-29c589e3b09f",
  "processedAt": 1552071375435,
  "capturedAt": 1552071345264,
  "processedActivity": {
    "lifecycleState": "PUBLISHED",
    "visibility": {
      "com.linkedin.ugc.MemberNetworkVisibility": "PUBLIC"
    },
    "specificContent": {
      "com.linkedin.ugc.ShareContent": {
        "shareMediaCategory": "URN_REFERENCE",
        "shareCommentary": {
          "inferredLocale": "en_US",
          "text": "Looking for a plumber!"
        },
        "media": [
          {
            "media": "urn:li:marketplacePlatformOpportunity:(123456789,SERVICE_MARKETPLACE)",
            "media~": {
              "requester": "urn:li:person:yrZCpj2ZYQ",
              "opportunityType": {
                "skill": "urn:li:skill:123",
                "skill~": {
                  "standardizedName": "Plumbing",
                  "id": 123,
                  "locale": {
                    "country": "US",
                    "language": "en"
                  }
                }
              },
              "requester~": {
                "localizedLastName": "Mario",
                "localizedFirstName": "Mario"
              },
              "location": {
                "region~": {
                  "country": "urn:li:country:us",
                  "name": {
                    "locale": {
                      "country": "US",
                      "language": "en"
                    },
                    "value": "San Francisco Bay Area"
                  },
                  "id": 84,
                  "$URN": "urn:li:region:84",
                  "states": [
                    "urn:li:state:(urn:li:country:us,CA)"
                  ]
                },
                "region": "urn:li:region:84"
              },
              "geo": "urn:li:geo:103644278",
              "geo~": {
                "id": 103644278,
                "defaultLocalizedName": {
                  "locale": {
                    "country": "US",
                    "language": "en"
                  },
                  "value": "San Francisco Bay Area"
                }
              }
            },
          }
        ],
        "shareCategorization": {}
      }
    },
    "author": "urn:li:person:yrZCpj2ZYQ",
    "id": "urn:li:ugcPost:123456789",
    ...
  }  
}

ugc Post activity - publishing an appreciation share

{
  "owner": "urn:li:person:yrZCpj2ZYQ",
  "resourceId": "urn:li:ugcPost:123456789",
  "configVersion": 36,
  "method": "CREATE",
  "activity": {
    "lifecycleState": "PUBLISHED",
    "visibility": {
      "com.linkedin.ugc.MemberNetworkVisibility": "PUBLIC"
    },
    "specificContent": {
      "com.linkedin.ugc.ShareContent": {
        "shareMediaCategory": "URN_REFERENCE",
        "shareFeatures": {
          "hashtags": [
            "urn:li:hashtag:kudos",
            "urn:li:hashtag:goingaboveandbeyond"
          ]
        },
        "shareCommentary": {
          "attributes": [
            {
              "start": 0,
              "length": 16,
              "value": {
                "com.linkedin.common.MemberAttributedEntity": {
                  "member": "urn:li:person:2SqvgON4PZ"
                }
              }
            },
            {
              "start": 17,
              "length": 6,
              "value": {
                "com.linkedin.common.HashtagAttributedEntity": {
                  "hashtag": "urn:li:hashtag:kudos"
                }
              }
            },
            {
              "start": 75,
              "length": 20,
              "value": {
                "com.linkedin.common.HashtagAttributedEntity": {
                  "hashtag": "urn:li:hashtag:goingaboveandbeyond"
                }
              }
            }
          ],
          "text": "Partners #Kudos The pride you take in your work is truly inspiring #GoingAboveAndBeyond "
        },
        "media": [
          {
            "media": "urn:li:appreciation:123456789",
            "status": "READY"
          }
        ],
        "shareCategorization": {}
      }
    },
    "author": "urn:li:person:yrZCpj2ZYQ",
    "created": {...},
    "ugcOrigin": "DESKTOP",
    "versionTag": "1",
    "id": "urn:li:ugcPost:123456789",
    "lastModified": {...},
    "firstPublishedAt": 1552071344930,
    "distribution": {
      "feedDistribution": "MAIN_FEED"
    }
  },
  "parentSiblingActivities": [],
  "resourceName": "ugcPosts",
  "resourceUri": "/ugcPosts/urn:li:ugcPost:123456789",
  "actor": "urn:li:person:yrZCpj2ZYQ",
  "activityId": "8561f816-517e-49fb-901d-29c589e3b09f",
  "processedAt": 1552071375435,
  "capturedAt": 1552071345264,
  "processedActivity": {
    "lifecycleState": "PUBLISHED",
    "author~": {...},
    "specificContent": {
      "com.linkedin.ugc.ShareContent": {
        "shareMediaCategory": "URN_REFERENCE",
        "shareFeatures": {
          "hashtags": [
            "urn:li:hashtag:kudos",
            "urn:li:hashtag:goingaboveandbeyond"
          ]
        },
        "shareCommentary": {
          "attributes": [
            {
              "length": 16,
              "start": 0,
              "value": {
                "com.linkedin.common.MemberAttributedEntity": {
                  "member": "urn:li:person:2SqvgON4PZ",
                  "member~": {...}
                }
              }
            },
            {
              "length": 6,
              "start": 17,
              "value": {
                "com.linkedin.common.HashtagAttributedEntity": {
                  "hashtag": "urn:li:hashtag:kudos"
                }
              }
            },
            {
              "start": 75,
              "length": 20,
              "value": {
                "com.linkedin.common.HashtagAttributedEntity": {
                  "hashtag": "urn:li:hashtag:goingaboveandbeyond"
                }
              }
            }
          ],
          "text": "Partners #Kudos The pride you take in your work is truly inspiring #GoingAboveAndBeyond "
        },
        "media": [
          {
            "media~": {
              "reason": "THANK_YOU",
              "creator": "urn:li:person:yrZCpj2ZYQ",
              "creator~": {...},
              "media~": [
                {...}
              ],
              "created": 1551990436449,
              "recipients": [
                "urn:li:person:2SqvgON4PZ"
              ],
              "recipients~": [
                {...}
              ],
              "id": 123456789,
              "lastModified": 1551990437838,
              "media": [
                "urn:li:digitalmediaAsset:C4D22AQE7o2HSehnd9Q"
              ],
              "source": "urn:li:ugcPost:123456789"
            },
            "media": "urn:li:appreciation:123456789",
            "status": "READY"
          }
        ],
        "shareCategorization": {}
      }
    },
    "visibility": {
      "com.linkedin.ugc.MemberNetworkVisibility": "PUBLIC"
    },
    "author": "urn:li:person:yrZCpj2ZYQ",
    "created": {...},
    "ugcOrigin": "DESKTOP",
    "firstPublishedAt": 1552071344930,
    "id": "urn:li:ugcPost:123456789",
    "lastModified": {...},
    "distribution": {
      "feedDistribution": "MAIN_FEED"
    }
  },
  "siblingActivities": [],
  "id": 368573226
}

Note: The thumbnails.url value is missing in Compliance Events API as it is a post-creation processed field. If you wish to retrieve this, please make an additional request to UGCPost API. Keep in mind, this field will be removed on April 30, 2019.

ugc Post activity - publishing a video share

{
  "owner": "urn:li:person:123ABC",
  "resourceId": "urn:li:ugcPost:123456789000",
  "configVersion": 3,
  "method": "CREATE",
  "activity": {
    "lifecycleState": "PROCESSING",
    "visibility": {
      "com.linkedin.ugc.MemberNetworkVisibility": "PUBLIC"
    },
    "specificContent": {
      "com.linkedin.ugc.ShareContent": {
        "shareMediaCategory": "VIDEO",
        "shareCommentary": {
          "text": "Funny video"
        },
        "media": [
          {
            "media": "urn:li:digitalmediaAsset:ABCDEFGHIJK123",
            "status": "PROCESSING",
            "media~": {
              "elements": [
                {
                  "identifiers": [
                    {
                      "identifier": "https://api.linkedin.com/mediaDownload/123456/feedshare-hls_200_3300_low/0?app=4355721&m=416837724&e=1518658768&v=alpha&t=P9_DJ9pBmtN-cGojHlgR3hF6G3ipWW0UilG2Jd7dFQg",
                      "file": "urn:li:digitalmediaFile:(urn:li:digitalmediaAsset:C4D00AQEfLCCzdjtAQg,urn:li:digitalmediaMediaArtifactClass:feedshare-hls_200_3300_low,0)",
                      "size": 1410,
                      "index": 0,
                      "mediaType": "application/vnd.apple.mpegurl",
                      "identifierExpiresInSeconds": 1518658768,
                      "slug": "masterplaylist.m3u8"
                    }
                  ]
                },
                {
                  "identifiers": [
                    {
                      "identifier": "https://dms.licdn.com/playback/123456/bee3e98370d642c58aa2a169b05be226/feedshare-webm_2000/1479930618324-l6cv8a?e=1518658768&v=alpha&t=xFOq9kl0Gzql3XKhdSRIzmtOms_-u3wI3MrmSpEPoeo",
                      "filename": "1479930618324-l6cv8a",
                      "file": "urn:li:digitalmediaFile:(urn:li:digitalmediaAsset:C4D00AQEfLCCzdjtAQg,urn:li:digitalmediaMediaArtifactClass:feedshare-webm_2000,0)",
                      "size": 640564,
                      "index": 0,
                      "mediaType": "video/webm",
                      "identifierExpiresInSeconds": 1518658768
                    }
                  ]
                },
                {
                  "identifiers": [
                    {
                      "identifier": "https://dms.licdn.com/playback/123456/5722b45a423945c4a480c4a2aa294d9e/feedshare-mp4_3300/1488578169071-zmy00q?e=1518658768&v=alpha&t=rkFp_vymZy6QJIw7wqjNQyaG4jDW_9esIfrbq1h81z4",
                      "filename": "1488578169071-zmy00q",
                      "file": "urn:li:digitalmediaFile:(urn:li:digitalmediaAsset:C4D00AQEfLCCzdjtAQg,urn:li:digitalmediaMediaArtifactClass:feedshare-mp4_3300,0)",
                      "size": 1493205,
                      "index": 0,
                      "mediaType": "video/mp4",
                      "identifierExpiresInSeconds": 1518658768
                    }
                  ]
                },
                {
                  "identifiers": [
                    {
                      "identifier": "https://dms.licdn.com/video-thumbs/123456/c0fb11cde2cb49d898607d8415bc7540/feedshare-videocover_low/360x270-00001.jpg",
                      "file": "urn:li:digitalmediaFile:(urn:li:digitalmediaAsset:C4D00AQEfLCCzdjtAQg,urn:li:digitalmediaMediaArtifactClass:feedshare-videocover_low,0)",
                      "size": 12619,
                      "index": 0,
                      "mediaType": "image/jpeg"
                    }
                  ]
                }
              ]
            },
          }
        ],
        "shareCategorization": {}
      }
    },
    "author": "urn:li:person:123ABC",
    "created": {
      "actor": "urn:li:person:123ABC",
      "time": 1506595503212
    },
    "versionTag": "1",
    "id": "urn:li:ugcPost:123456789000",
    "lastModified": {
      "actor": "urn:li:csUser:2",
      "time": 1506595503212
    },
    "contentCertificationRecord": "{\"originCountryCode\":\"ua\",\"modifiedAt\":1506595503212,\"spamRestriction\":{\"classifications\":[],\"contentQualityClassifications\":[],\"systemName\":\"MACHINE_SYNC\",\"lowQuality\":false,\"contentClassificationTrackingId\":\"3F4312E8B381\",\"contentRelevanceClassifications\":[],\"spam\":false}}"
  },
  "parentSiblingActivities": [],
  "resourceName": "ugcPosts",
  "resourceUri": "/ugcPosts/urn:li:ugcPost:123456789000",
  "actor": "urn:li:person:123ABC",
  "processedAt": 1506598504400,
  "capturedAt": 1506595504400,
  "processedActivity": {
    "lifecycleState": "PROCESSING",
    "author~": {
      ...
    },
    "specificContent": {
      "com.linkedin.ugc.ShareContent": {
        "shareMediaCategory": "VIDEO",
        "shareCommentary": {},
        "media": [
          {
            "media": "urn:li:digitalmediaAsset:ABCDEFGHIJK123",
            "status": "PROCESSING"
          }
        ],
        "shareCategorization": {}
      }
    },
    "visibility": {
      "com.linkedin.ugc.MemberNetworkVisibility": "PUBLIC"
    },
    "author": "urn:li:person:123ABC",
    "created": {
      "actor": "urn:li:person:123ABC",
      "actor~": {
        ...
      },
      "time": 1506595503212
    },
    "id": "urn:li:ugcPost:123456789000",
    "lastModified": {
      "actor": "urn:li:csUser:2",
      "time": 1506595503212
    }
  },
  "siblingActivities": [],
  "id": 27699900
}

ugc Post activity - share a MultiPhoto or Carousel post

Posts created with multiple images (MultiPhoto/Carousel) use a nested media payload instead of the flat media~/elements layout shown in the examples above. The media~ field expands into a multiPhotoEntities collection, and each entity must be further expanded through actionableContent to reach the individual image details:

media~ → multiPhotoEntities[] → actionableContent → content → value → com.linkedin.content.MediaContent → media~ → elements

Note

Single-image posts continue to use the flat media~/elements layout. Only posts with multiple images (MultiPhoto/Carousel) use the nested multiPhotoEntities model described here. Do not rely on shareMediaCategory to detect this case — multi-image posts have been observed with shareMediaCategory values such as URN_REFERENCE, not a dedicated carousel-only value. Instead, check structurally for a multiPhotoEntities array under media~.

Important

Compliance Events serves the decorated snapshot that was archived at the time the event was ingested. The payload shape is fixed at ingestion time and is not re-decorated later. Events ingested before the MultiPhoto/Carousel content model rollout (~early June 2026) will retain the older flat structure, while events ingested after the rollout will show the nested structure documented here. See the Compliance Events API overview for more details.

{
  "resourceId": "urn:li:ugcPost:6604919668283068416",
  "resourceName": "ugcPosts",
  "resourceUri": "/ugcPosts/urn:li:ugcPost:6604919668283068416",
  "configVersion": 71,
  "method": "CREATE",
  "processedActivity": {
    "specificContent": {
      "com.linkedin.ugc.ShareContent": {
        "shareMediaCategory": "URN_REFERENCE",
        "shareCommentary": {
          "text": "Check out these photos!"
        },
        "media": [
          {
            "media": "urn:li:digitalmediaAsset:D4E22AQFakeMultiPhoto01",
            "thumbnails": [],
            "media~": {
              "multiPhotoEntities": [
                {
                  "actionableContent": {
                    "content": {
                      "value": {
                        "com.linkedin.content.MediaContent": {
                          "media~": {
                            "paging": {
                              "start": 0,
                              "count": 10,
                              "links": []
                            },
                            "elements": [
                              {
                                "artifact": "urn:li:digitalmediaMediaArtifact:(urn:li:digitalmediaAsset:D4E22AQFakeImgAsset01,urn:li:digitalmediaMediaArtifactClass:feedshare-shrink_1280)",
                                "pluggableServiceFactory": "com.linkedin.vector.assetmanager.logic.pluggableservice.uploaddownloadservice.UploadDownloadServiceFactory",
                                "data": {
                                  "com.linkedin.digitalmedia.mediaartifact.StillImage": {
                                    "orientation": "TopLeft",
                                    "storageSize": {
                                      "width": 1280,
                                      "height": 1707
                                    },
                                    "mediaType": "image/jpeg"
                                  }
                                },
                                "authorizationMethod": "PUBLIC",
                                "privacyData": {
                                  "privacyIdentities": [
                                    {
                                      "member": "urn:li:person:123ABC"
                                    }
                                  ],
                                  "tenant": "urn:li:digitalmediaTenant:34"
                                },
                                "identifiers": [
                                  {
                                    "index": 0,
                                    "identifier": "https://media.licdn.com/dms/image/v2/D4E22AQFakeImgAsset01/feedshare-shrink_1280/0/1782853262277",
                                    "mediaType": "image/jpeg",
                                    "identifierType": "EXTERNAL_URL",
                                    "file": "urn:li:digitalmediaFile:(urn:li:digitalmediaAsset:D4E22AQFakeImgAsset01,urn:li:digitalmediaArtifactClass:feedshare-shrink_1280,0)",
                                    "identifierExpiresInSeconds": 1784764800
                                  }
                                ]
                              }
                            ]
                          }
                        }
                      }
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    }
  },
  "siblingActivities": [],
  "id": 368573227
}

Parsing guidance for multi-image posts

To retrieve the individual images of a MultiPhoto/Carousel post from a Compliance Event, partners should:

  1. Check for a multiPhotoEntities array under processedActivity.specificContent.com.linkedin.ugc.ShareContent.media[].media~ to identify a multi-image post. Do not key off shareMediaCategory — it has been observed as URN_REFERENCE for multi-image posts, not a carousel-specific value.
  2. Iterate media~.multiPhotoEntities[].
  3. For each entity, drill into actionableContent.content.value.com.linkedin.content.MediaContent.media~ to reach that image's elements (and paging, if present).
  4. Read each image's downloadable identifier(s) from elements[].identifiers[], which includes identifier (the URL), mediaType, identifierType, file, and identifierExpiresInSeconds.

Partners with existing parsers that only handle the flat media~/elements layout should update them to also handle this nested structure for multi-image posts, while retaining support for the flat layout for single-image posts and for older archived events captured before the rollout.

Reshare a Publishing Article

{
  "owner": "urn:li:person:yrZCpj2ZYQ",
  "resourceId": "urn:li:share:123456789",
  "configVersion": 48,
  "method": "CREATE",
  "activity": {
    "lifecycleState": "PUBLISHED",
    "visibility": {
      "com.linkedin.ugc.MemberNetworkVisibility": "PUBLIC"
    },
    "specificContent": {
      "com.linkedin.ugc.ShareContent": {
        "shareMediaCategory": "ARTICLE",
        "shareFeatures": {
          "hashtags": []
        },
        "shareCommentary": {
          "text": "This is a reshare of a publishing article!"
        },
        "media": [
          {
            "media": "urn:li:article:123456789",
            "status": "READY"
          }
        ],
        "shareCategorization": {}
      }
    },
    "author": "urn:li:person:yrZCpj2ZYQ",
    "created": {
      "actor": "urn:li:person:yrZCpj2ZYQ",
      "time": 1554920930600
    },
    "ugcOrigin": "LI_BADGE",
    "versionTag": "1",
    "id": "urn:li:share:123456789",
    "lastModified": {
      "actor": "urn:li:csUser:2",
      "time": 1554920930669
    },
    "firstPublishedAt": 1554920930600,
    "distribution": {
      "feedDistribution": "MAIN_FEED"
    },
    "contentCertificationRecord": "{\"originCountryCode\":\"us\",\"modifiedAt\":1554920930663,\"spamRestriction\":{\"classifications\":[],\"contentQualityClassifications\":[],\"systemName\":\"MACHINE_SYNC\",\"lowQuality\":false,\"contentClassificationTrackingId\":\"6BC84ABA58C2F1E74103D36E427009DB\",\"contentRelevanceClassifications\":[],\"spam\":false}}"
  },
  "parentSiblingActivities": [],
  "resourceName": "ugcPosts",
  "resourceUri": "/ugcPosts/urn:li:share:123456789",
  "actor": "urn:li:person:yrZCpj2ZYQ",
  "activityId": "ff65cc58-69a3-473c-b932-2a91f79f9389",
  "processedAt": 1554920961173,
  "capturedAt": 1554920930859,
  "processedActivity": {
    "lifecycleState": "PUBLISHED",
    "author~": {...},
    "specificContent": {
      "com.linkedin.ugc.ShareContent": {
        "shareMediaCategory": "ARTICLE",
        "shareFeatures": {
          "hashtags": []
        },
        "shareCommentary": {
          "text": "Hello!"
        },
        "media": [
          {
            "media~": {
              "urn": "urn:li:ingestedContent:12345789",
              "specificContent": {
                "com.linkedin.ingestedcontent.ArticleSpecificContent": {
                  "images": [],
                  "fullText": "This is some text!"
                }
              },
              "provider": {
                "url": "linkedin.com"
              },
              "publishedAt": 1552940243000,
              "description": "This is a Publishing-Article!",
              "mediaType": "text/html",
              "id": "123456789",
              "resolvedUrl": "https://www.linkedin.com/pulse/publishing-article-url",
              "locale": {
                "language": "en"
              },
              "title": "Hello World",
              "authors": [
                {
                  "author~": {...},
                  "author": "urn:li:person:yrZCpj2ZYQ"
                }
              ]
            },
            "media": "urn:li:article:123456789",
            "status": "READY"
          }
        ],
        "shareCategorization": {}
      }
    },
    "visibility": {
      "com.linkedin.ugc.MemberNetworkVisibility": "PUBLIC"
    },
    "author": "urn:li:person:yrZCpj2ZYQ",
    "created": {
      "actor": "urn:li:person:yrZCpj2ZYQ",
      "actor~": {...},
      "time": 1554920930600
    },
    "ugcOrigin": "LI_BADGE",
    "firstPublishedAt": 1554920930600,
    "id": "urn:li:share:123456789",
    "lastModified": {
      "actor": "urn:li:csUser:2",
      "time": 1554920930669
    },
    "distribution": {
      "feedDistribution": "MAIN_FEED"
    }
  },
  "siblingActivities": [],
  "id": 216111937
}