linkedin/
profile-posts

The LinkedIn Profile Posts API discovers public posts associated with LinkedIn profile URLs, returning normalized text, author context, media, hashtags, timestamps, and visible engagement.

LinkedIn Profile Posts API

Profile URL discovery
Authored-post filter
Per-profile limits
1 credit / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

LinkedIn Profile Posts

A LinkedIn profile-associated feed can contain authored posts, reposts, articles, images, videos, documents, and other public activity from a member page. Returned records provide a collection-time sample for content research, but they do not represent a complete activity history, private analytics, or connection-only visibility.

LinkedIn Profile Posts API Features

  • Discovery from profile URLsGive the LinkedIn Profile Posts API one or more public LinkedIn /in/ URLs and it discovers posts associated with each submitted profile.
  • Optional authored-post filteringForward only_authored_posts to reduce associated activity to posts the provider identifies as authored by the target profile.
  • Provider date windowsForward optional start_date and end_date strings for provider-side filtering without imposing a local format, ordering, inclusiveness, or time-zone rule.
  • Normalized content contextReturn available post text, author fields, publication time, media, hashtags, mentions, and source URL in a stable post schema.
  • Visible engagement snapshotsKeep available likes, comments, shares, and views with collected_at so measurements remain tied to their observation time.

LinkedIn Profile Posts API Parameters

ParametersRequiredDescription
urlsRequiredRequired list of public LinkedIn profile URLs on LinkedIn hosts with paths beginning with /in/.
start_dateOptionalOptional non-empty provider date-filter string forwarded for every input profile; SocQ does not parse or validate its format or inclusiveness.
end_dateOptionalOptional non-empty provider date-filter string forwarded for every input profile; SocQ does not order-check it against start_date.
only_authored_postsOptionalOptional boolean forwarded for every profile; true requests provider-identified authored posts but is not a SocQ-side identity audit.
results_limitOptionalOptional integer from 1 through 2000, applied separately to every profile URL and defaulting to 100 per profile.

How to Use the LinkedIn Profile Posts API

Submit profile URLs and discovery controls to the LinkedIn Profile Posts API, follow the asynchronous task, and page through the stored normalized posts.

  1. Prepare one or more public LinkedIn profile URLs whose paths begin with /in/.
  2. Choose only_authored_posts and a results_limit from 1 through 2000 for each profile; add provider date strings only when needed.
  3. POST the request to /v1/linkedin/profile-posts and poll /v1/tasks/{task_id} until it succeeds or fails.
  4. Read data.results.items and continue with next_cursor while has_more is true.
curl -X POST "https://api.socq.ai/v1/linkedin/profile-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/in/satyanadella/"],"only_authored_posts":true,"results_limit":20}'

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

LinkedIn Profile Posts API Use Cases

  • Public communication review: Study topics, claims, links, and recurring language across the returned posts associated with selected professional profiles.
  • Authored-content sampling: Use only_authored_posts to request a narrower sample from the LinkedIn Profile Posts API, then inspect returned author fields whenever authorship matters.
  • Format and media research: Compare available image, video, document, article, hashtag, and mention patterns within a defined set of returned records.
  • Time-bounded engagement snapshots: Apply provider date strings and compare visible engagement only within the collected sample, retaining published_at and collected_at.

LinkedIn Profile Posts API Pro Tips

  • Treat results_limit in the LinkedIn Profile Posts API as a per-profile ceiling: five URLs with a limit of 20 can store up to 100 posts.
  • Keep date inputs as provider strings and document your own convention because SocQ does not validate their format, ordering, boundaries, or time zone.
  • Verify the returned author when only_authored_posts is important; the flag requests provider filtering rather than proving identity.
  • Preserve collected_at beside engagement metrics because visible counts can change between runs.
  • Keep null distinct from zero for timestamps and metrics, and allow media, hashtags, or mentions to be empty.
  • Do not infer expertise, employment status, sentiment, lead quality, influence, or content effectiveness from the normalized sample alone.

Beyond the LinkedIn Profile Posts API, 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 Posts API — Collect public post text, authors, visible engagement, media, publication time, type, and hashtags from supported URLs.
  • 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 Video Transcript API — Turn the captions of LinkedIn videos into plain text from the URLs of the posts that carry them.

Explore other platforms

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

LinkedIn Profile Posts API — FAQ

LinkedIn Profile Posts API is a programmatic interface for discovering public posts associated with submitted LinkedIn profile URLs and returning normalized content, author context, media, timestamps, and visible engagement.

Submit one or more http or https URLs on linkedin.com or a LinkedIn subdomain whose path begins with /in/. Company pages and post URLs are outside this endpoint's input contract.

When true, the value is forwarded to request posts the provider identifies as authored by the target profile. It is not an independent SocQ identity audit, so inspect returned author fields when authorship is material.

No. SocQ forwards non-empty strings without parsing their format, comparing their order, or defining inclusive boundaries and time zones; provider behavior controls filtering.

No. It defaults to 100 and accepts 1 through 2000 separately for each URL, so the task total can be the per-profile limit multiplied by the number of profiles.

No. It means no usable public post records were exposed for the submitted profile and filters during that run; visibility and provider conditions can affect coverage.

Each successfully stored post costs 1 SocQ credit, with no base charge. The estimate uses the per-profile result ceiling, while final billing follows actual stored results; an empty result has no result charge.