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

json
{
  "actionType": "st.retrieveFeed",
  "label": "feed",
  "limit": 20
}
  • 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

  1. Successful retrieval:
json
{
  "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",
        "profileUrl": "https://www.linkedin.com/in/example-person",
        "headline": "Product Marketing Lead"
      },
      "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,
      "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",
        "companyUrl": "https://www.linkedin.com/company/example-company"
      },
      "reposter": {
        "type": "person",
        "name": "Example Reposter",
        "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,
      "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, profileUrl, headline.
      • For company authors: type, name, companyUrl.
    • reposter – person or company that reshared the post. Non-null only when type is repost.
      • For person reposters: type, name, profileUrl, headline.
      • For company reposters: type, name, companyUrl.
    • 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.
    • 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.
  1. Failed retrieval:
json
{
  "actionType": "st.retrieveFeed",
  "label": "feed",
  "success": false,
  "error": {
    "type": "unexpectedError",
    "message": "An unexpected error occurred during action execution."
  }
}
  • label – included only if specified in the action parameters.
  • error.type – enum with the following possible values:
    • unexpectedError – no parseable posts could be retrieved from the feed, for example due to a slow connection or a temporary rendering issue. Try running the action again.