curl --request POST \
--url https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-education \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"profile_id": "<string>",
"public_identifier": "<string>",
"ln_member_id": "<string>",
"recruiter_id": "<string>",
"linkedin_account_sid": "<string>",
"idempotency_key": "<string>",
"trust_cache_max_age_days": 1825
}
'import requests
url = "https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-education"
payload = {
"profile_id": "<string>",
"public_identifier": "<string>",
"ln_member_id": "<string>",
"recruiter_id": "<string>",
"linkedin_account_sid": "<string>",
"idempotency_key": "<string>",
"trust_cache_max_age_days": 1825
}
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({
profile_id: '<string>',
public_identifier: '<string>',
ln_member_id: '<string>',
recruiter_id: '<string>',
linkedin_account_sid: '<string>',
idempotency_key: '<string>',
trust_cache_max_age_days: 1825
})
};
fetch('https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-education', 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-enrichment/person-education",
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([
'profile_id' => '<string>',
'public_identifier' => '<string>',
'ln_member_id' => '<string>',
'recruiter_id' => '<string>',
'linkedin_account_sid' => '<string>',
'idempotency_key' => '<string>',
'trust_cache_max_age_days' => 1825
]),
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-enrichment/person-education"
payload := strings.NewReader("{\n \"profile_id\": \"<string>\",\n \"public_identifier\": \"<string>\",\n \"ln_member_id\": \"<string>\",\n \"recruiter_id\": \"<string>\",\n \"linkedin_account_sid\": \"<string>\",\n \"idempotency_key\": \"<string>\",\n \"trust_cache_max_age_days\": 1825\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-enrichment/person-education")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"profile_id\": \"<string>\",\n \"public_identifier\": \"<string>\",\n \"ln_member_id\": \"<string>\",\n \"recruiter_id\": \"<string>\",\n \"linkedin_account_sid\": \"<string>\",\n \"idempotency_key\": \"<string>\",\n \"trust_cache_max_age_days\": 1825\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-education")
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 \"profile_id\": \"<string>\",\n \"public_identifier\": \"<string>\",\n \"ln_member_id\": \"<string>\",\n \"recruiter_id\": \"<string>\",\n \"linkedin_account_sid\": \"<string>\",\n \"idempotency_key\": \"<string>\",\n \"trust_cache_max_age_days\": 1825\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "action",
"action": "<string>",
"item": "<unknown>",
"result": {
"educations": [
{
"school_name": "<string>",
"company_id": "<string>",
"school_public_identifier": "<string>",
"school_logo_url": "<string>",
"degree": "<string>",
"field_of_study": "<string>",
"start_date": "<string>",
"end_date": "<string>",
"description": "<string>"
}
],
"data_request": {}
},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
},
"pacing": {
"linkedin_account_sid": "<string>",
"limit_type": "<string>",
"next_call_after": "<string>",
"remaining_today": 1
}
}Enrich person education
Education history only, every school (the whole Show all educations list): ONE LinkedIn request by profile_id, two by public_identifier (the list takes the id alone, so the slug is resolved first). Each school: name, its page vanity and id, logo, degree and field of study apart, the years, the texts under it. cached 7d under its own method key (a cached full profile does NOT satisfy it). Not paginated.
Contract:
- MCP tool
enrich_linkedin_person_education, registry packagemcp.linkedin/linkedin_enrichment, mountlinkedin.enrichment. - Operation
action, response envelopeaction. - Flags: paced: a call spends the
enrichmentsmart-limit bucket of the account it runs on, and calls of one bucket are spaced per account. A short wait is slept by the server; a longer one answers 429rate_limitedwithcontext.retry_after, and the same call succeeds from that moment. Parallel calls on one account queue behind each other.
curl --request POST \
--url https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-education \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"profile_id": "<string>",
"public_identifier": "<string>",
"ln_member_id": "<string>",
"recruiter_id": "<string>",
"linkedin_account_sid": "<string>",
"idempotency_key": "<string>",
"trust_cache_max_age_days": 1825
}
'import requests
url = "https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-education"
payload = {
"profile_id": "<string>",
"public_identifier": "<string>",
"ln_member_id": "<string>",
"recruiter_id": "<string>",
"linkedin_account_sid": "<string>",
"idempotency_key": "<string>",
"trust_cache_max_age_days": 1825
}
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({
profile_id: '<string>',
public_identifier: '<string>',
ln_member_id: '<string>',
recruiter_id: '<string>',
linkedin_account_sid: '<string>',
idempotency_key: '<string>',
trust_cache_max_age_days: 1825
})
};
fetch('https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-education', 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-enrichment/person-education",
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([
'profile_id' => '<string>',
'public_identifier' => '<string>',
'ln_member_id' => '<string>',
'recruiter_id' => '<string>',
'linkedin_account_sid' => '<string>',
'idempotency_key' => '<string>',
'trust_cache_max_age_days' => 1825
]),
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-enrichment/person-education"
payload := strings.NewReader("{\n \"profile_id\": \"<string>\",\n \"public_identifier\": \"<string>\",\n \"ln_member_id\": \"<string>\",\n \"recruiter_id\": \"<string>\",\n \"linkedin_account_sid\": \"<string>\",\n \"idempotency_key\": \"<string>\",\n \"trust_cache_max_age_days\": 1825\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-enrichment/person-education")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"profile_id\": \"<string>\",\n \"public_identifier\": \"<string>\",\n \"ln_member_id\": \"<string>\",\n \"recruiter_id\": \"<string>\",\n \"linkedin_account_sid\": \"<string>\",\n \"idempotency_key\": \"<string>\",\n \"trust_cache_max_age_days\": 1825\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-education")
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 \"profile_id\": \"<string>\",\n \"public_identifier\": \"<string>\",\n \"ln_member_id\": \"<string>\",\n \"recruiter_id\": \"<string>\",\n \"linkedin_account_sid\": \"<string>\",\n \"idempotency_key\": \"<string>\",\n \"trust_cache_max_age_days\": 1825\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "action",
"action": "<string>",
"item": "<unknown>",
"result": {
"educations": [
{
"school_name": "<string>",
"company_id": "<string>",
"school_public_identifier": "<string>",
"school_logo_url": "<string>",
"degree": "<string>",
"field_of_study": "<string>",
"start_date": "<string>",
"end_date": "<string>",
"description": "<string>"
}
],
"data_request": {}
},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
},
"pacing": {
"linkedin_account_sid": "<string>",
"limit_type": "<string>",
"next_call_after": "<string>",
"remaining_today": 1
}
}Authorizations
Body
Request body of enrich_linkedin_person_education.
The person by any identifier, read by its shape: a profile URN (ACoAA…), a Sales Navigator id (ACwAA…), a Recruiter id (AEMAA…), urn:li:fsd_profile:…, urn:li:member:, a vanity slug or any profile link. Provide exactly one of profile_id / public_identifier / ln_member_id / recruiter_id.
2048The same field under the slug's name: a vanity slug from /in/…, the whole profile link (any linkedin.com host, a Sales Navigator lead link too) or a URN; read by its shape, so a URN here and a slug in profile_id both work, and a link and its slug share one ledger entry. A value that names no member (a company page, a feed link) is 422 public_identifier_not_resolvable. Whatever key the method's wire takes is found for you: from your team's own history or the stored corpus for free, else by ONE extra LinkedIn request, and the receipt says which (data_request.target_resolved_via: "ledger" | "corpus" | "browser", null when nothing had to be resolved). A slug LinkedIn does not know is 422 public_identifier_unresolved.
2048Executor account (ln_ac_...). Given: the call runs on that account ONLY; a saturated or held enrichment bucket refuses 429 bucket_saturated (with retry_after). Omitted: the service auto-picks one of your connected accounts with remaining capacity (422 no_connected_accounts when none is ready, 429 when all are at capacity).
18^ln_ac_Replay guard (team_sid, idempotency_key). A repeat with the same key returns the stored ledger outcome without running again, except a failure that answered with retry_after: once that time has passed, a repeat under the same key runs again. A target named by another key than the one the wire takes spends at most ONE resolve read, journaled under this key plus ":resolve" (sha256:<64 hex>:resolve past 120 characters), which a repeat replays; a stored read of another target never answers. While that read runs, a repeat is 429 target_resolve_in_progress (retry_after). A refusal after it names it (error.context.data_request_sid, target_resolved_via "browser").
128Accept a stored payload this many days old instead of fetching (probe tier 2, §9.5): a hit answers with served_from_cache / cache_source "data_cluster", spending no browser run and no bucket slot. Omitted, the stored payload is never consulted and the call always dispatches.
1 <= x <= 3650Response
action success envelope.