LurkAPI
Docs · LinkedIn company posts

LinkedIn company posts

Latest public updates from a company page, with text, engagement and media.

1 credit per callFresh within 1 hourMCP tool: linkedin_company_posts
GEThttps://api.lurkapi.com/v1/linkedin/company/posts

Example response

When to use this

Use it to see what a company posts on LinkedIn: each update's text, reactions, comment count, images, video and document previews. Pass the company page URL. You get the latest updates its public page shows, usually up to 12, reposts included.

There are no further pages, so page must be 1. LinkedIn's public feed can repeat the first page, and older posts need a login.

LinkedIn sometimes serves the page without its updates. Then we fetch it once more, and an empty answer is cached for only 5 minutes. Reshared posts, documents and full comment threads aren't opened.

Example request

Copy one and replace YOUR_API_KEY with your API key (get one free). The code versions read the key from the LURKAPI_API_KEY environment variable instead.

Language

Parameters

Add them to the URL after a ?. Join several with &.

ParameterDescription
url
stringrequired
A LinkedIn company page URL, e.g. https://www.linkedin.com/company/hubspot/. Use the main page, not a subpage like /jobs/ or /about/.
Example
https://www.linkedin.com/company/hubspot/
page
integeroptional
Always 1. The latest updates are the only page LinkedIn shows logged-out visitors.
Default
1

Example response

A real response, captured from the live API. Lists are trimmed to a couple of items, and long text such as media links is cut short with ….

Show the example response (2 KB)
{
  "success": true,
  "credits_remaining": 999976,
  "credits_charged": 1,
  "company": {
    "id": "68529",
    "name": "HubSpot",
    "url": "https://www.linkedin.com/company/hubspot"
  },
  "posts": [
    {
      "id": "7508637605941526528",
      "url": "https://www.linkedin.com/posts/hubspot_unbound-activity-7508637605941526528-z3eI",
      "text": "UNBOUND 2026 is still living in our group chats.\n\nHuge thanks to Tom Bra…",
      "datePublished": "2026-09-23T21:25:08.995Z",
      "dateSource": "published",
      "likeCount": 574,
      "commentCount": 29,
      "images": [],
      "video": null,
      "document": {
        "title": "UNBOUND",
        "pageCount": 6,
        "pageImages": [
          "https://media.licdn.com/dms/image/v2/D5610AQGDVYmfGsp2xw/ads-document-co…",
          "https://media.licdn.com/dms/image/v2/D5610AQGDVYmfGsp2xw/ads-document-co…",
          "https://media.licdn.com/dms/image/v2/D5610AQGDVYmfGsp2xw/ads-document-co…"
        ]
      },
      "reposted": false,
      "resharedPost": null
    },
    {
      "id": "7508199655307124736",
      "url": "https://www.linkedin.com/posts/hubspot_loop-outlearn-outmarket-outgrow-p…",
      "text": "It’s officially launch day for Loop! We’ve had a front-row seat as Kipp …",
      "datePublished": "2026-09-22T16:24:53.428Z",
      "dateSource": "published",
      "likeCount": 43,
      "commentCount": 11,
      "images": [],
      "video": null,
      "document": null,
      "reposted": false,
      "resharedPost": {
        "id": "7508124481979240448",
        "url": "https://www.linkedin.com/feed/update/urn:li:activity:7508124481979240448/",
        "author": {
          "name": "Kipp Bodnar",
          "url": "https://www.linkedin.com/in/kippbodnar"
        },
        "text": "It’s launch day. 🚀🚀🚀\n\nLoop: Outlearn. Outmarket. Outgrow. is official…",
        "datePublished": "2026-09-22T11:26:10.711Z",
        "images": [],
        "video": null,
        "document": null
      }
    }
  ],
  "paginationAvailable": false
}

Response fields

Every field in a successful response, and what it means. A name with [] belongs to each item of a list: posts[].id is the id of every item in posts. null means there's no value.

