LinkedIn response objects

Every object the LinkedIn endpoints return, field by field, named after the words LinkedIn prints, since LinkedIn has no official data API. Every key is there on every call: a field the platform does not show is null, and a list is empty.

`linkedin_profile`

A LinkedIn profile. Returned by linkedin/profile.

Fields
Field	What it is
`vanity_name` string	The part after `/in/` in the profile URL.
`url` URL	The profile.
`full_name` string	The name, as the profile shows it.
`first_name` string · or null	The given name.
`last_name` string · or null	The family name.
`headline` string · or null	The line under the name.
`about` string · or null	The About section.
`location` string · or null	As printed, e.g. "Berlin, Germany".
`profile_picture_url` URL · or null	The profile photo.
`follower_count` integer · or null	How many members follow the profile.
`connection_count` integer · or null	LinkedIn stops counting at 500: a value of 500 means "500+".
`open_to_work` boolean · or null	Whether the profile shows the #OpenToWork frame.
`current_company` object · or null	The employer shown at the top of the profile.
`current_company.name` string · or null	As the listing prints it.
`current_company.url` URL · or null	The company page, where it has one.
`experience` array of objects	Positions, most recent first.
`experience[].title` string · or null	As the position shows it. `null` where the profile gives none.
`experience[].company` object	The employer.
`experience[].company.name` string · or null	As the listing prints it.
`experience[].company.url` URL · or null	The company page, where it has one.
`experience[].employment_type` string · or null	As printed: "Full-time", "Contract", …
`experience[].location` string · or null	Where the role is based, as printed.
`experience[].start_date` string · or null	`YYYY-MM`, or `YYYY` where the profile gives only a year.
`experience[].end_date` string · or null	`YYYY-MM` or `YYYY`; `null` for a current role, or where the profile gives no date: `is_current` tells which.
`experience[].is_current` boolean · or null	`true` where the profile says the role runs to the present, `false` where it gives an end date, `null` where it gives no dates.
`experience[].description` string · or null	What the profile says about the role.
`education` array of objects	Schools, most recent first.
`education[].school` object	The school, and its LinkedIn page where it has one.
`education[].school.name` string · or null	As the listing prints it.
`education[].school.url` URL · or null	The company page, where it has one.
`education[].degree` string · or null	As printed, e.g. "Bachelor of Science - BS".
`education[].field_of_study` string · or null	As printed, e.g. "Computer Science".
`education[].start_year` integer · or null	The year they started.
`education[].end_year` integer · or null	The year they finished, or expect to.
`skills` array of strings	As listed on the profile.
`emails` array of objects	Their work email, found with `detail=with_email` only, best first; empty otherwise, or when none is found.
`emails[].email` string	The address.
`emails[].status` string · or null	`valid` when their mail server accepts it; `risky` when the server accepts every address, so this one cannot be confirmed.
`emails[].deliverable` boolean · or null	Whether mail to it should arrive.
`emails[].catch_all` boolean · or null	Whether the domain accepts any address at all, which makes a check meaningless.
`emails[].free_provider` boolean · or null	Whether it is at a free mail service, such as Gmail, rather than an employer's domain.

`linkedin_company`

A LinkedIn company page. Returned by linkedin/company.

Fields
Field	What it is
`company_id` string	LinkedIn's numeric id for the company.
`vanity_name` string	The part after `/company/` in the page URL.
`url` URL	The company page.
`name` string	The company's name, as the page shows it.
`tagline` string · or null	The line under the name.
`description` string · or null	The About overview.
`website` URL · or null	The company's own site.
`industry` string · or null	As the page prints it, e.g. "Software Development".
`company_size` string · or null	The band LinkedIn prints, e.g. "51-200 employees".
`employees_on_linkedin` integer · or null	How many members list it as their employer.
`headquarters` object · or null	Where the company has its head office, as the page gives it.
`headquarters.city` string · or null	The city.
`headquarters.geographic_area` string · or null	State or region.
`headquarters.country` string · or null	ISO 3166-1 alpha-2.
`company_type` string · or null	As printed: "Privately Held", "Public Company", …
`founded` integer · or null	The year.
`specialties` array of strings	The specialties the page lists.
`follower_count` integer · or null	How many members follow the page.
`logo_url` URL · or null	The company's logo.

`linkedin_post`

A LinkedIn post. Returned by linkedin/posts, linkedin/post.

