Reading Company Shares

Reading Company Updates

Returns a feed of event items. Each item contains a core set of information, such as when it occured, what type of event took place, and whether you can comment and like the item.

However, the format of the event's information can vary widely from type to type. Each event type needs to be parsed differently.

We may periodically add new event types to this feed, or deprecate old ones. If you have updates of other types (such as jobs posting, product-updates etc.) then it can fetch up to 500 updates or updates in the last year whichever comes first. In addition, it only returns up to the 3 latest "update-comments" due to technical limitation. For more comments, please query each event individually.

URL

To retrieve the company's updates:

GET
https://api.linkedin.com/v1/companies/{id}/updates

Filter company updates by event type

GET
https://api.linkedin.com/v1/companies/{id}/updates?event-type=status-update

By default, a company update will only return you the most recent 10 updates

GET
https://api.linkedin.com/v1/companies/{id}/updates?start=0&count=10

Parameters

Parameter Required Possible Values
event-type N Any valid Company Update Type from the list below.
count N Maximum # of updates to return
start N The offset by which to start Network Update pagination

Company Update Types

Job Posting

Update Type Description Source
job-posting New job postings on LinkedIn by the specified company. Job is posted via the site or the Jobs Posting API on behalf of the specified company.
Example
<update>
   <timestamp>1315316675037</timestamp>
   <update­‐type>CMPY</update­‐type>
   <update­‐content>
       <company>
          <id>1337</id>
          <name>LinkedIn</name>
       </company>
       <company‐job­‐update>
          <job>
             <id>1940960</id>
             <company>
                 <id>1337</id>
                 <name>LinkedIn</name>
             </company>
             <position>
                 <title>Sales Account Manager</title>
             </position>
             <site­‐job­‐request>
                <url>https://www.linkedin.com/jobs?viewJob=&amp;jobId=1940960</url>
             </site­‐job­‐request>
             <description>Overview: The Sales Account Manager has two core functions; to work alongside and support an...</description>
             <location-­description>London, United Kingdom</location­‐description>
         </job>
         <action>
            <code>created</code>
         </action>
     </company‐job-­update>
   </update-­content>
</update>

New Product

Update Type Description Source
new-product A product is added to the company products page. A company admin creates a new product for the company.
Example
<update>
    <timestamp>1342029519566</timestamp>
    <update-key>UNIU-c20296-5628879782381879296-FOLLOW_CMPY</update-key>
    <update-type>CMPY</update-type>
    <update-content>
      <company>
        <id>12345</id>
        <name>test_company</name>
      </company>
      <company-product-update>
        <action>
          <code>created</code>
        </action>
        <event-type>
          <code>new-product</code>
        </event-type>
        <product>
          <id>3700</id>
          <name>test_product</name>
        </product>
      </company-product-update>
    </update-content>
    <is-commentable>true</is-commentable>
    <update-comments total="0" />
    <is-likable>true</is-likable>
    <is-liked>false</is-liked>
    <num-likes>0</num-likes>
</update>

Status Update

Update Type Description Source
status-update An update on the company's status or content shared by the company. An admin posts a new status update for the company via the API or website.
Example
<update>
   <timestamp>1315343580250</timestamp>
   <update-­type>CMPY</update-­type>
   <update­‐content>
      <company>
         <id>1337</id>
         <name>LinkedIn</name>
      </company>
      <company‐status­‐update>
         <share>
            <id>s570040063</id>
            <timestamp>1315343580250</timestamp>
            <visibility>
               <code>anyone</code>
            </visibility>
            <comment>Check out today's Fortune Magazine piece, &quot;Data scientist: The hot new gig in tech,&quot; where LinkedIn's senior VP of products and user experience, Deep Nishar, is quoted.</comment>
            <content>
               <submitted‐url>https://tech.fortune.cnn.com/2011/09/06/data‐scientist‐the-­hot­‐new­‐gig­‐in‐tech/?source=yahoo_quote</submitted‐url>
               <shortened-­url>https://lnkd.in/UUZUGT</shortened‐url>
               <title>Data scientist: The hot new gig in tech</title>
               <description>Companies that want to make sense of all their bits and bytes are hiring so‐called data scientists -­‐ if they can find any.
FORTUNE -­‐ The unemployment rate in the U.S. continues to be abysmal (9.1% in July), but the tech world...</description>
               <submitted‐image-­url>https://fortunebrainstormtech.files.wordpress.com/2011/09/data_scientists.jpg?w=340&amp;h=255</submitted-­‐image-­‐url>
               <thumbnail-­url>https://media.linkedin.com/media-­proxy/ext?w=80&amp;h=100&amp;hash=uYI7q6AkPhuioNYMcnxYI57rro0%3D&amp;url=http%3A%2F%2Ffortunebrainstormtech.files.wordpress.com%2F2011%2F09%2Fdata_scientists.jpg%3Fw%3D340%26h%3D255</thumbnail-­url>
               <eyebrow-­url>https://www.linkedin.com/share?viewLink=&amp;sid=s570040063&amp;url=http%3A%2F%2Flnkd%2Ein%2FUUZUGT&amp;urlhash=WhKu&amp;uid=5516950840016904192</eyebrow­‐url>
            </content>
            <source>
               <service­‐provider>
                  <name>LINKEDIN</name>
               </service­‐provider>
            </source>
         </share>
      </company-­status‐update>
   </update-­content>
</update>

Getting Comments and Likes on a Specific Company Update

To fetch comments on a particular company update:

GET
https://api.linkedin.com/v1/companies/{id}/updates/key={COMPANY UPDATE KEY}/update-comments?event-type={type of company update}

Where {COMPANY UPDATE KEY} is a update/update-key representing a particular company update. By default, a company update will only return all comments, limiting at a max of 100.

Use a similar syntax to retrieve the complete list of people, up to the most recent 100, who liked an update. To retrieve the likes for a given company update:

GET
https://api.linkedin.com/v1companies/{id}/updates/key={COMPANY UPDATE KEY}/likes?event-type={type of company update}