Get Post

Get a single post

curl --request GET \
  --url https://api.fetchin.io/api/v1/post \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.fetchin.io/api/v1/post', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fetchin.io/api/v1/post",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fetchin.io/api/v1/post"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fetchin.io/api/v1/post")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "urn:li:activity:7524292314127810561",
  "shareUrn": "urn:li:ugcPost:7524292224508096512",
  "content": "Andrew travels far and wide to sit with families, hear their stories of loss, and document deaths that would otherwise go unreported. What he learns helps save lives.",
  "date": "2026-11-06T02:11:22.279Z",
  "reactionCount": 2786,
  "commentCount": 271,
  "sharesCount": 237,
  "reactionsByType": {
    "like": 2541,
    "empathy": 103,
    "appreciation": 61,
    "praise": 57,
    "interest": 23,
    "entertainment": 1
  },
  "postType": "linkedinVideo",
  "shareUrl": "https://www.linkedin.com/posts/williamhgates_andrew-travels-far-and-wide-to-sit-with-families-activity-7524292314127810561-j6rb",
  "imageUrl": null,
  "videoUrl": "https://dms.licdn.com/playlist/vid/v2/...",
  "carouselPdfUrl": null,
  "images": [],
  "video": {
    "url": "https://dms.licdn.com/playlist/vid/v2/...",
    "duration": 60066,
    "thumbnail": "https://media.licdn.com/dms/image/v2/..."
  },
  "authorType": "Person",
  "authorProfileId": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
  "author": {
    "id": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
    "publicIdentifier": "williamhgates",
    "type": "profile",
    "name": "Bill Gates",
    "url": "https://www.linkedin.com/in/williamhgates?miniProfileUrn=urn%3Ali%3Afsd_profile%3AACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
    "info": "Chair, Gates Foundation and Founder, Breakthrough Energy",
    "numericId": "251749025"
  },
  "mentions": [],
  "contentAttributes": [],
  "profile": {
    "urn": "urn:li:fsd_profile:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
    "name": "Bill Gates",
    "headline": "Chair, Gates Foundation and Founder, Breakthrough Energy",
    "url": "https://www.linkedin.com/in/williamhgates?miniProfileUrn=urn%3Ali%3Afsd_profile%3AACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
    "imageUrl": "https://media.licdn.com/dms/image/v2/..."
  },
  "permissions": {
    "canReact": true,
    "canPostComments": true,
    "canShare": true,
    "commentingDisabled": false,
    "allowedCommentersScope": "ALL",
    "shareAudience": "PUBLIC",
    "isActivity": false,
    "rootShare": true
  }
}

{
  "error": "Invalid post URL or URN: 'williamhgates'. Expected urn:li:activity:<id>, urn:li:ugcPost:<id>, urn:li:share:<id> or a post URL.",
  "code": "INVALID_URN"
}

{
  "error": "Invalid API key",
  "code": "INVALID_API_KEY"
}

{
  "error": "Post not found: 7526000000000000000",
  "code": "POST_NOT_FOUND"
}

{
  "error": "Quota exceeded. Upgrade your plan or wait for renewal.",
  "code": "QUOTA_EXHAUSTED",
  "details": {
    "creditsRemaining": 0,
    "subscriptionCreditsRemaining": 0,
    "paygCreditsRemaining": 0,
    "buyCreditsUrl": "https://fetchin.io/credits"
  }
}

{
  "error": "Internal server error",
  "code": "INTERNAL_ERROR"
}

{
  "error": "Service temporarily unable to serve this request. Please retry.",
  "code": "SERVICE_UNAVAILABLE"
}

GET

api

post

Get a single post