Fields
Field	What it is
`urn` string	LinkedIn's id for the post, e.g. `urn:li:activity:7243…`.
`url` URL	The post.
`author` object	Who posted it: a person or a company page.
`author.name` string · or null	`null` where the source names only the page.
`author.type` string, one of	Whether a person or a company page posted it. person · company
`author.headline` string · or null	The person's headline, or the company's follower line.
`author.url` URL	Their profile or company page.
`text` string · or null	The post's text.
`published_at` time, ISO 8601 UTC · or null	`null` where the source does not say.
`reaction_count` integer · or null	All reactions together. `null` where the source does not give the counts.
`reactions` object · or null	By kind, where LinkedIn shows the breakdown.
`reactions.like` integer	Like reactions.
`reactions.celebrate` integer	Celebrate reactions.
`reactions.support` integer	Support reactions.
`reactions.love` integer	Love reactions.
`reactions.insightful` integer	Insightful reactions.
`reactions.funny` integer	Funny reactions.
`comment_count` integer · or null	How many comments. `null` where the source does not give it.
`repost_count` integer · or null	How many reposts. `null` where the source does not give it.
`images` array of URLs	Image URLs, in order.
`video` object · or null	A video in the post.
`video.url` URL	The video file.
`video.duration` integer · or null	Seconds.
`document` object · or null	An attached PDF or slide deck.
`document.title` string	The document's title.
`document.page_count` integer · or null	How many pages it has.
`article` object · or null	A shared link.
`article.title` string · or null	The title the link's preview shows.
`article.url` URL	Where the link leads.
`is_repost` boolean · or null	Whether this is someone else's post reposted without comment. `null` where the source does not say.

`linkedin_comment`

A comment on a LinkedIn post. Returned by linkedin/comments.

Fields
Field	What it is
`id` string	LinkedIn's id for the comment.
`url` URL · or null	The comment's own link, as LinkedIn's "Copy link to comment" gives it: it opens the post at this comment, and linkedin/comments and linkedin/reactions take it as `comment_url`. `null` for a reply whose link the source does not give.
`post_urn` string · or null	The post it is on, e.g. `urn:li:activity:7243…`.
`parent_id` string · or null	The comment it answers, for a reply.
`text` string · or null	The comment's text.
`author` object	Who wrote it.
`author.type` string, one of	A company page can comment and react as itself. person · company
`author.vanity_name` string · or null	The public name in the URL: after `/in/` for a person, after `/company/` for a company. `null` where LinkedIn gives only an id.
`author.url` URL	Their page. Where LinkedIn lists a person by member id, as it does a post's reactors, this is a member-id link (`/in/ACoAA…`).
`author.full_name` string · or null	The person's name, or the company's.
`author.headline` string · or null	The line under the name. For a company, LinkedIn prints its follower count here.
`author.location` string · or null	As printed. `null` in most lists.
`author.services` array of strings	What they offer, for someone found by linkedin/services. Empty in other lists.
`published_at` time, ISO 8601 UTC · or null	When it was posted. `null` when the source does not say.
`like_count` integer · or null	Reactions to the comment, all kinds together.
`reply_count` integer · or null	How many replies it has.

`linkedin_reaction`

A reaction to a LinkedIn post: who, and which. Returned by linkedin/reactions.

Fields
Field	What it is
`kind` string, one of · or null	As LinkedIn's reaction menu names them. `null` for a kind it adds later. like · celebrate · support · love · insightful · funny
`actor` object	Who reacted: a person, or a company page.
`actor.type` string, one of	A company page can comment and react as itself. person · company
`actor.vanity_name` string · or null	The public name in the URL: after `/in/` for a person, after `/company/` for a company. `null` where LinkedIn gives only an id.
`actor.url` URL	Their page. Where LinkedIn lists a person by member id, as it does a post's reactors, this is a member-id link (`/in/ACoAA…`).
`actor.full_name` string · or null	The person's name, or the company's.
`actor.headline` string · or null	The line under the name. For a company, LinkedIn prints its follower count here.
`actor.location` string · or null	As printed. `null` in most lists.
`actor.services` array of strings	What they offer, for someone found by linkedin/services. Empty in other lists.

`linkedin_activity`

Something a person did on someone else's post: a comment or a reaction, with the post. Returned by linkedin/activity.

