LinkedIn API

Public-data LinkedIn endpoints.

When To Use This API

The LinkedIn API is for agent workflows that need public, platform-native data without writing a custom collector for every task. Use it when a prompt needs evidence from live social records, when a Skill needs repeatable enrichment, or when product code needs the same contract an agent discovered through MCP.

This section lists 42 live LinkedIn operations from the canonical OpenAPI spec. Each operation page documents the route, method, parameters, response envelope, pagination behavior when available, and the error vocabulary shared across UnifAPI.

• Enrich public people, companies, jobs, and posts when a research agent needs business context.
• Build lead, hiring, or competitive-intelligence workflows from browser-visible LinkedIn identifiers.
• Connect company pages, public posts, reactions, comments, and search results without custom scraping code.

Agent Contract Notes

Agents usually discover these endpoints with the hosted UnifAPI MCP server, inspect the operation schema, then call only the records needed for the current task. Developers can call the same endpoints over HTTP with an API key, which makes the path from exploratory agent run to production integration direct.

Every successful response uses a stable envelope with a request id, data payload, optional pagination cursor, and billing metadata. Errors use the same closed vocabulary across platforms, so retry logic, user-facing explanations, and cost reporting can stay consistent even when a workflow spans multiple public-data sources.

When you are choosing an operation, start from the public identifier the user already has: a profile username, post id, channel id, subreddit name, search term, or URL-derived slug. Prefer the narrowest endpoint that answers the question, then expand only when the agent needs more evidence. This keeps record usage predictable, makes citations easier to explain, and avoids turning a focused research task into an expensive crawl.

Operations

Ads

• GET /linkedin/ads/{id} — Get a LinkedIn Ad Library entry by ID — Return a single entry from the LinkedIn Ad Library by its ID, including the ad creative, the advertiser, and the targeting and delivery details LinkedIn publishes for transparency.

Companies