curl --request GET \
  --url https://api.fetchin.io/api/v1/post \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.fetchin.io/api/v1/post', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fetchin.io/api/v1/post",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fetchin.io/api/v1/post"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fetchin.io/api/v1/post")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "urn:li:activity:7524292314127810561",
  "shareUrn": "urn:li:ugcPost:7524292224508096512",
  "content": "Andrew travels far and wide to sit with families, hear their stories of loss, and document deaths that would otherwise go unreported. What he learns helps save lives.",
  "date": "2026-11-06T02:11:22.279Z",
  "reactionCount": 2786,
  "commentCount": 271,
  "sharesCount": 237,
  "reactionsByType": {
    "like": 2541,
    "empathy": 103,
    "appreciation": 61,
    "praise": 57,
    "interest": 23,
    "entertainment": 1
  },
  "postType": "linkedinVideo",
  "shareUrl": "https://www.linkedin.com/posts/williamhgates_andrew-travels-far-and-wide-to-sit-with-families-activity-7524292314127810561-j6rb",
  "imageUrl": null,
  "videoUrl": "https://dms.licdn.com/playlist/vid/v2/...",
  "carouselPdfUrl": null,
  "images": [],
  "video": {
    "url": "https://dms.licdn.com/playlist/vid/v2/...",
    "duration": 60066,
    "thumbnail": "https://media.licdn.com/dms/image/v2/..."
  },
  "authorType": "Person",
  "authorProfileId": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
  "author": {
    "id": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
    "publicIdentifier": "williamhgates",
    "type": "profile",
    "name": "Bill Gates",
    "url": "https://www.linkedin.com/in/williamhgates?miniProfileUrn=urn%3Ali%3Afsd_profile%3AACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
    "info": "Chair, Gates Foundation and Founder, Breakthrough Energy",
    "numericId": "251749025"
  },
  "mentions": [],
  "contentAttributes": [],
  "profile": {
    "urn": "urn:li:fsd_profile:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
    "name": "Bill Gates",
    "headline": "Chair, Gates Foundation and Founder, Breakthrough Energy",
    "url": "https://www.linkedin.com/in/williamhgates?miniProfileUrn=urn%3Ali%3Afsd_profile%3AACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
    "imageUrl": "https://media.licdn.com/dms/image/v2/..."
  },
  "permissions": {
    "canReact": true,
    "canPostComments": true,
    "canShare": true,
    "commentingDisabled": false,
    "allowedCommentersScope": "ALL",
    "shareAudience": "PUBLIC",
    "isActivity": false,
    "rootShare": true
  }
}

{
  "error": "Invalid post URL or URN: 'williamhgates'. Expected urn:li:activity:<id>, urn:li:ugcPost:<id>, urn:li:share:<id> or a post URL.",
  "code": "INVALID_URN"
}

{
  "error": "Invalid API key",
  "code": "INVALID_API_KEY"
}

{
  "error": "Post not found: 7526000000000000000",
  "code": "POST_NOT_FOUND"
}

{
  "error": "Quota exceeded. Upgrade your plan or wait for renewal.",
  "code": "QUOTA_EXHAUSTED",
  "details": {
    "creditsRemaining": 0,
    "subscriptionCreditsRemaining": 0,
    "paygCreditsRemaining": 0,
    "buyCreditsUrl": "https://fetchin.io/credits"
  }
}

{
  "error": "Internal server error",
  "code": "INTERNAL_ERROR"
}

{
  "error": "Service temporarily unable to serve this request. Please retry.",
  "code": "SERVICE_UNAVAILABLE"
}

Endpoint

GET /api/v1/post

Authentication

Include your API key in the request header:

X-API-Key: your-api-key-here

Parameters

string

required

Professional post URL or URN. Accepts any of:

Activity URN: urn:li:activity:7524292314127810561
ugcPost or share URN (the shareUrn of a post): urn:li:ugcPost:7524292224508096512, urn:li:share:7526456101387657217
Post URL: https://www.linkedin.com/feed/update/urn:li:activity:7524292314127810561/ or https://www.linkedin.com/posts/username_post-slug-activity-7524292314127810561-j6rb

All the URNs of a post return the same post, with id set to its activity URN. Anything that is not a post URL or URN is rejected with a free 400 INVALID_URN.

Response

The post itself (not wrapped in a list), with the same fields as a post returned by Get Posts: see the Post object there for the full reference. The main ones:

string

Activity URN of the post (urn:li:activity:...), whichever URN you passed.

Share URN of the post (urn:li:share:... or urn:li:ugcPost:...).

string

Post text. An empty string when the post has no text of its own.

string

ISO 8601 timestamp of when the post was published.

integer

Total reactions. reactionsByType breaks it down by type.

integer

Total comments.

integer

Total reposts.

string

text, image, document, article, linkedinVideo, job, event, celebration, or repost (see Reposts).

object

Who published the post, member or organization page: read type. Same object as in Get Posts.

object

required

The author, in the Get Posts profile shape. profile.urn is urn:li:fsd_profile:<profileId> for a member and urn:li:fsd_company:<companyId> for an organization page.

string

The author’s profile id (ACoAA…), the same value as profileId in Fetch Profile. Members only: omitted when an organization page published the post.

array

The members and companies tagged in the text. Empty when there are none.

object

The quoted post in full, when the post quotes another one (resharedPostUrn is then set too). Its reactionCount, commentCount and sharesCount are included when the source provides them, which it usually does on this endpoint.

array

Every image of the post (url, width, height). imageUrl is the first.

object

Video attached to the post, or null. videoUrl mirrors video.url.

Reposts

A repost without commentary has an activity URN of its own. Pass it and it comes back exactly as Get Posts returns it with includeReposts=true: postType is "repost", content is "", author and profile are the reposter (also named in repostedBy), the item carries no counts of its own, and the original post is under resharedPost. A repost with commentary is a post of its own: its text is in content and the post it quotes is under resharedPost.