Show all 37 fields
FieldTypeDescription
successtrueAlways true here; errors have success: false.
credits_remainingnumberYour balance after this call. On anonymous playground calls: free tries left today.
credits_chargednumberCredits this call cost; 0 on free endpoints. On anonymous playground calls: tries used (1).
companyobjectCompany whose latest updates are listed.
company.idstringcan be nullOrganization id, when exposed.
company.namestringCompany name.
company.urlstringCanonical company page URL.
postsobject[]The latest updates, in LinkedIn's order.
posts[].idstringActivity id of this update, kept as a string to preserve all digits.
posts[].urlstringPublic post URL or activity permalink.
posts[].textstringThe update's public text. Empty when the card only contains media.
posts[].datePublishedstringcan be nullWhen it was posted, in UTC. dateSource says where the time comes from.
posts[].dateSourcestringcan be nullpublished: LinkedIn states the time. activity_id: we read it from the update's id, which gives the post time for originals and the repost time for reposts. Null when unavailable.
posts[].likeCountnumbercan be nullTotal reactions LinkedIn shows, not only likes; null when hidden.
posts[].commentCountnumbercan be nullNumber of comments LinkedIn shows; null when hidden.
posts[].imagesstring[]Images in the update, in order; the links expire. Empty for video-only or document-only updates (document pages are in document).
posts[].videostringcan be nullA publicly playable video URL from the card, or null. URLs may expire.
posts[].documentobjectcan be nullAn attached document (PDF or slides), or null.
posts[].document.titlestringcan be nullDocument title.
posts[].document.pageCountnumbercan be nullNumber of pages LinkedIn reports for the document.
posts[].document.pageImagesstring[]Preview images of the first pages, in order. LinkedIn previews a few pages, not all. URLs may expire.
posts[].repostedbooleanTrue when LinkedIn explicitly marks this update as a repost.
posts[].resharedPostobjectcan be nullThe original post, when this update reposts it with commentary and embeds it; null otherwise. A plain repost has reposted: true and shows the original as the update itself.
posts[].resharedPost.idstringActivity id of the original post.
posts[].resharedPost.urlstringActivity permalink of the original post.
posts[].resharedPost.authorobjectWho published the original post.
posts[].resharedPost.author.namestringcan be nullAuthor name.
posts[].resharedPost.author.urlstringcan be nullAuthor's LinkedIn profile or page URL.
posts[].resharedPost.textstringThe original post's text. Empty when it only contains media.
posts[].resharedPost.datePublishedstringcan be nullPublication time in UTC, decoded from the original's activity id.
posts[].resharedPost.imagesstring[]Images in the original post, in source order. URLs may expire.
posts[].resharedPost.videostringcan be nullA publicly playable video URL from the original post, or null. URLs may expire.
posts[].resharedPost.documentobjectcan be nullAn attached document (PDF or slides), or null.
posts[].resharedPost.document.titlestringcan be nullDocument title.
posts[].resharedPost.document.pageCountnumbercan be nullNumber of pages LinkedIn reports for the document.
posts[].resharedPost.document.pageImagesstring[]Preview images of the first pages, in order. LinkedIn previews a few pages, not all. URLs may expire.
paginationAvailablefalseAlways false, since there's no reliable way to page further.

Cost and freshness

Each call costs 1 credit. Calls turned away before they reach the platform (invalid parameters, a key or balance problem, a rate limit) are free, and so are 5xx errors. A not_found is charged, since the platform was checked. How charging works.

Answers are cached for up to 1 hour. A repeat call within that time can return the same data, and costs the same.

Errors

A failed call returns success: false, an error message, a code your program can check, and a docs link. These are the errors this endpoint can return. All error codes.

StatusCodeMeaning
401missing_api_keyNo API key was sent. Put it in the x-api-key header.
401invalid_api_keyThis key doesn't exist or was revoked.
402insufficient_creditsNot enough credits for this call. Buy a pack, or wait for tomorrow's free top-up.
402over_max_creditsThis call would cost more than the max_credits you set. The error says what it needs; raise max_credits to allow it. Not charged.
403account_suspendedThis account is suspended. Email support@lurkapi.com. Not charged.
404not_foundWhat you asked for (a post, an ad, a subreddit) doesn't exist, or there's no endpoint at that path. Charged if the platform was checked.
405method_not_allowedEndpoints only take GET, with parameters in the URL.
429rate_limitedToo many calls in a short time. Wait as many seconds as the retry-after header says, then retry.
500internal_errorSomething broke on our side. Retry. Not charged.
502upstream_errorThe platform didn't send a usable answer. Retry. Not charged.
503upstream_busyAll our connections to the platform are busy. Retry in a few seconds. Not charged.
504upstream_timeoutThe platform took over 30 seconds to answer (90 for web pages). Retry. Not charged.

Use it in Claude

Connect LurkAPI to Claude and ask in plain English. This endpoint is the linkedin_company_posts tool. For example:

Ask Claude
Use LurkAPI's linkedin_company_posts tool with url "https://www.linkedin.com/company/hubspot/", then summarize what you find.

Claude calls linkedin_company_posts with arguments like these, and each call costs 1 credit:

Tool arguments
{"url": "https://www.linkedin.com/company/hubspot/"}

To save tokens, tool results leave out empty fields, keep one URL per image or video, and give transcripts as plain text unless you pass timestamps=true. A result over 45,000 characters comes in parts. Its _note gives the offset for the next part, and later parts are free for 15 minutes. Pass trim=false for the full response.

From the blog

All posts