Skip to main content
​
FixImprovementDocs

​
Week of October 5

​
Fixed: reactions on reposted posts

Post Reactions returned no reactions for a post that a company page had reposted, although the post had reactions. It now returns them. Company Posts also returns original_post_url for a repost, and original_post_urn now names the original post and not the repost.

​
Improved: no charge for the empty last page

People Activity is no longer charged for the empty page that ends a list. The cursor stays set until that page, so loop until a page is empty or has no cursor. A page with few items is not necessarily the last one.
  • People Search removes repeated people within a page and returns duplicates_removed, so a page can hold fewer than 50 people. Use has_more to decide whether to continue. total is an upper bound, and the same person can still appear on two pages, so de-duplicate by urn.
  • ICP People Search results include company_id, is_current and started_on for the role shown.

​
Docs

  • include_extra and skills on Person are deprecated and ignored. They never changed the data or the price, and they are not charged.
  • A company page’s posts go back about 12 months, as noted on Company Posts.
​
NewImprovementFix

​
Week of October 4

​
New: mentions on comments and replies

Every comment and reply now has a mentions array that lists the people and companies it tags, in the same shape as post mentions: entity_urn, name and type ("profileMention" or "companyMention"). It is empty when nobody is tagged.
  • Post Comments returns mentions on every comment and on every reply in top_replies.
  • People Activity returns them as comment.mentions on comment and reply items. The top-level mentions on those items still describes the post.

​
New: sort comments

Post Comments accepts sort: "recent" for newest first, or "relevance". Any other value returns a 400 and is not charged.

​
Improved: comments are newest first by default

Without sort, comments now come newest first. Before, the order varied from post to post. To pick up only new comments, read from page 1 and stop at the first comment you already have.

​
Improved: send the cursor back as cursor

Post Comments, Post Reactions and Post Reposts now accept the cursor from the previous response as cursor as well as page. Before, a cursor input was ignored and the first page was returned again. If you send both, page is used.

​
Fixed: long threads ended early

Some long threads stopped after the first page, or after a few hundred comments, with a cursor of null while total showed more. Paging with the cursor now returns the whole thread. On a 414-comment thread it returns 412 comments; total counts two that LinkedIn does not return.
​
NewImprovementFix

​
Week of October 3

​
New: more data in the Person response

Person returns more of what a LinkedIn profile carries. Every key is present on every response; a value that is not available is empty or null.
  • Test scores: test_scores, with name, score and date.
  • Profile: is_top_voice, show_follower_count, geo_urn for the profile’s location, and the school of the top education in current_school_id and current_school_urn.
  • Roles: position_urn, geo_urn, geo_id, total_duration (for example 4 yrs 10 mos), position_group_urn and position_group_id to group the roles held at one company, is_current, and the skills attached to the role.
  • Education: education_urn, is_current, and the skills line LinkedIn shows under an entry.
  • LinkedIn ids on every list entry: publications, projects, volunteering, honors, organizations, patents and courses each carry their own URN. Honors, courses, projects and organizations also carry the position_urn or education_urn of the role or school they are attached to.
  • Recommendations: last_modified_at.

​
Improved: the same entry shape in every list

recommendations_received, recommendations_given, also_viewed, websites, contact_info, updates and featured now have one documented entry shape on every request. The People page lists every key, including nested ones, with its type and when it can be null, and its example response contains every key.
  • address is a string or null, never an object.
  • A role dated by year only has a start and end date in the same M-YYYY form as every other role, with month 0: 0-2023.
  • Language, volunteering, education and project details that were sometimes returned empty are now filled when LinkedIn has them, and language proficiency uses LinkedIn’s standard values such as FULL_PROFESSIONAL.
  • similar_profiles returns a plain list of {name, url, headline, location, profile_picture, urn} for every account, and every entry carries all six keys.

​
Fixed

  • received_recommendation_count in recommendations_data returned the number of recommendations given instead of received.
  • A certification that expires returned the expiry date as its issue date.
  • The birth year is returned when LinkedIn shows one.

​
Documented

The company_interest_page, group_interest_page, school_interest_page and newsletter_interest_page parameters, which choose the page of each interest list, are now on the People page, and every enrichment field is described down to its nested keys.