# LinkedIn Post API. Send a post link or ID.

Post or article with exact reactions and comments. We handle the proxies, blocks and platform changes.

[Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dlinkedin.post)

## LinkedIn Post API at a glance

Returns a public LinkedIn post or Pulse article from its link, URN or activity ID, with exact reaction and comment counts and its top comments. You also get the text with hashtags and mentions, the exact publish time, the author (member or Page) with their headline and follower count, images, the native video file, a document's pages, the link card and the post a reshare quotes. An article adds its full body, cover image, last edit and the author's other articles.

GET `/v1/linkedin/post`

[Read the API reference](https://socialtap.dev/docs/reference/linkedin/post/index.md)

- **1 credit** per request, $0.75–$1.97 per 1,000 requests
- **22 typed fields** null when unknown
- **`url`** is all it needs, e.g. `https://www.linkedin.com/feed/update/urn:li:activity:7522801130767224832`
- **100 credits** free when you sign up, no card, so you can build before you spend

## Send one request. Get 22 fields back.

Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.

`$ npm install socialtap`

`url = https://www.linkedin.com/feed/update/urn:li:activity:7522801130767224832`

[Open in playground](https://socialtap.dev/playground/?endpoint=linkedin.post)

cURL:

```shell
curl -G 'https://socialtap.dev/v1/linkedin/post' \
  --data-urlencode 'url=https://www.linkedin.com/feed/update/urn:li:activity:7522801130767224832/' \
  -H "x-api-key: $SOCIALTAP_API_KEY"
```

TypeScript SDK:

```typescript
import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.linkedin.post.get({ url: "https://www.linkedin.com/feed/update/urn:li:activity:7522801130767224832/" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);
```

Node.js (fetch):

```javascript
const params = new URLSearchParams({
  url: "https://www.linkedin.com/feed/update/urn:li:activity:7522801130767224832/",
});
const res = await fetch(`https://socialtap.dev/v1/linkedin/post?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, meta } = body;
console.log(data, meta.credits_charged);
```

Python (requests):

```python
import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/linkedin/post",
    params={"url": "https://www.linkedin.com/feed/update/urn:li:activity:7522801130767224832/"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, meta = body["data"], body["meta"]
print(data, meta["credits_charged"])
```

Go (net/http):

```go
package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("url", "https://www.linkedin.com/feed/update/urn:li:activity:7522801130767224832/")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/linkedin/post?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}
```

200 OK:

```json
{
  "data": {
    "approximate_fields": [],
    "author": {
      "avatar_url": "https://media.licdn.com/dms/image/v2/D5603AQF-RYZP55jmXA/profile-displayphoto-shrink_400_400/B56ZRi8g.aGsAg-/0/1736826818802?e=2147483647&v=beta&t=r6LJYwKPrJzfFDXVG8qAOoklQnqvEN855sHJ1NxhEAo",
      "display_name": "Bill Gates",
      "id": null,
      "is_verified": null,
      "url": "https://www.linkedin.com/in/williamhgates",
      "username": "williamhgates"
    },
    "coauthors": [],
    "duration_ms": null,
    "hashtags": [],
    "id": "7522801130767224832",
    "is_nsfw": null,
    "is_pinned": null,
    "is_sponsored": null,
    "language": null,
    "media": [],
    "mentions": [],
    "metrics": {
      "comment_count": 242,
      "like_count": 1344,
      "quote_count": null,
      "repost_count": null,
      "save_count": null,
      "share_count": null,
      "view_count": null
    },
    "platform": "linkedin",
    "platform_specific": {
      "linkedin": {
        "author_follower_count": 40785228,
        "author_headline": "Chair, Gates Foundation and Founder, Breakthrough Energy",
        "content_urn": "urn:li:share:7522801130179837952",
        "document": null,
        "hidden_image_count": null,
        "is_author_influencer": true,
        "is_edited": true,
        "link": {
          "image_url": "https://media.licdn.com/dms/image/sync/v2/D4E27AQFkOX_Yu-a3fA/articleshare-shrink_800/B4EaFOeCzFLEAc-/0/1792317861513?e=2147483647&v=beta&t=qdrGnTqb_PQ04rvZTnnwoc3rZ4giI_-1g2TBBvB65IM",
          "source": "theguardian.com",
          "title": "World Bank says ‘small AI’ could transform developing countries",
          "url": "https://www.theguardian.com/technology/2026/oct/18/world-bank-artificial-intelligence-developing-economies"
        },
        "modified_at": null,
        "more_articles": [],
        "repost_activity_id": null,
        "reshared_post": null,
        "top_comments": [
          {
            "author": {
              "avatar_url": null,
              "display_name": "Cristian Perez Añasco",
              "id": null,
              "is_verified": null,
              "url": "https://www.linkedin.com/in/cristian-perez-a%C3%B1asco-87a11740",
              "username": "cristian-perez-añasco-87a11740"
            },
            "id": "7522806165316210688",
            "like_count": 49,
            "published_at": "2026-11-01T23:45:56Z",
            "text": "What Bill Gates points to is already scaling in India with measurable numbers. MahaVISTAAR-AI under MahaAgri-AI policy crossed 3 million downloads in months and portable soil testing using hyperspectral imaging delivers full chemical profile with over 90 percent accuracy. All run…"
          },
          {
            "author": {
              "avatar_url": "https://media.licdn.com/dms/image/v2/D5603AQFJhAiszj4Vmg/profile-displayphoto-scale_400_400/B56aGi12q6K8Ak-/0/1793733390035?e=2147483647&v=beta&t=KBT6MVpk5Bh7XGkE-G3cBKFsdxm7b9Yt86yyvQ1zwWM",
              "display_name": "Chris Black",
              "id": null,
              "is_verified": null,
              "url": "https://www.linkedin.com/in/chris-black-yyc",
              "username": "chris-black-yyc"
            },
            "id": "7523029437056114688",
            "like_count": 6,
            "published_at": "2026-11-02T14:33:08Z",
            "text": "The phone already in their pocket is what got me. A farmer gets an answer in their own language without buying anything new."
          },
          {
            "author": {
              "avatar_url": null,
              "display_name": "Henrik Pålsson",
              "id": null,
              "is_verified": null,
              "url": "https://www.linkedin.com/in/henrik-p%C3%A5lsson-278659",
              "username": "henrik-pålsson-278659"
            },
            "id": "7522804034852855808",
            "like_count": 5,
            "published_at": "2026-11-01T23:37:28Z",
            "text": "100% agree, but The Road Ahead has rather more bends than we imagined when we met in Stockholm 30 years ago. Perhaps the map was folded. 😉"
          }
        ]
      }
    },
    "platform_type": "post",
    "published_at": "2026-11-01T23:25:56Z",
    "text": "Useful advice for farmers, in their own language, on a phone they already have in their pocket. That’s the type of AI I’m excited about.",
    "thumbnail_url": "https://media.licdn.com/dms/image/sync/v2/D4E27AQFkOX_Yu-a3fA/articleshare-shrink_800/B4EaFOeCzFLEAc-/0/1792317861513?e=2147483647&v=beta&t=qdrGnTqb_PQ04rvZTnnwoc3rZ4giI_-1g2TBBvB65IM",
    "title": "World Bank says ‘small AI’ could transform developing countries",
    "type": "link",
    "unknown_fields": [],
    "url": "https://www.linkedin.com/feed/update/urn:li:activity:7522801130767224832"
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "linkedin",
    "source": "page",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 703,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": {
      "kind": "post",
      "id": "7522801130767224832",
      "url": "https://www.linkedin.com/feed/update/urn:li:activity:7522801130767224832"
    },
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}
```

Long arrays and strings are shortened here. Real responses are complete.

## One schema on 21 platforms.

The [response reference](https://socialtap.dev/docs/reference/linkedin/post/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/post/index.md).

- ### Null means unknown

  A field LinkedIn doesn't show is null, never zero or an empty string, so a real zero always means zero.
- ### What it accepts

  A LinkedIn post or article: a post's link as the share menu gives it (linkedin.com/posts/\<author>_\<slug>-activity-\<id>-\<code>), its feed or embed link (linkedin.com/feed/update/urn:li:activity:\<id>, also urn:li:share: and urn:li:ugcPost:), an article's (linkedin.com/pulse/\<slug>), on any country host, or a post's bare URN (urn:li:activity:\<id>) or activity ID.
- ### Write one parser

  LinkedIn, TikTok, Instagram and 18 more platforms answer in these fields, so the code that reads one reads them all.

- **`platform`string**: Platform ID (tiktok, youtube, …).
- **`id`string**: Platform-native post ID (string; Instagram shortcode, Reddit with its t3_ prefix).
- **`url`string**: Canonical post URL.
- **`type`string**: Normalized content shape. New values may be added; treat unknown values as other.
- **`platform_type`string**: The platform's own product label, lowercase (reel, short, story, live, tweet, …).
- **`title`string**: Headline (YouTube title, Reddit title); null on caption-only platforms.
- **`text`string**: Caption, description or body as plain text.
- **`language`string**: BCP-47 language of text, when the platform states it.

Live data from 33 platforms.

[TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md)

## What teams build with the LinkedIn Post API.

- ### Track engagement on company and creator posts
- ### Collect posts and articles for a brand report
- ### Pull a post's top comments and their authors
- ### Archive a post's text, images, video and documents

## Good to know before you build.

- like_count totals every reaction type (like, celebrate, support, love, insightful, funny), as LinkedIn counts them.
- id is the post's activity ID whatever link you send. An article has its own ID, and its /pulse/ link, the only one that opens it, is its url.
- A repost without commentary returns the original post (its id, author and text), with the repost's activity ID in platform_specific.linkedin.repost_activity_id.
- A deleted post and one its author limited to their connections both return not_found: LinkedIn answers them alike.
- view_count, share_count and repost_count are null because LinkedIn doesn't show them logged out. Images beyond the ones the page shows are counted in platform_specific.linkedin.hidden_image_count.
- top_comments holds the comments LinkedIn shows logged out, about ten at most.
- When the post's page is unavailable, the answer comes from its embed card, without top comments (see unknown_fields), a member author's exact follower count, or a video's title, size and length.

## 1 credit per request. Failed requests are free.

Buy credits once and spend them on any endpoint, on any platform.

[Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/linkedin/post/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md)

| Source | Price per successful request | Per 1,000 requests |
| --- | --- | --- |
| Public page `page` | 1 credit | $0.75–$1.97 |

- Cache hits are free.
- Credits from packs and top-ups never expire.
- A monthly plan's credits are spent first, and what is left of them ends at each renewal.
- Prices exclude tax: sales tax is added at checkout where it applies.
- Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.

## Questions about the LinkedIn Post API.

More in the [API reference](https://socialtap.dev/docs/reference/linkedin/post/index.md).

**Can I pass a share or UGC post link?**

Yes. urn:li:share:\<id> and urn:li:ugcPost:\<id> are other numbers for the same post: the answer's id is its activity ID and platform_specific.linkedin.content_urn the URN of its content.

**How much does the LinkedIn Post API cost?**

A request costs 1 credit. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack.

Other platforms

## Posts on 20 more platforms.

- [TikTok Post API](https://socialtap.dev/apis/tiktok/post/index.md) (1 credit · `GET /v1/tiktok/post`)
- [Instagram Post API](https://socialtap.dev/apis/instagram/post/index.md) (1 credit · `GET /v1/instagram/post`)
- [Facebook Post API](https://socialtap.dev/apis/facebook/post/index.md) (1 credit · `GET /v1/facebook/post`)
- [YouTube Video API](https://socialtap.dev/apis/youtube/post/index.md) (1 credit · `GET /v1/youtube/post`)
- [Reddit Post API](https://socialtap.dev/apis/reddit/post/index.md) (1 credit · `GET /v1/reddit/post`)
- [Threads Post API](https://socialtap.dev/apis/threads/post/index.md) (1 credit · `GET /v1/threads/post`)
- [Spotify Track API](https://socialtap.dev/apis/spotify/track/index.md) (1 credit · `GET /v1/spotify/track`)
- [Amazon Shop Posts API](https://socialtap.dev/apis/amazon/shop_posts/index.md) (1 credit / page · `GET /v1/amazon/shop_posts`)
- [Apple Music Track API](https://socialtap.dev/apis/applemusic/track/index.md) (1 credit · `GET /v1/applemusic/track`)
- [Pinterest Pin API](https://socialtap.dev/apis/pinterest/pin/index.md) (1 credit · `GET /v1/pinterest/pin`)
- [Rumble Video API](https://socialtap.dev/apis/rumble/post/index.md) (1 credit · `GET /v1/rumble/post`)
- [X (Twitter) Post API](https://socialtap.dev/apis/x/post/index.md) (1 credit · `GET /v1/x/post`)
- [Bluesky Post API](https://socialtap.dev/apis/bluesky/post/index.md) (1 credit · `GET /v1/bluesky/post`)
- [Twitch Video and Clip API](https://socialtap.dev/apis/twitch/video/index.md) (1 credit · `GET /v1/twitch/video`)
- [Telegram Post API](https://socialtap.dev/apis/telegram/post/index.md) (1 credit · `GET /v1/telegram/post`)
- [Kwai Post API](https://socialtap.dev/apis/kwai/post/index.md) (1 credit · `GET /v1/kwai/post`)
- [Snapchat Spotlight API](https://socialtap.dev/apis/snapchat/spotlight/index.md) (1 credit · `GET /v1/snapchat/spotlight`)
- [SoundCloud Track API](https://socialtap.dev/apis/soundcloud/track/index.md) (1 credit · `GET /v1/soundcloud/track`)
- [Truth Social Post API](https://socialtap.dev/apis/truthsocial/post/index.md) (1 credit · `GET /v1/truthsocial/post`)
- [Kick Clip API](https://socialtap.dev/apis/kick/post/index.md) (1 credit · `GET /v1/kick/post`)

More LinkedIn

## LinkedIn API. 4 endpoints, one key.

- [LinkedIn Profile API](https://socialtap.dev/apis/linkedin/profile/index.md) (From 1 credit · `GET /v1/linkedin/profile`)
- [LinkedIn Post Search API](https://socialtap.dev/apis/linkedin/search_posts/index.md) (From 1 credit / page · `GET /v1/linkedin/search_posts`)
- [LinkedIn Company and People Search API](https://socialtap.dev/apis/linkedin/search_profiles/index.md) (From 1 credit / page · `GET /v1/linkedin/search_profiles`)

## Try it on a link you already have.

Paste it in the playground, or copy the request into your code.

100free credits

- No credit card
- Failed requests are free
- Works on all 218 endpoints

[Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md)

---

[HTML version](https://socialtap.dev/apis/linkedin/post/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)
