st.retrieveFeed

This action allows you to retrieve posts from your own LinkedIn home feed.

Constraints

⏺️ Root Start: allowed.

⬆️ Parent Actions: N/A.

⬇️ Child Actions: N/A.

Parameters

{
  "actionType": "st.retrieveFeed",
  "label": "feed",
  "limit": 20
}

const workflow = await linkedapi.retrieveFeed.execute({
  limit: 20
});

const { data, errors } = await linkedapi.retrieveFeed.result(workflow.workflowId);

from linkedapi import RetrieveFeedParams

workflow = linkedapi.retrieve_feed.execute(
    RetrieveFeedParams(
        limit=20,
    )
)

result = linkedapi.retrieve_feed.result(workflow.workflow_id)

linkedin feed retrieve --limit 20

In AI assistants, the MCP server runs this action as the retrieve_feed tool.

linkedin feed retrieve [flags]

• label (optional) – custom label for tracking this action in workflow completion.
• limit (optional) – number of posts to retrieve. Defaults to 20, with a maximum value of 100.

Result options

This action always completes successfully.

{
  "actionType": "st.retrieveFeed",
  "label": "feed",
  "success": true,
  "data": [
    {
      "url": "https://www.linkedin.com/feed/update/urn:li:activity:1234567890123456789",
      "activityUrn": "urn:li:activity:1234567890123456789",
      "time": "2023-01-02T12:30:00Z",
      "type": "original",
      "author": {
        "type": "person",
        "name": "Example Person",
        "urn": "urn:li:member:123456789",
        "profileUrl": "https://www.linkedin.com/in/example-person",
        "headline": "Product Marketing Lead",
        "viewerState": { "connectionDegree": "2nd" }
      },
      "reposter": null,
      "text": "Check out our latest product launch!",
      "repostText": null,
      "hashtags": ["product", "launch"],
      "mentions": ["https://www.linkedin.com/company/example-company"],
      "externalLinks": ["https://example.com/launch"],
      "images": [
        "https://static.linkedin.com/image1.jpg",
        "https://static.linkedin.com/image2.jpg"
      ],
      "documentSlides": [],
      "hasVideo": false,
      "videoThumbnail": null,
      "hasPoll": false,
      "reactionsCount": 27,
      "commentsCount": 8,
      "repostsCount": 12,
      "viewerState": { "reaction": "like", "isOwn": false },
      "feedContext": "Example Reactor reacted to this"
    },
    {
      "url": "https://www.linkedin.com/feed/update/urn:li:activity:2345678901234567890",
      "activityUrn": "urn:li:activity:2345678901234567890",
      "time": "2023-01-01T09:15:00Z",
      "type": "repost",
      "author": {
        "type": "company",
        "name": "Example Company",
        "urn": "urn:li:organization:1234567",
        "companyUrl": "https://www.linkedin.com/company/example-company"
      },
      "reposter": {
        "type": "person",
        "name": "Example Reposter",
        "urn": "urn:li:member:234567890",
        "profileUrl": "https://www.linkedin.com/in/example-reposter",
        "headline": null
      },
      "text": "Original post content about the webinar.",
      "repostText": "A useful summary for anyone planning a launch.",
      "hashtags": [],
      "mentions": [],
      "externalLinks": [],
      "images": [],
      "documentSlides": [],
      "hasVideo": true,
      "videoThumbnail": "https://media.licdn.com/dms/image/video-cover.jpg",
      "hasPoll": false,
      "reactionsCount": 6,
      "commentsCount": 0,
      "repostsCount": 1,
      "viewerState": { "reaction": null, "isOwn": false },
      "feedContext": "Example Reposter reposted this"
    }
  ]
}

• label – included only if specified in the action parameters.
• data – array of posts from your home feed. Sponsored (promoted) posts are included as regular posts.
  • url – URL of the post.
  • activityUrn – LinkedIn activity or UGC URN of the post, if available.
  • time – timestamp when the post was published.
  • type – type of the post. Enum with possible values:
    • original – for original posts.
    • repost – for reposts.
  • author – original content creator. Can be null if the actor cannot be parsed.
    • For person authors: type, name, urn, profileUrl, headline, viewerState with connectionDegree – 1st, 2nd, 3rd+, or null if LinkedIn does not show it (see viewer state).
    • For company authors: type, name, urn, companyUrl.
  • reposter – person or company that reshared the post. Non-null only when type is repost.
    • For person reposters: type, name, urn, profileUrl, headline.
    • For company reposters: type, name, urn, companyUrl.
  • urn on an actor – URN of that person or company, or null when LinkedIn does not expose an identifier for the actor.
  • text – original author's post text, if available.
  • repostText – text added by the reposter on a repost with comment, if available.
  • hashtags – array of hashtags found in the post text, without leading #.
  • mentions – array of person and company profile URLs found in the post text.
  • externalLinks – array of outbound URLs found in the post text.
  • images – array of up to 3 preview image URLs, if available.
  • documentSlides – array of carousel or document slide image URLs, if available.
  • hasVideo – boolean indicating if the post contains a video.
  • videoThumbnail – URL of the video thumbnail, if available.
  • hasPoll – boolean indicating if the post contains a poll.
  • reactionsCount – number of reactions on the post.
  • commentsCount – number of comments on the post.
  • repostsCount – number of reposts on the post.
  • viewerState – what your account has done with the post, see viewer state.
    • reaction – your reaction to the post (like, celebrate, support, love, insightful, funny), or null if you have not reacted or it could not be read.
    • isOwn – true if your account is the post author, false if someone else is, or null if this cannot be told.
  • feedContext – verbatim localized context line explaining why the post appears in your feed (for example, "Example Reactor reacted to this", "Example Reposter reposted this", or "Promoted"). null when no context line is present.