Member Rich Media API

Note

The use of this API is restricted to those developers approved by LinkedIn and subject to applicable data restrictions in their agreements.

Member Rich Media API are used to retrieve and create the RichMediaAssociation in the summaryRichMediaAssociations, educations, and positions of a member's profile.

Note

All API requests are represented in protocol 2.0.0. Therefore, all API requests require the header X-Restli-Protocol-Version: 2.0.0

Member Rich Media Schema

Field Description Format Required
content Metadata of the media content. Union of [ Video, Image, Document, Link ] Yes
description Customized description provided by the member. MultiLocaleRichText Optional
id Identifier of the rich media. long Optional
member Owner of the media. Person Urn Yes
thumbnailImage Thumbnail image provided by the media. Image Optional
title Customized title provided by the member. MultiLocaleString Optional

Retrieve Member Rich Media

There are multiple ways of retrieving the content a memberRichMedia. The simplest is through decoration on the richMedia of the summaryRichMediaAssociations, educations, and positions. Below is an example:

GET
https://api.linkedin.com/v2/me?projection=(summaryRichMediaAssociations*(richMedia~))

Sample JSON decoration response

{
    "summaryRichMediaAssociations": [
        {
            "richMedia": "urn:li:richMedia:(urn:li:person:123ABC,1490889144097)",
            "richMedia~": {
                "content": {
                    "com.linkedin.identity.Image": {
                        "height": 300,
                        "slideShareImage": "urn:li:slideShareImage:8f63db0a-099a-46da-ad7a-bfbf448d4f13",
                        "url": "http://image-store.slidesharecdn.com/8f63db0a-099a-46da-ad7a-bfbf448d4f13-large.png",
                        "width": 300
                    }
                },
                "description": {
                    "localized": {
                        "en_US": {
                            "rawText": ""
                        }
                    }
                },
                "id": 1490889144097,
                "member": "urn:li:person:123ABC",
                "thumbnailImage": {
                    "height": 300,
                    "url": "http://image-store.slidesharecdn.com/8f63db0a-099a-46da-ad7a-bfbf448d4f13-large.png",
                    "width": 300
                },
                "title": {
                    "localized": {
                        "en_US": "test_hi.png"
                    }
                }
            }
        }
    ]
}

Alternatively, you can retrieve the memberRichMedia by id or ids :

GET
https://api.linkedin.com/v2/memberRichMedia/(member:{personUrn},id:{ID})
GET
https://api.linkedin.com/v2/memberRichMedia?ids=List((member:{personUrn1},id:{ID1}),(member:{personUrn2},id:{ID2}))

Retrieve Member Rich Media by Member

You can find all the Rich Media of a member by doing the following:

GET
https://api.linkedin.com/v2/memberRichMedia?q=member&member={personUrn}

Sample JSON finder response

{
    "elements": [
        {
            "content": {
                "com.linkedin.identity.Link": {
                    "url": "http://www.linkedin.com"
                }
            },
            "description": {
                "localized": {
                    "en_US": {
                        "rawText": "Awesome description of me."
                    }
                }
            },
            "id": 1481678620124,
            "member": "urn:li:person:ABC123",
            "title": {
                "localized": {
                    "en_US": "LinkedIn Test Title 123"
                }
            }
        },
        {
            "content": {
                "com.linkedin.identity.Image": {
                    "height": 50,
                    "url": "https://linkedin.com",
                    "width": 50
                }
            },
            "description": {
                "localized": {
                    "en_US": {
                        "rawText": "Awesome description of me."
                    }
                }
            },
            "id": 1481678896820,
            "member": "urn:li:person:123ABC",
            "title": {
                "localized": {
                    "en_US": "LinkedIn Test Title 123"
                }
            }
        },
        {
            "content": {
                "com.linkedin.identity.Image": {
                    "height": 300,
                    "slideShareImage": "urn:li:slideShareImage:8f63db0a-099a-46da-ad7a-bfbf448d4f13",
                    "url": "http://image-store.slidesharecdn.com/8f63db0a-099a-46da-ad7a-bfbf448d4f13-large.png",
                    "width": 300
                }
            },
            "description": {
                "localized": {
                    "en_US": {
                        "rawText": ""
                    }
                }
            },
            "id": 1490889144097,
            "member": "urn:li:person:123ABC",
            "thumbnailImage": {
                "height": 300,
                "url": "http://linkedin.com",
                "width": 300
            },
            "title": {
                "localized": {
                    "en_US": "test_hi.png"
                }
            }
        },
        {
            "content": {
                "com.linkedin.identity.Image": {
                    "height": 184,
                    "url": "http://linkedin.com",
                    "width": 544
                }
            },
            "id": 1489170915339,
            "member": "urn:li:person:123ABC"
        }
    ],
    "paging": {
        "count": 10,
        "links": [],
        "start": 0
    }
}