Scrape service-provider search

curl --request POST \
  --url https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/search-service-providers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Team-SID: <api-key>' \
  --data '
{
  "linkedin_account_sid": "<string>",
  "idempotency_key": "<string>",
  "url": "<string>",
  "filters": {
    "keywords": "<string>",
    "service_categories": [
      "<string>"
    ],
    "locations": [
      "<string>"
    ],
    "network": [],
    "profile_languages": [
      "<string>"
    ]
  },
  "page": 50
}
'

import requests

url = "https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/search-service-providers"

payload = {
    "linkedin_account_sid": "<string>",
    "idempotency_key": "<string>",
    "url": "<string>",
    "filters": {
        "keywords": "<string>",
        "service_categories": ["<string>"],
        "locations": ["<string>"],
        "network": [],
        "profile_languages": ["<string>"]
    },
    "page": 50
}
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>',
    url: '<string>',
    filters: {
      keywords: '<string>',
      service_categories: ['<string>'],
      locations: ['<string>'],
      network: [],
      profile_languages: ['<string>']
    },
    page: 50
  })
};

fetch('https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/search-service-providers', 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/search-service-providers",
  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>',
    'url' => '<string>',
    'filters' => [
        'keywords' => '<string>',
        'service_categories' => [
                '<string>'
        ],
        'locations' => [
                '<string>'
        ],
        'network' => [
                
        ],
        'profile_languages' => [
                '<string>'
        ]
    ],
    'page' => 50
  ]),
  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/search-service-providers"

	payload := strings.NewReader("{\n  \"linkedin_account_sid\": \"<string>\",\n  \"idempotency_key\": \"<string>\",\n  \"url\": \"<string>\",\n  \"filters\": {\n    \"keywords\": \"<string>\",\n    \"service_categories\": [\n      \"<string>\"\n    ],\n    \"locations\": [\n      \"<string>\"\n    ],\n    \"network\": [],\n    \"profile_languages\": [\n      \"<string>\"\n    ]\n  },\n  \"page\": 50\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/search-service-providers")
  .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  \"url\": \"<string>\",\n  \"filters\": {\n    \"keywords\": \"<string>\",\n    \"service_categories\": [\n      \"<string>\"\n    ],\n    \"locations\": [\n      \"<string>\"\n    ],\n    \"network\": [],\n    \"profile_languages\": [\n      \"<string>\"\n    ]\n  },\n  \"page\": 50\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/search-service-providers")

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  \"url\": \"<string>\",\n  \"filters\": {\n    \"keywords\": \"<string>\",\n    \"service_categories\": [\n      \"<string>\"\n    ],\n    \"locations\": [\n      \"<string>\"\n    ],\n    \"network\": [],\n    \"profile_languages\": [\n      \"<string>\"\n    ]\n  },\n  \"page\": 50\n}"

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

{
  "success": true,
  "operation": "action",
  "action": "<string>",
  "item": "<unknown>",
  "result": {
    "rows": [
      {
        "ln_member_id": "<string>",
        "ln_id": "<string>",
        "sn_id": "<string>",
        "nickname": "<string>",
        "full_name": "<string>",
        "headline": "<string>",
        "position": "<string>",
        "company_name": "<string>",
        "location": "<string>",
        "avatar_url": "<string>",
        "connection_degree": "<string>"
      }
    ],
    "paging": {
      "page": 123,
      "page_size": 123,
      "has_more": true,
      "total": 123
    },
    "data_request": {}
  },
  "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>"
  }
}

{
  "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 service-provider search

One page of LinkedIn’s service-provider marketplace (freelancers and agencies), addressed EITHER by filters (keywords, LinkedIn’s own numeric service-category and geo ids, connection degree, profile language) OR by a pasted /search/results/services/ url, which is how to reach anything those five cannot express: exactly one of the two. Rows are the same person previews the people search returns, because the services screen carries no ratings and no service labels in its results, only provider profiles.

Contract:

MCP tool scrape_linkedin_search_service_providers, registry package mcp.linkedin/linkedin_scraping, mount linkedin.scraping.
Operation action, response envelope action.
Flags: none.

POST

api

linkedin-scraping

search-service-providers

Scrape service-provider search

curl --request POST \
  --url https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/search-service-providers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Team-SID: <api-key>' \
  --data '
{
  "linkedin_account_sid": "<string>",
  "idempotency_key": "<string>",
  "url": "<string>",
  "filters": {
    "keywords": "<string>",
    "service_categories": [
      "<string>"
    ],
    "locations": [
      "<string>"
    ],
    "network": [],
    "profile_languages": [
      "<string>"
    ]
  },
  "page": 50
}
'

import requests

url = "https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/search-service-providers"

payload = {
    "linkedin_account_sid": "<string>",
    "idempotency_key": "<string>",
    "url": "<string>",
    "filters": {
        "keywords": "<string>",
        "service_categories": ["<string>"],
        "locations": ["<string>"],
        "network": [],
        "profile_languages": ["<string>"]
    },
    "page": 50
}
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>',
    url: '<string>',
    filters: {
      keywords: '<string>',
      service_categories: ['<string>'],
      locations: ['<string>'],
      network: [],
      profile_languages: ['<string>']
    },
    page: 50
  })
};