• GET /linkedin/companies/{slug}/affiliated — List a LinkedIn company's affiliated pages — Return the affiliated and showcase pages linked to a LinkedIn company, resolved from its URL slug — the full set is returned in one response, without pagination.
• GET /linkedin/companies/{slug}/job-count — Get the number of active jobs at a LinkedIn company — Return the total count of active job postings on a LinkedIn company page, resolved from its URL slug.
• GET /linkedin/companies/{slug}/jobs — List active job postings at a LinkedIn company — Return the active job postings published on a LinkedIn company page, resolved from its URL slug.
• GET /linkedin/companies/{slug}/member-insights — Get a LinkedIn company's aggregated member insights — Return the aggregated, employee-derived insights LinkedIn surfaces on a company page — such as where employees live, what they studied, and their common skills.
• GET /linkedin/companies/{slug}/people — List employees of a LinkedIn company — Return the people who list a given LinkedIn company on their profile, resolved from the company's URL slug, as a paginated list.
• GET /linkedin/companies/{slug}/posts — List posts published by a LinkedIn company page — Return the posts published from a LinkedIn company's page, resolved from its URL slug, as a paginated list.
• GET /linkedin/companies/{slug} — Get a LinkedIn company profile by URL slug — Return a canonicalized LinkedIn company profile by its URL slug (universal_name, e.g.

Groups

• GET /linkedin/groups/{id}/posts — List posts in a LinkedIn group — Return the posts shared in a LinkedIn group by its ID, as a paginated list.
• GET /linkedin/groups/{id} — Get a LinkedIn group by ID — Return a LinkedIn group's public metadata by its ID, including name, description, and member count.

Jobs

• GET /linkedin/jobs/{id} — Get a LinkedIn job posting by ID — Return a single LinkedIn job posting by its ID — title, company, location, and description, plus the inferred required-skills list when include_skills is set.

Posts

• GET /linkedin/posts/{id}/comments/{comment_id}/replies — List replies to a LinkedIn comment — cursor here is LinkedIn's previous_replies_token.
• GET /linkedin/posts/{id}/comments — List top-level comments on a LinkedIn post — Return the top-level comments on a LinkedIn post by its ID, as a paginated list.
• GET /linkedin/posts/{id}/reactions — List users who reacted to a LinkedIn post — Return the users who reacted to a LinkedIn post (liked, celebrated, supported, and so on), with each reaction type, as a paginated list.
• GET /linkedin/posts/{id}/reposts — List reposts of a LinkedIn post — Return the reposts of a LinkedIn post by its ID, as a cursor-paginated list.
• GET /linkedin/posts/{id} — Get a LinkedIn post by ID — Return a single LinkedIn post by its numeric ID, including author, text, media, and engagement counts.

Search

• GET /linkedin/search/ads — Search the LinkedIn Ad Library — Search the LinkedIn Ad Library by advertiser, keyword, and other filters, returning matching ads as a cursor-paginated list.
• GET /linkedin/search/industries — Resolve a free-text industry name to LinkedIn industry IDs — Resolve a free-text industry name (e.g.
• GET /linkedin/search/jobs — Search LinkedIn jobs by keyword and filters — Search LinkedIn job postings by keyword, location, and other filters, returning matching jobs as a paginated list.
• GET /linkedin/search/locations — Resolve a free-text location into LinkedIn geocode tokens — Resolve a free-text location string (e.g.
• GET /linkedin/search/people — Search LinkedIn people by name, title, company, etc. — Search LinkedIn members by name, title, company, location, industry, and other filters, returning matching profiles as a paginated list.
• GET /linkedin/search/posts — Search LinkedIn posts by keyword — Search public LinkedIn posts by keyword, returning matching posts as a paginated list.
• GET /linkedin/search/schools — Search LinkedIn schools by keyword — Search LinkedIn schools and universities by keyword, returning matching institutions as a list.

Users

• GET /linkedin/users/{username}/about — Get a LinkedIn profile's 'about' metadata — Return the freeform recency metadata shown on a LinkedIn profile — when the member joined, when their contact info was last updated, and when the profile photo last changed — resolved from the profile URL slug.
• GET /linkedin/users/{username}/certifications — List a LinkedIn user's certifications — Return the certifications listed on a LinkedIn profile, resolved from its URL slug.
• GET /linkedin/users/{username}/comments — List comments authored by a LinkedIn user — Return the comments a LinkedIn user has authored on other people's posts, each embedding its parent post, as a paginated list.
• GET /linkedin/users/{username}/contact — Get a LinkedIn user's public contact info — Returns the contact block (websites, phone numbers, twitter handles, address, wechat) the user has chosen to publish on LinkedIn.
• GET /linkedin/users/{username}/educations — List a LinkedIn user's education — Return the education entries on a LinkedIn profile, resolved from its URL slug.
• GET /linkedin/users/{username}/experience — List a LinkedIn user's work experience — Return the work-experience entries from a LinkedIn profile, resolved from its URL slug, including roles, companies, and dates.
• GET /linkedin/users/{username}/follower-count — Get a LinkedIn user's follower & connection counts — Return the follower and connection counts displayed on a LinkedIn profile, resolved directly from its URL slug.
• GET /linkedin/users/{username}/honors — List a LinkedIn user's honors and awards — Return the honors and awards listed on a LinkedIn profile, resolved from its URL slug.
• GET /linkedin/users/{username}/images — List image posts authored by a LinkedIn user — Return the image posts authored by a LinkedIn user, resolved from the profile URL slug, as a paginated list.
• GET /linkedin/users/{username}/interests/companies — List companies a LinkedIn user follows — Return the companies a LinkedIn user follows, resolved from the profile URL slug, as a paginated list.
• GET /linkedin/users/{username}/interests/groups — List LinkedIn groups a user follows — Return the LinkedIn groups a user belongs to or follows, resolved from the profile URL slug, as a paginated list.
• GET /linkedin/users/{username}/posts — List posts authored by a LinkedIn user — Return the posts authored by a LinkedIn user, resolved from the profile URL slug, as a cursor-paginated list.
• GET /linkedin/users/{username}/publications — List a LinkedIn user's publications — Return the publications listed on a LinkedIn profile, resolved from its URL slug.
• GET /linkedin/users/{username}/reactions — List reactions a LinkedIn user has placed on posts — Return the reactions (likes, celebrates, and so on) a LinkedIn user has placed on posts, resolved from the profile URL slug, as a paginated list.
• GET /linkedin/users/{username}/recommendations — List recommendations written for a LinkedIn user — Return the recommendations written for a LinkedIn user, resolved from the profile URL slug.
• GET /linkedin/users/{username} — Get a LinkedIn user profile by URL slug — Returns the canonical LinkedIn profile for the given URL slug (public_identifier).
• GET /linkedin/users/{username}/skills — List a LinkedIn user's skills — Return the skills listed on a LinkedIn profile, resolved from its URL slug.
• GET /linkedin/users/{username}/videos — List video posts authored by a LinkedIn user — Return the video posts authored by a LinkedIn user, resolved from the profile URL slug, as a paginated list.
• GET /linkedin/users/{username}/volunteers — List a LinkedIn user's volunteer experience — Return the volunteer-experience entries on a LinkedIn profile, resolved from its URL slug.