Scrape post comment threads (not shipped)

curl --request POST \
  --url https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/get-post-comments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Team-SID: <api-key>' \
  --data '
{
  "linkedin_account_sid": "<string>",
  "idempotency_key": "<string>",
  "linkedin_tracked_post_sid": "<string>",
  "post": "<string>",
  "page_size": 50,
  "cursor": "<string>"
}
'

import requests

url = "https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/get-post-comments"

payload = {
    "linkedin_account_sid": "<string>",
    "idempotency_key": "<string>",
    "linkedin_tracked_post_sid": "<string>",
    "post": "<string>",
    "page_size": 50,
    "cursor": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Team-SID": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Team-SID': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    linkedin_account_sid: '<string>',
    idempotency_key: '<string>',
    linkedin_tracked_post_sid: '<string>',
    post: '<string>',
    page_size: 50,
    cursor: '<string>'
  })
};

fetch('https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/get-post-comments', 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://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/get-post-comments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'linkedin_account_sid' => '<string>',
    'idempotency_key' => '<string>',
    'linkedin_tracked_post_sid' => '<string>',
    'post' => '<string>',
    'page_size' => 50,
    'cursor' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Team-SID: <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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/get-post-comments"

	payload := strings.NewReader("{\n  \"linkedin_account_sid\": \"<string>\",\n  \"idempotency_key\": \"<string>\",\n  \"linkedin_tracked_post_sid\": \"<string>\",\n  \"post\": \"<string>\",\n  \"page_size\": 50,\n  \"cursor\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Team-SID", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/get-post-comments")
  .header("Authorization", "Bearer <token>")
  .header("Team-SID", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"linkedin_account_sid\": \"<string>\",\n  \"idempotency_key\": \"<string>\",\n  \"linkedin_tracked_post_sid\": \"<string>\",\n  \"post\": \"<string>\",\n  \"page_size\": 50,\n  \"cursor\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/get-post-comments")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Team-SID"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"linkedin_account_sid\": \"<string>\",\n  \"idempotency_key\": \"<string>\",\n  \"linkedin_tracked_post_sid\": \"<string>\",\n  \"post\": \"<string>\",\n  \"page_size\": 50,\n  \"cursor\": \"<string>\"\n}"

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

{
  "success": true,
  "operation": "action",
  "action": "<string>",
  "item": "<unknown>",
  "result": {
    "rows": [
      {
        "commenter_ln_member_id": "<string>",
        "commenter_ln_id": "<string>",
        "commenter_nickname": "<string>",
        "commenter_full_name": "<string>",
        "commenter_headline": "<string>",
        "commenter_picture_url": "<string>",
        "comment_ln_id": "<string>",
        "content": "<string>",
        "posted_at": "<string>",
        "reactions_count": 123,
        "is_own": true,
        "is_stored": true,
        "linkedin_comment_sid": "<string>",
        "parent_comment_ln_id": "<string>",
        "replies_count": 123
      }
    ],
    "paging": {
      "page_size": 123,
      "next_cursor": "<string>",
      "has_more": true,
      "total": 123
    },
    "data_request": {},
    "post": {
      "post_ln_id": "<string>",
      "is_tracked": true,
      "linkedin_tracked_post_sid": "<string>"
    }
  },
  "meta": {
    "trace_id": "<string>",
    "span_id": "<string>",
    "timestamp": "<string>",
    "duration_ms": 1,
    "debug_url": "<string>"
  },
  "credits": {
    "charged": 1,
    "balance_after": 1
  }
}

{
  "success": false,
  "error": {
    "message": "<string>",
    "recoverable": true,
    "suggestion": "<string>",
    "field_errors": {},
    "blockers": [
      {
        "type": "<string>",
        "description": "<string>",
        "entity_sid": "<string>",
        "resolution": "<string>",
        "resolution_hint": "<string>",
        "count": 123
      }
    ],
    "context": {}
  },
  "meta": {
    "trace_id": "<string>",
    "span_id": "<string>",
    "timestamp": "<string>",
    "duration_ms": 1,
    "debug_url": "<string>"
  }
}

{
  "success": false,
  "error": {
    "message": "<string>",
    "recoverable": true,
    "suggestion": "<string>",
    "field_errors": {},
    "blockers": [
      {
        "type": "<string>",
        "description": "<string>",
        "entity_sid": "<string>",
        "resolution": "<string>",
        "resolution_hint": "<string>",
        "count": 123
      }
    ],
    "context": {}
  },
  "meta": {
    "trace_id": "<string>",
    "span_id": "<string>",
    "timestamp": "<string>",
    "duration_ms": 1,
    "debug_url": "<string>"
  }
}

linkedin_scraping

Scrape post comment threads (not shipped)

deprecated

⛔ NOT SHIPPED YET. The contract is locked and validated now but the plugin verb is not built. Every valid, allowed call returns 501 not_implemented (context.reason=blocked_on_plugin) with no ledger row and no credit spend; do not retry. Full comment THREADS of one post: top-level comments AND their replies as a flat list with parent pointers (parent_comment_ln_id; LinkedIn nests one level). Distinct from get-post-commenters (which returns the PEOPLE for qualification): this returns the CONVERSATION for content analysis (unanswered questions, objection mining). Same targeting and annotations. Cost 2 credits.

Not shipped yet. The registry marks this route availability=stub_501: the backend validates the whole request and then answers 501 not_implemented. The request contract is final, so integrations can be written and tested against it today. Marked deprecated so generated clients flag it at compile time; this is a NOT-YET flag, not a sunset.

Contract:

MCP tool scrape_linkedin_get_post_comments, registry package mcp.linkedin/linkedin_scraping, mount linkedin.scraping.
Operation action, response envelope action.
Flags: creditable: the response carries a credits block and the call can debit the team ledger.

POST

api

linkedin-scraping

get-post-comments

Scrape post comment threads (not shipped)

curl --request POST \
  --url https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/get-post-comments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Team-SID: <api-key>' \
  --data '
{
  "linkedin_account_sid": "<string>",
  "idempotency_key": "<string>",
  "linkedin_tracked_post_sid": "<string>",
  "post": "<string>",
  "page_size": 50,
  "cursor": "<string>"
}
'

import requests

url = "https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/get-post-comments"

payload = {
    "linkedin_account_sid": "<string>",
    "idempotency_key": "<string>",
    "linkedin_tracked_post_sid": "<string>",
    "post": "<string>",
    "page_size": 50,
    "cursor": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Team-SID": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Team-SID': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    linkedin_account_sid: '<string>',
    idempotency_key: '<string>',
    linkedin_tracked_post_sid: '<string>',
    post: '<string>',
    page_size: 50,
    cursor: '<string>'
  })
};