Example Request

curl -X GET "https://api.fetchin.io/api/v1/post?postUrlOrUrn=urn:li:activity:7524292314127810561" \
  -H "X-API-Key: your-api-key-here"

const params = new URLSearchParams({
  postUrlOrUrn: 'https://www.linkedin.com/feed/update/urn:li:activity:7524292314127810561/'
});

const response = await fetch(`https://api.fetchin.io/api/v1/post?${params}`, {
  headers: {
    'X-API-Key': 'your-api-key-here'
  }
});

const post = await response.json();
console.log(post);

import requests

headers = {
    'X-API-Key': 'your-api-key-here'
}

params = {
    'postUrlOrUrn': 'urn:li:activity:7524292314127810561'
}

response = requests.get(
    'https://api.fetchin.io/api/v1/post',
    headers=headers,
    params=params
)

post = response.json()
print(post)

<?php

$apiKey = 'your-api-key-here';
$postUrlOrUrn = 'urn:li:activity:7524292314127810561';

$url = "https://api.fetchin.io/api/v1/post?postUrlOrUrn=" . urlencode($postUrlOrUrn);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: ' . $apiKey
]);

$response = curl_exec($ch);
$post = json_decode($response, true);

curl_close($ch);
print_r($post);
?>

Example Response

Trimmed to the fields documented above; the response carries every field of a Get Posts item.

{
  "id": "urn:li:activity:7524292314127810561",
  "shareUrn": "urn:li:ugcPost:7524292224508096512",
  "content": "Andrew travels far and wide to sit with families, hear their stories of loss, and document deaths that would otherwise go unreported. What he learns helps save lives.",
  "date": "2026-11-06T02:11:22.279Z",
  "reactionCount": 2786,
  "commentCount": 271,
  "sharesCount": 237,
  "reactionsByType": {
    "like": 2541,
    "empathy": 103,
    "appreciation": 61,
    "praise": 57,
    "interest": 23,
    "entertainment": 1
  },
  "postType": "linkedinVideo",
  "shareUrl": "https://www.linkedin.com/posts/williamhgates_andrew-travels-far-and-wide-to-sit-with-families-activity-7524292314127810561-j6rb",
  "imageUrl": null,
  "videoUrl": "https://dms.licdn.com/playlist/vid/v2/...",
  "carouselPdfUrl": null,
  "images": [],
  "video": {
    "url": "https://dms.licdn.com/playlist/vid/v2/...",
    "duration": 60066,
    "thumbnail": "https://media.licdn.com/dms/image/v2/..."
  },
  "authorType": "Person",
  "authorProfileId": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
  "author": {
    "id": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
    "publicIdentifier": "williamhgates",
    "type": "profile",
    "name": "Bill Gates",
    "url": "https://www.linkedin.com/in/williamhgates?miniProfileUrn=urn%3Ali%3Afsd_profile%3AACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
    "info": "Chair, Gates Foundation and Founder, Breakthrough Energy",
    "numericId": "251749025"
  },
  "mentions": [],
  "contentAttributes": [],
  "profile": {
    "urn": "urn:li:fsd_profile:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
    "name": "Bill Gates",
    "headline": "Chair, Gates Foundation and Founder, Breakthrough Energy",
    "url": "https://www.linkedin.com/in/williamhgates?miniProfileUrn=urn%3Ali%3Afsd_profile%3AACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
    "imageUrl": "https://media.licdn.com/dms/image/v2/..."
  },
  "permissions": {
    "canReact": true,
    "canPostComments": true,
    "canShare": true,
    "commentingDisabled": false,
    "allowedCommentersScope": "ALL",
    "shareAudience": "PUBLIC",
    "isActivity": false,
    "rootShare": true
  }
}

{
  "error": "Invalid post URL or URN: 'williamhgates'. Expected urn:li:activity:<id>, urn:li:ugcPost:<id>, urn:li:share:<id> or a post URL.",
  "code": "INVALID_URN"
}

{
  "error": "Invalid API key",
  "code": "INVALID_API_KEY"
}

{
  "error": "Post not found: 7526000000000000000",
  "code": "POST_NOT_FOUND"
}

{
  "error": "Quota exceeded. Upgrade your plan or wait for renewal.",
  "code": "QUOTA_EXHAUSTED",
  "details": {
    "creditsRemaining": 0,
    "subscriptionCreditsRemaining": 0,
    "paygCreditsRemaining": 0,
    "buyCreditsUrl": "https://fetchin.io/credits"
  }
}

{
  "error": "Internal server error",
  "code": "INTERNAL_ERROR"
}

{
  "error": "Service temporarily unable to serve this request. Please retry.",
  "code": "SERVICE_UNAVAILABLE"
}

Errors

See Error Handling for the full list of error codes and recommended handling.

