Get Post Engagement

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

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

fetch('https://api.fetchin.io/api/v1/post/engagement', 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/engagement",
  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/engagement"

	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/engagement")

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

{
  "post": "urn:li:activity:7287782484287606784",
  "comments": [
    {
      "urn": "urn:li:comment:(ugcPost:7287782484287606784,7287957733851484162)",
      "text": "Great post!",
      "createdAt": "2024-01-22T14:22:07.458Z",
      "reactionCount": 5,
      "author": {
        "id": "urn:li:fsd_profile:ACoAABCDEFG",
        "name": "Jane Doe",
        "headline": "Software Engineer",
        "profileUrl": "https://www.linkedin.com/in/janedoe"
      },
      "replies": []
    }
  ],
  "commentsPaginationToken": "MTAtMTcwNjAwMDAwMDAwMA==",
  "commentsHasMore": true,
  "reactions": [
    {
      "reactionType": "LIKE",
      "actor": {
        "urn": "urn:li:fsd_profile:ACoAABBfDXAB9eK9V6vEHbzfQXZ-wcjke_QuT7g",
        "name": "Kevin Piacentini",
        "headline": "Lead Engineer",
        "profileUrl": "https://www.linkedin.com/in/ACoAABBfDXAB9eK9V6vEHbzfQXZ-wcjke_QuT7g",
        "profilePictureUrl": "https://media.licdn.com/dms/image/..."
      }
    }
  ],
  "reactionsHasMore": false
}

{
  "error": "Missing postUrlOrUrn parameter",
  "code": "MISSING_PARAMETER"
}

{
  "error": "Quota exceeded. Upgrade your plan or wait for renewal.",
  "code": "QUOTA_EXHAUSTED"
}

{
  "error": "Unable to find post from url",
  "code": "POST_NOT_FOUND"
}

{
  "error": "This endpoint costs 2 RPS units but your plan allows 1 request(s) per second. Upgrade your plan to use it.",
  "code": "RATE_LIMITED"
}

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

GET

api

post

engagement

Get Post Engagement

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

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

fetch('https://api.fetchin.io/api/v1/post/engagement', 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/engagement",
  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/engagement"

	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/engagement")

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

{
  "post": "urn:li:activity:7287782484287606784",
  "comments": [
    {
      "urn": "urn:li:comment:(ugcPost:7287782484287606784,7287957733851484162)",
      "text": "Great post!",
      "createdAt": "2024-01-22T14:22:07.458Z",
      "reactionCount": 5,
      "author": {
        "id": "urn:li:fsd_profile:ACoAABCDEFG",
        "name": "Jane Doe",
        "headline": "Software Engineer",
        "profileUrl": "https://www.linkedin.com/in/janedoe"
      },
      "replies": []
    }
  ],
  "commentsPaginationToken": "MTAtMTcwNjAwMDAwMDAwMA==",
  "commentsHasMore": true,
  "reactions": [
    {
      "reactionType": "LIKE",
      "actor": {
        "urn": "urn:li:fsd_profile:ACoAABBfDXAB9eK9V6vEHbzfQXZ-wcjke_QuT7g",
        "name": "Kevin Piacentini",
        "headline": "Lead Engineer",
        "profileUrl": "https://www.linkedin.com/in/ACoAABBfDXAB9eK9V6vEHbzfQXZ-wcjke_QuT7g",
        "profilePictureUrl": "https://media.licdn.com/dms/image/..."
      }
    }
  ],
  "reactionsHasMore": false
}

{
  "error": "Missing postUrlOrUrn parameter",
  "code": "MISSING_PARAMETER"
}

{
  "error": "Quota exceeded. Upgrade your plan or wait for renewal.",
  "code": "QUOTA_EXHAUSTED"
}

{
  "error": "Unable to find post from url",
  "code": "POST_NOT_FOUND"
}

{
  "error": "This endpoint costs 2 RPS units but your plan allows 1 request(s) per second. Upgrade your plan to use it.",
  "code": "RATE_LIMITED"
}

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

Endpoint

GET /api/v1/post/engagement

Returns both the comments and the reactions of a professional post in one request. Use this instead of calling /post/comments and /post/reactions separately when you need both.

This endpoint bills 2 credits and counts as 2 units against your per-second rate limit. It is all-or-nothing: if either half cannot be fetched, the whole request returns an error and 0 credits are charged. Because it costs 2 rate-limit units, your plan’s per-second limit must be at least 2 to call it.

Authentication

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

Parameters

string

required

Professional post URL or URN.Examples:

https://www.linkedin.com/posts/username_some-post-slug-1234567890-abcd
urn:li:activity:7287782484287606784
urn:li:ugcPost:7287782484287606784

integer

default:"100"

Number of comments to fetch (1–100).

integer

default:"0"

Comments offset (kept for parity; comments primarily paginate by token).

string

Token from a previous response used to fetch the next page of comments.

integer

default:"100"

Number of reactions to fetch (1–100).

integer

default:"0"

Reactions offset for pagination.

Response

string

The resolved post identifier you passed in.

array

Array of comments (same object shape as Get Post Comments).

string

Token to fetch the next page of comments. Absent when there are no more.

boolean

Whether more comments are available.

array

Array of reactions (same object shape as Get Post Reactions).

boolean

Whether more reactions are available.

Example Request

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

const response = await fetch(
  'https://api.fetchin.io/api/v1/post/engagement?postUrlOrUrn=urn:li:activity:7287782484287606784',
  { headers: { 'X-API-Key': 'your-api-key-here' } }
);

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

import requests

response = requests.get(
    'https://api.fetchin.io/api/v1/post/engagement',
    headers={'X-API-Key': 'your-api-key-here'},
    params={'postUrlOrUrn': 'urn:li:activity:7287782484287606784'},
)

print(response.json())

Example Response

{
  "post": "urn:li:activity:7287782484287606784",
  "comments": [
    {
      "urn": "urn:li:comment:(ugcPost:7287782484287606784,7287957733851484162)",
      "text": "Great post!",
      "createdAt": "2024-01-22T14:22:07.458Z",
      "reactionCount": 5,
      "author": {
        "id": "urn:li:fsd_profile:ACoAABCDEFG",
        "name": "Jane Doe",
        "headline": "Software Engineer",
        "profileUrl": "https://www.linkedin.com/in/janedoe"
      },
      "replies": []
    }
  ],
  "commentsPaginationToken": "MTAtMTcwNjAwMDAwMDAwMA==",
  "commentsHasMore": true,
  "reactions": [
    {
      "reactionType": "LIKE",
      "actor": {
        "urn": "urn:li:fsd_profile:ACoAABBfDXAB9eK9V6vEHbzfQXZ-wcjke_QuT7g",
        "name": "Kevin Piacentini",
        "headline": "Lead Engineer",
        "profileUrl": "https://www.linkedin.com/in/ACoAABBfDXAB9eK9V6vEHbzfQXZ-wcjke_QuT7g",
        "profilePictureUrl": "https://media.licdn.com/dms/image/..."
      }
    }
  ],
  "reactionsHasMore": false
}

{
  "error": "Missing postUrlOrUrn parameter",
  "code": "MISSING_PARAMETER"
}

{
  "error": "Quota exceeded. Upgrade your plan or wait for renewal.",
  "code": "QUOTA_EXHAUSTED"
}

{
  "error": "Unable to find post from url",
  "code": "POST_NOT_FOUND"
}

{
  "error": "This endpoint costs 2 RPS units but your plan allows 1 request(s) per second. Upgrade your plan to use it.",
  "code": "RATE_LIMITED"
}

{
  "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
402 — QUOTA_EXHAUSTED
429 — RATE_LIMITED (also returned when the endpoint’s 2-unit cost exceeds your per-second limit)
500 — INTERNAL_ERROR
503 — SERVICE_UNAVAILABLE

Pagination

The two lists paginate independently:

Comments paginate by token: pass commentPaginationToken from the previous response, and stop when commentsHasMore is false.
Reactions paginate by offset: increment reactionStart by reactionCount, and stop when reactionsHasMore is false.

Every call to /post/engagement bills 2 credits and 2 rate-limit units, so if you only need to deep-paginate one of the two lists, use the dedicated /post/comments or /post/reactions endpoint (1 credit each) instead.

Notes

Billing is all-or-nothing: 2 credits when both lists are returned, 0 credits if the request errors. There is no partial result.

Authorizations

X-API-Key

string

header

required

Query Parameters

postUrlOrUrn

string

required

Professional post URL or URN

commentCount

integer

default:100

Number of comments to fetch (1-100)

commentStart

integer

default:0

Offset of the first item to return. This endpoint pages by offset: advance start by the number of items you received. Keep requesting while hasMore is true; an empty page ends the list.

commentPaginationToken

string

Token for the next page of comments

reactionCount

integer

default:100

Number of reactions to fetch (1-100)

reactionStart

integer

default:0

Offset of the first item to return. This endpoint pages by offset: advance start by the number of items you received. Keep requesting while hasMore is true; an empty page ends the list.

Response

Combined comments and reactions

post

string

The resolved post identifier

comments

object[]

Comments (same shape as GET /post/comments)

commentsPaginationToken

string

Token for the next page of comments (absent when none)

commentsHasMore

boolean

reactions

object[]

Show child attributes

reactionsHasMore

boolean

Getting Started

Core Concepts

Apify Compatibility

Account

Posts

Profile

Company

Get Post Engagement

Endpoint

Authentication

Parameters

Response

Example Request

Example Response

Errors

Notes

Authorizations

Query Parameters

Response

​Endpoint

​Authentication

​Parameters

​Response

​Example Request

​Example Response

​Errors

​Pagination

​Notes

Authorizations

Query Parameters

Response

Endpoint

Authentication

Parameters

Response

Example Request

Example Response

Errors

Pagination

Notes