fetch('https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/get-post-comments', 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://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/get-post-comments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'linkedin_account_sid' => '<string>',
    'idempotency_key' => '<string>',
    'linkedin_tracked_post_sid' => '<string>',
    'post' => '<string>',
    'page_size' => 50,
    'cursor' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Team-SID: <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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/get-post-comments"

	payload := strings.NewReader("{\n  \"linkedin_account_sid\": \"<string>\",\n  \"idempotency_key\": \"<string>\",\n  \"linkedin_tracked_post_sid\": \"<string>\",\n  \"post\": \"<string>\",\n  \"page_size\": 50,\n  \"cursor\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Team-SID", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/get-post-comments")
  .header("Authorization", "Bearer <token>")
  .header("Team-SID", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"linkedin_account_sid\": \"<string>\",\n  \"idempotency_key\": \"<string>\",\n  \"linkedin_tracked_post_sid\": \"<string>\",\n  \"post\": \"<string>\",\n  \"page_size\": 50,\n  \"cursor\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/get-post-comments")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Team-SID"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"linkedin_account_sid\": \"<string>\",\n  \"idempotency_key\": \"<string>\",\n  \"linkedin_tracked_post_sid\": \"<string>\",\n  \"post\": \"<string>\",\n  \"page_size\": 50,\n  \"cursor\": \"<string>\"\n}"

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

{
  "success": true,
  "operation": "action",
  "action": "<string>",
  "item": "<unknown>",
  "result": {
    "rows": [
      {
        "commenter_ln_member_id": "<string>",
        "commenter_ln_id": "<string>",
        "commenter_nickname": "<string>",
        "commenter_full_name": "<string>",
        "commenter_headline": "<string>",
        "commenter_picture_url": "<string>",
        "comment_ln_id": "<string>",
        "content": "<string>",
        "posted_at": "<string>",
        "reactions_count": 123,
        "is_own": true,
        "is_stored": true,
        "linkedin_comment_sid": "<string>",
        "parent_comment_ln_id": "<string>",
        "replies_count": 123
      }
    ],
    "paging": {
      "page_size": 123,
      "next_cursor": "<string>",
      "has_more": true,
      "total": 123
    },
    "data_request": {},
    "post": {
      "post_ln_id": "<string>",
      "is_tracked": true,
      "linkedin_tracked_post_sid": "<string>"
    }
  },
  "meta": {
    "trace_id": "<string>",
    "span_id": "<string>",
    "timestamp": "<string>",
    "duration_ms": 1,
    "debug_url": "<string>"
  },
  "credits": {
    "charged": 1,
    "balance_after": 1
  }
}

{
  "success": false,
  "error": {
    "message": "<string>",
    "recoverable": true,
    "suggestion": "<string>",
    "field_errors": {},
    "blockers": [
      {
        "type": "<string>",
        "description": "<string>",
        "entity_sid": "<string>",
        "resolution": "<string>",
        "resolution_hint": "<string>",
        "count": 123
      }
    ],
    "context": {}
  },
  "meta": {
    "trace_id": "<string>",
    "span_id": "<string>",
    "timestamp": "<string>",
    "duration_ms": 1,
    "debug_url": "<string>"
  }
}

{
  "success": false,
  "error": {
    "message": "<string>",
    "recoverable": true,
    "suggestion": "<string>",
    "field_errors": {},
    "blockers": [
      {
        "type": "<string>",
        "description": "<string>",
        "entity_sid": "<string>",
        "resolution": "<string>",
        "resolution_hint": "<string>",
        "count": 123
      }
    ],
    "context": {}
  },
  "meta": {
    "trace_id": "<string>",
    "span_id": "<string>",
    "timestamp": "<string>",
    "duration_ms": 1,
    "debug_url": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Access token issued by gtm.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.

Team-SID

string

header

required

Team scope for tokens that do not carry one. Ignored when the token already names a team.

Body

application/json

Request body of scrape_linkedin_get_post_comments.

linkedin_account_sid

string | null

Preferred executor account (ln_ac_…). OPTIONAL everywhere on this surface: omitted → platform pool + credits (reason infra_pool); given with scraping-bucket budget → own account, charged 0; given but the bucket is saturated/held → automatic pool fallback (reason limit_fallback), never a 429 (§9.5).

Required string length: 18

Pattern: ^ln_ac_

idempotency_key

string | null

Ledger replay guard: a repeat call with the same (team, key) returns the stored outcome; no re-execution, no double charge. Recommended on every paid call.

Maximum string length: 128

linkedin_tracked_post_sid

string | null

Exactly one of linkedin_tracked_post_sid / post.

Required string length: 18

Pattern: ^ln_tp_

post

string | null

Post URL OR activity URN, auto-detected; a URL is resolved via get_activity_urn_by_url. Exactly one of linkedin_tracked_post_sid / post.

Maximum string length: 512

page_size

integer

Default 50 thread nodes per page (top-level + replies).

Required range: 1 <= x <= 100

cursor

string | null

Opaque resume token; null = first page.

Response

action success envelope.

success

enum<boolean>

required

Available options:

true

operation

enum<string>

required

Available options:

action

action

string

required

kebab-case verb; matches the route segment.

item

any

required

result

object

required

Show child attributes

Overview

LinkedIn API

ID and Teams API

Orchestration API

Scrape post comment threads (not shipped)

Authorizations

Body

Response