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 trueBest 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.
Related APIs
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.
- LinkedIn Company Jobs API — Discover public job listings from prepared LinkedIn /jobs/ URLs with normalized role, company, location, employment, experience, remote, salary, and timing fields.
- LinkedIn Company Posts API — Discover public posts from LinkedIn company-page URLs with text, author context, media, hashtags, timestamps, and visible engagement.
- LinkedIn Post Comments API — Collect public comments exposed with a known LinkedIn post, including text, author context, timestamps, relationship IDs, and visible likes and reply counts.
- LinkedIn Profile Posts API — Discover public posts associated with LinkedIn profile URLs, with author context, media, hashtags, timestamps, and visible engagement.
- LinkedIn Search Jobs API — Search public LinkedIn jobs from a required location and optional filters, returning normalized role, company, place, employment, experience, remote, salary, and timing fields.
- LinkedIn Search People API — Discover candidate public profiles from LinkedIn people-search URLs, returning normalized identity, description, images, location, website, account signals, and available metrics.
- LinkedIn Search Posts API — Discover Google-indexed public LinkedIn posts by keyword and optional date string, returning normalized content, authors, media, tags, timestamps, and visible engagement.