What is the LinkedIn Posts API?

LinkedIn Posts API retrieves public post data from supported /posts/, /pulse/, and /feed/update/ URLs. It returns normalized text, author identity, media, publication details, hashtags, visible like, comment, and repost counts, and collection time.

Which LinkedIn post URLs can I submit?

Public /posts/ and /pulse/ links are accepted. A /feed/update/ URL is also valid when its URN identifies an activity or share.

Will one post URL return the author's full feed?

No. Processing is scoped to the supported public links in urls and does not discover the author's other posts.

Does the LinkedIn Posts API return individual comments?

No. The post record can include a visible comments_count, but it does not return the text or authors of individual comments.

Why can post fields be empty?

A post may not contain media, hashtags, a title, a headline, a post type, or a visible engagement value, so those optional fields can be null or empty.

What is the price per returned post?

Each post record in a completed result costs 1 SocQ credit. An empty result set has no result charge.

LinkedIn Posts API: Public Post Data

LinkedIn Posts

A public LinkedIn post combines an author's message with media, publication details, hashtags, content type, and visible likes, comments, and reposts. These signals support content archiving, theme and format research, and comparison of public engagement across selected posts.

Features

Supported LinkedIn post URLsProcess public /posts/ and /pulse/ links plus /feed/update/ URLs that contain an activity or share identifier.
Post text with author identityKeep the public post text, source URL, and normalized author identity connected in one content record.
Media and publication detailsReturn available media references, publication time, title, headline, post type, and hashtags without flattening them into the post text.
Visible engagement metricsReturn available like, comment, and repost counts as separate metrics on each post record.

Parameters

Parameters	Required	Description
`urls`	Required	Required list of public LinkedIn post URLs using /posts/, /pulse/, or a supported /feed/update/urn:li:activity or /feed/update/urn:li:share path.

How to Use

Provide the exact posts you want to preserve, follow their processing task, and read the structured content results.

Check that each public link uses /posts/, /pulse/, or a supported /feed/update/ URN.
Submit the links as urls to /v1/linkedin/posts and capture task_id.
Watch /v1/tasks/{task_id} until post processing succeeds or returns a failure.
Read the first data.results.items set, then advance with next_cursor while has_more remains true.

curl -X POST "https://api.socq.ai/v1/linkedin/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/posts/microsoft_were-more-than-a-single-story-at-microsoft-activity-7401349457478569985-pp34"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Best Use Cases

Campaign content archiving: Preserve post text, author, media, publication time, and source URL for a defined set of campaign posts.
Topic and message research: Analyze post text, headlines, and hashtags to compare themes across selected LinkedIn content.
Content format analysis: Use post_type and media fields to compare the formats represented across selected content.
Public engagement comparison: Compare visible like, comment, and repost counts across a selected set of saved posts.

Pro Tips

Keep the submitted URL beside the returned url when downstream records must remain traceable to their original input.
Deduplicate activity or share identifiers, not only full URL strings, before processing a set of post links.
Treat media, hashtags, title, headline, and post type as optional because not every public post exposes them.
Keep collected_at with visible engagement metrics because the same post can show different counts in later runs.
Escape or sanitize returned post text before rendering it as HTML in a downstream application.

Use these APIs when you need a different type of public LinkedIn data.

LinkedIn Profiles API — Normalize public profile identity, roles, location, visible audience counts, experience, education, and skills from profile URLs.
LinkedIn Companies API — Normalize public company descriptions, websites, logos, visible audience and employee counts, industries, locations, and specialties.
LinkedIn Jobs API — Normalize public job titles, companies, descriptions, locations, qualifications, employment details, application links, and available salary fields.

Combine LinkedIn data with public data from other supported social platforms.