Fields
Field	What it is
`type` string, one of	What the person did. comment · reaction
`comment` string · or null	For a comment: its text.
`comment_url` URL · or null	For a comment: its own link, which opens the post at this comment. `null` for a reaction, and where the source does not give it.
`reaction` string, one of · or null	For a reaction: which. like · celebrate · support · love · insightful · funny
`at` time, ISO 8601 UTC · or null	When they commented or reacted. `null` where the source does not say, as for some reactions.
`post_url` URL	The post or article they commented on or reacted to.
`post` object · or null	The post, with its author and counts. `null` for an article, whose author the source does not give: `post_url` says where it was.
`post.urn` string	LinkedIn's id for the post, e.g. `urn:li:activity:7243…`.
`post.url` URL	The post.
`post.author` object	Who posted it: a person or a company page.
`post.author.name` string · or null	`null` where the source names only the page.
`post.author.type` string, one of	Whether a person or a company page posted it. person · company
`post.author.headline` string · or null	The person's headline, or the company's follower line.
`post.author.url` URL	Their profile or company page.
`post.text` string · or null	The post's text.
`post.published_at` time, ISO 8601 UTC · or null	`null` where the source does not say.
`post.reaction_count` integer · or null	All reactions together. `null` where the source does not give the counts.
`post.reactions` object · or null	By kind, where LinkedIn shows the breakdown.
`post.reactions.like` integer	Like reactions.
`post.reactions.celebrate` integer	Celebrate reactions.
`post.reactions.support` integer	Support reactions.
`post.reactions.love` integer	Love reactions.
`post.reactions.insightful` integer	Insightful reactions.
`post.reactions.funny` integer	Funny reactions.
`post.comment_count` integer · or null	How many comments. `null` where the source does not give it.
`post.repost_count` integer · or null	How many reposts. `null` where the source does not give it.
`post.images` array of URLs	Image URLs, in order.
`post.video` object · or null	A video in the post.
`post.video.url` URL	The video file.
`post.video.duration` integer · or null	Seconds.
`post.document` object · or null	An attached PDF or slide deck.
`post.document.title` string	The document's title.
`post.document.page_count` integer · or null	How many pages it has.
`post.article` object · or null	A shared link.
`post.article.title` string · or null	The title the link's preview shows.
`post.article.url` URL	Where the link leads.
`post.is_repost` boolean · or null	Whether this is someone else's post reposted without comment. `null` where the source does not say.

`linkedin_member`

A person or a company in a list: a post's reactors, a comment's author, a people search's results. Returned by linkedin/people, linkedin/services.

Fields
Field	What it is
`type` string, one of	A company page can comment and react as itself. person · company
`vanity_name` string · or null	The public name in the URL: after `/in/` for a person, after `/company/` for a company. `null` where LinkedIn gives only an id.
`url` URL	Their page. Where LinkedIn lists a person by member id, as it does a post's reactors, this is a member-id link (`/in/ACoAA…`).
`full_name` string · or null	The person's name, or the company's.
`headline` string · or null	The line under the name. For a company, LinkedIn prints its follower count here.
`location` string · or null	As printed. `null` in most lists.
`services` array of strings	What they offer, for someone found by linkedin/services. Empty in other lists.

`linkedin_ad`

An ad from LinkedIn's Ad Library. Returned by linkedin/ads, linkedin/ad.

Fields
Field	What it is
`id` string	The Ad Library's id for the ad.
`url` URL	The ad in LinkedIn's Ad Library.
`advertiser` object	Who paid for the ad.
`advertiser.name` string · or null	The advertiser's name. `null` where the source does not give it.
`advertiser.url` URL · or null	Their company page, or a person's profile for an ad a person runs.
`format` string · or null	As the library names it, e.g. "Single Image Ad".
`headline` string · or null	The ad's headline.
`text` string · or null	The ad's text.
`image_url` URL · or null	The ad's image.
`video_url` URL · or null	The ad's video.
`carousel_image_urls` array of URLs	A carousel's images, in order.
`call_to_action` string · or null	The button, e.g. "Learn more".
`destination_url` URL · or null	Where the ad leads.
`first_shown` time, ISO 8601 UTC · or null	When it was first shown, as the library dates it.
`last_shown` time, ISO 8601 UTC · or null	When it was last shown, as the library dates it.
`impressions` string · or null	The range the library shows, e.g. "1k-5k" or "<1k".
`impressions_by_country` array of objects	Where the ad was seen, as linkedin/ad gives it. Empty in a search.
`impressions_by_country[].country` string	As the library names it.
`impressions_by_country[].share` string · or null	The share it shows, e.g. "61%" or "<1%".
`targeting` object	Whom the ad was aimed at, as the library shows it.
`targeting.language` string · or null	As the library prints it.
`targeting.location` string · or null	As the library prints it.

