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 responseView as markdown

When to use this

Returns only the updates on the public company guest page, typically up to 12, including reposts. There is no reliable public pagination: LinkedIn's guest feed can repeat the first page. page must be 1. This does not mean the company has no older posts. Empty posts is a valid answer only after a genuine company page was parsed. Shares, documents and complete comment threads are not expanded.

Parameters

All parameters go in the query string.

ParameterDescription
url
stringrequired
Public LinkedIn company page URL, e.g. https://www.linkedin.com/company/hubspot/. Use the base company page.
Example
https://www.linkedin.com/company/hubspot/
page
integeroptional
Only page 1 is supported: the company's latest publicly visible updates.
Default
1

Example request

Replace YOUR_API_KEY with your key, or set LURKAPI_KEY for the code. Get a free key.

Language

Example response

A real response from this endpoint, captured from the live API and trimmed to a couple of items. Strings over 96 characters (mostly signed media URLs) are cut short and end in ….

Show the example response (2 KB)
{
  "success": true,
  "credits_remaining": 999998,
  "credits_charged": 1,
  "company": {
    "id": "68529",
    "name": "HubSpot",
    "url": "https://www.linkedin.com/company/hubspot"
  },
  "posts": [
    {
      "id": "7510369779325734912",
      "url": "https://www.linkedin.com/posts/hubspot_we-built-the-original-flywheel-pl…",
      "text": "We built the original flywheel playbook.\n\nThen AI broke it.\n\nSo we did w…",
      "datePublished": "2026-09-28T16:08:11.313Z",
      "dateSource": "published",
      "likeCount": 166,
      "commentCount": 23,
      "images": [
        "https://media.licdn.com/dms/image/v2/D4E10AQGtNbunT0NzDg/image-shrink_80…"
      ],
      "video": null,
      "reposted": false
    },
    {
      "id": "7509275824353755137",
      "url": "https://www.linkedin.com/posts/hubspot_hubspot-activity-7509275824353755137-t_UZ",
      "text": "Yep. Everyone's using AI, but new data shows only 6% of companies are ge…",
      "datePublished": "2026-09-25T15:41:12.123Z",
      "dateSource": "published",
      "likeCount": 125,
      "commentCount": 23,
      "images": [],
      "video": null,
      "reposted": false
    }
  ],
  "paginationAvailable": false
}

Response fields

Every field of a successful response. [] marks a list: a[].b is the b of each item in a. nullable fields can be null; optional fields can be missing.

Show all 19 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.idstringnullableOrganization id, when exposed.
company.namestringCompany name.
company.urlstringCanonical company page URL.
postsobject[]Latest public company update cards 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[].datePublishedstringnullablePublication time in UTC. For repost cards with no published timestamp, estimated from the activity id; see dateSource.
posts[].dateSourcestringnullablepublished comes from LinkedIn JSON-LD; activity_id is reconstructed from the activity id and may describe the repost time. Null when unavailable.
posts[].likeCountnumbernullableTotal reactions LinkedIn shows, including reaction types other than likes; null when hidden.
posts[].commentCountnumbernullableNumber of comments shown on the public card; null when hidden.
posts[].imagesstring[]Public images in the update, in source order. Expiring URLs; empty for video-only or document-only cards.
posts[].videostringnullableA publicly playable video URL from the card, or null. URLs may expire.
posts[].repostedbooleanTrue when LinkedIn explicitly marks this update as a repost.
paginationAvailablefalseAlways false: no reliable public pagination is available.

Caching and freshness

Responses are cached for up to 1 hour, so a repeat call within that window can return the same data. It still costs 1 credit.

Errors

Errors return { success: false, error, code, docs } with the HTTP status below. Validation errors, 401/402/429 rejections and 5xx failures are free; not_found is charged (how charging works). All error codes.

StatusCodeMeaning
401missing_api_keyNo API key. Send it in the x-api-key header.
401invalid_api_keyThe key is unknown or was revoked.
402insufficient_creditsNot enough credits for this call. Buy a pack or wait for tomorrow's top-up.
404not_foundThe endpoint, or the thing you asked for (ad, post, subreddit), doesn't exist. Charged when the platform was checked.
405method_not_allowedEndpoints take GET with query params.
429rate_limitedToo many calls at once. Wait for the retry-after seconds, then retry.
500internal_errorSomething broke on our side. Retry; 5xx errors are free.
502upstream_errorThe platform didn't give a usable answer. Retry; 5xx errors are free.
503upstream_busyAll our connections to the platform are busy. Retry in a few seconds; 5xx errors are free.
504upstream_timeoutThe platform took over 30 seconds to answer. Retry; timeouts are free.

Use it in Claude

Once LurkAPI is connected to Claude, this endpoint is the linkedin_company_posts tool. Ask in plain English, for example:

Ask Claude
Use LurkAPI's linkedin_company_posts with url "https://www.linkedin.com/company/hubspot/" and 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/"
}

Tool results skip nulls and empty lists to save tokens.