fetch('https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/search-service-providers', 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/search-service-providers",
  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>',
    'url' => '<string>',
    'filters' => [
        'keywords' => '<string>',
        'service_categories' => [
                '<string>'
        ],
        'locations' => [
                '<string>'
        ],
        'network' => [
                
        ],
        'profile_languages' => [
                '<string>'
        ]
    ],
    'page' => 50
  ]),
  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/search-service-providers"

	payload := strings.NewReader("{\n  \"linkedin_account_sid\": \"<string>\",\n  \"idempotency_key\": \"<string>\",\n  \"url\": \"<string>\",\n  \"filters\": {\n    \"keywords\": \"<string>\",\n    \"service_categories\": [\n      \"<string>\"\n    ],\n    \"locations\": [\n      \"<string>\"\n    ],\n    \"network\": [],\n    \"profile_languages\": [\n      \"<string>\"\n    ]\n  },\n  \"page\": 50\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/search-service-providers")
  .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  \"url\": \"<string>\",\n  \"filters\": {\n    \"keywords\": \"<string>\",\n    \"service_categories\": [\n      \"<string>\"\n    ],\n    \"locations\": [\n      \"<string>\"\n    ],\n    \"network\": [],\n    \"profile_languages\": [\n      \"<string>\"\n    ]\n  },\n  \"page\": 50\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.gtm-api.com/linkedin/v4/api/linkedin-scraping/search-service-providers")

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  \"url\": \"<string>\",\n  \"filters\": {\n    \"keywords\": \"<string>\",\n    \"service_categories\": [\n      \"<string>\"\n    ],\n    \"locations\": [\n      \"<string>\"\n    ],\n    \"network\": [],\n    \"profile_languages\": [\n      \"<string>\"\n    ]\n  },\n  \"page\": 50\n}"

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

{
  "success": true,
  "operation": "action",
  "action": "<string>",
  "item": "<unknown>",
  "result": {
    "rows": [
      {
        "ln_member_id": "<string>",
        "ln_id": "<string>",
        "sn_id": "<string>",
        "nickname": "<string>",
        "full_name": "<string>",
        "headline": "<string>",
        "position": "<string>",
        "company_name": "<string>",
        "location": "<string>",
        "avatar_url": "<string>",
        "connection_degree": "<string>"
      }
    ],
    "paging": {
      "page": 123,
      "page_size": 123,
      "has_more": true,
      "total": 123
    },
    "data_request": {}
  },
  "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>"
  }
}

{
  "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_search_service_providers.

linkedin_account_sid

string | null

Executor account (ln_ac_...). OPTIONAL everywhere on this surface. Given: the call runs on that account ONLY; a saturated or held scraping bucket refuses 429 bucket_saturated (with retry_after). Omitted: the service auto-picks one of your connected accounts with remaining capacity (SN verbs pick only Sales-Navigator seats; 422 no_connected_accounts when none is ready, 429 when all are at capacity).

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. Recommended on every search run. The KEY ALONE decides: the probe does not compare arguments, so reusing one key after changing the arguments hands back the FIRST result. On the twelve search verbs that matters twice over, because switching a call from filters to url (or back) under one key replays instead of running the new search. New search, new key.

Maximum string length: 128

url

string | null

EXCLUSIVE with filters: send url OR filters, never both (422) and never neither (422). A search URL built in the LinkedIn UI, and the escape hatch for everything the filter vocabulary cannot express. MUST start with https://www.linkedin.com/search/results/services/ : a URL from another LinkedIn search screen is refused here and again by the backend (422 invalid_search_url), because running it would silently scrape the wrong thing.

Maximum string length: 2048

Pattern: ^https:\/\/www\.linkedin\.com\/search\/results\/services\/

filters

object | null

EXCLUSIVE with url: send filters OR url, never both (422) and never neither (422). Service-provider marketplace filters. At least one member must be non-empty. Anything these five cannot express is reachable by pasting the UI URL into this tool's own url field instead.

Show child attributes

page

integer

LinkedIn page number, default 1; ONE page per call, so re-call with page + 1 while paging.has_more.

Required range: 1 <= x <= 100

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 service-provider search

Authorizations

Body

Response