`linkedin_job`

A LinkedIn job posting. Returned by linkedin/jobs, linkedin/job.

Fields
Field	What it is
`job_id` string	LinkedIn's numeric id — the number in `/jobs/view/…`.
`url` URL	The posting.
`title` string · or null	As the listing prints it.
`company` object	Who is hiring.
`company.name` string · or null	As the listing prints it.
`company.url` URL · or null	The company page, where it has one.
`location` string · or null	As printed, e.g. "Berlin, Germany".
`workplace_type` string, one of · or null	Where the work is done, as LinkedIn labels it. `null` where the listing does not say. On-site · Hybrid · Remote
`employment_type` string · or null	"Full-time", "Part-time", "Contract", …
`seniority_level` string · or null	"Entry level", "Mid-Senior level", …
`salary` string · or null	As printed, where the posting shows one, e.g. "€70K/yr - €90K/yr".
`listed_at` time, ISO 8601 UTC · or null	When it was posted. `null` when the source does not say.
`easy_apply` boolean · or null	Whether it takes applications on LinkedIn. `null` where the listing does not say.
`description` string · or null	The full description, as text.

`linkedin_lead`

A person from Sales Navigator's lead search: every match, with their current roles. Returned by linkedin/employees, linkedin/people.

Fields
Field	What it is
`vanity_name` string · or null	The public name after `/in/`. `null` where Sales Navigator gives only a member id.
`url` URL	Their profile. Sales Navigator often gives a member-id link (`/in/ACwAA…`) instead of a public name.
`first_name` string · or null	The given name.
`last_name` string · or null	The family name.
`full_name` string · or null	First and last name together.
`location` string · or null	As printed.
`profile_picture_url` URL · or null	The profile photo.
`premium` boolean · or null	Whether they pay for LinkedIn Premium.
`open_profile` boolean · or null	Whether anyone can message them, connected or not.
`current_positions` array of objects	What they do now, as Sales Navigator lists it.
`current_positions[].title` string · or null	The job title, as printed.
`current_positions[].company` object	The employer.
`current_positions[].company.name` string · or null	As the listing prints it.
`current_positions[].company.url` URL · or null	The company page, where it has one.
`current_positions[].company_id` string · or null	LinkedIn's numeric id for the employer.
`current_positions[].start_date` string · or null	`YYYY-MM`, or `YYYY` where only a year is given.
`current_positions[].description` string · or null	What they wrote about the role.

`linkedin_company_result`

A company in LinkedIn's company search. Returned by linkedin/companies.

Fields
Field	What it is
`company_id` string	LinkedIn's numeric id for the company: linkedin/employees, linkedin/employee-stats, linkedin/jobs and linkedin/ads take it as `company_id`, and linkedin/people as a filter.
`vanity_name` string · or null	The part after `/company/` in the page URL.
`url` URL	The company page.
`name` string	The company's name.
`industry` string · or null	As the search prints it.
`location` string · or null	As the search prints it.
`follower_count` integer · or null	`null` where LinkedIn prints a rounded number, such as "12K followers".
`summary` string · or null	The line the search shows under the name.
`logo_url` URL · or null	The company's logo.

`linkedin_employee_stats`

Who works at a company, counted: where they live, what they do, where they studied, what they are skilled at. Returned by linkedin/employee-stats.

Fields
Field	What it is
`company_id` string · or null	LinkedIn's numeric id for the company.
`vanity_name` string · or null	The part after `/company/` in the page URL.
`url` URL	The company page.
`stats` array of objects	One block per question the People tab answers.
`stats[].dimension` string	What LinkedIn counts them by, as its People tab names it: "Where they live", "What they do", "Where they studied", …
`stats[].values` array of objects	The largest first.
`stats[].values[].name` string	What is counted: a place, a job function, a school, …
`stats[].values[].count` integer	How many members.

`linkedin_group`

A LinkedIn group. Returned by linkedin/group, linkedin/groups.

Fields
Field	What it is
`group_id` string	LinkedIn's numeric id for the group.
`url` URL	The group.
`name` string	The group's name.
`member_count` integer · or null	How many members. `null` where LinkedIn prints a rounded number, such as "12K members".
`description` string · or null	The About text. In a search, the short summary.
`rules` string · or null	`null` in a search.
`created_at` time, ISO 8601 UTC · or null	`null` in a search.
`logo_url` URL · or null	The group's logo.
`is_public` boolean · or null	Whether anyone can see its posts. `null` in a search.