400 — MISSING_PARAMETER, INVALID_URN
401 — INVALID_API_KEY
404 — POST_NOT_FOUND: the post does not exist, was deleted, or is not publicly visible
402 — QUOTA_EXHAUSTED
429 — RATE_LIMITED
500 — INTERNAL_ERROR
503 — SERVICE_UNAVAILABLE

Notes

This endpoint consumes 1 credit from your credit balance per API call. Errors are free — with one exception: a 404 not found costs 1 credit. See Quotas.

Need the comments, reactions or reposts too? Pass the same postUrlOrUrn to Get Post Comments, Get Post Reactions or Get Post Reposts.

Authorizations

X-API-Key

string

header

required

Query Parameters

postUrlOrUrn

string

required

Professional post URL or URN: urn:li:activity:<id>, urn:li:ugcPost:<id>, urn:li:share:<id>, or any post URL containing one. All three URNs of a post return the same post, with id set to its activity URN. Anything else is a free 400 INVALID_URN.

Example:

"urn:li:activity:7524292314127810561"

Response

The post, as one item of GET /api/v1/posts

string

Activity URN. References the post in the urn:li:activity:* namespace.

Example:

"urn:li:activity:1234567890"

Share URN. References the same post as id but in the urn:li:share:* or urn:li:ugcPost:* namespace (depends on the post type).

Example:

"urn:li:ugcPost:7123456789012345678"

content

string

Example:

"This is a post content..."

date

string<date-time>

reactionCount

integer

Omitted on a repost item, which has no counts of its own.

commentCount

integer

Omitted on a repost item, which has no counts of its own.

sharesCount

integer

Number of times the post was reshared. Omitted on a repost item, which has no counts of its own.

imageUrl

string

videoUrl

string

carouselPdfUrl

string

profile

object

Show child attributes

resharedPostUrn

string

Set when the author reshared someone else's post WITH their own commentary: the URN of the quoted post, which is also returned in full as resharedPost. Absent on an original post, so !resharedPostUrn selects originals only. Also set on a repost item (includeReposts=true).

Example:

"urn:li:activity:7123456789012345670"

postType

enum<string>

Kind of content attached to the post. 'article' means a link preview card is attached; long-form articles the member published are NOT returned by this endpoint. 'job', 'event' and 'celebration' are shared cards, detailed in the object of the same name. 'repost' is a repost without commentary, returned only with includeReposts=true.

Available options:

text,

image,

document,

article,

linkedinVideo,

job,

event,

celebration,

repost

Example:

"image"

Public permalink to the post.

Example:

"https://www.linkedin.com/posts/williamhgates_my-time-in-rwanda-..."

reactionsByType

object

Reaction counts broken down by type. Only the types the post actually received are present, and they sum to reactionCount. Keys: like, praise, empathy, interest, appreciation, entertainment, superLike. Omitted on a repost item, and on a quoted post whose counts the source did not provide.

Show child attributes

Example:

{
  "like": 4139,
  "empathy": 159,
  "praise": 104,
  "appreciation": 63,
  "interest": 23
}

images

object[]

Every image of the post with its dimensions (empty for non-image posts). imageUrl is the first one, kept for backward compatibility.

Show child attributes

video

object | null

Video attached to the post, or null. videoUrl mirrors video.url.

Show child attributes

authorProfileId

string

Author id, the same value as the profileId returned by /profile.

Example:

"ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc"

authorType

enum<string>

Whether the post was published by a member or by an organization page.

Available options:

Person,

Company

Example:

"Person"

permissions

object

What the post allows, as published.

Show child attributes

author

object

Who published the item, member or organization page. On a repost item it is the reposting profile; inside resharedPost, the original author.

Show child attributes

mentions

object[]

The members and companies tagged in the text, one entry each. Empty when there are none.

Show child attributes

contentAttributes

object[]

Annotated ranges of content: tags, mentions, hashtags and links. start and length index into content.

Show child attributes

job

object

The shared job, on postType: "job". Each field is present when the card carries it.

Show child attributes

event

object

The shared event, on postType: "event". Each field is present when the card carries it. No timestamp is available for the event.

Show child attributes

celebration

object

The celebration card, on postType: "celebration". Each field is present when the card carries it.

Show child attributes

resharedPost

object

The quoted post in full, whenever resharedPostUrn is set: the same shape as an item of posts. Its reactionCount, commentCount, sharesCount, reactionsByType and reactionTypeCounts are OMITTED when the source did not provide them - usually the case for a quoted post - never reported as 0.

repostedBy

object

Only on a postType: "repost" item: who reposted.

Show child attributes

Getting Started

Core Concepts

Apify Compatibility

Account

Posts

Profile

Company

Endpoint

Authentication

Parameters

Response

Reposts

Example Request

Example Response

Errors

Notes

Authorizations

Query Parameters

Response