curl --request POST \
--url https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/company-lite-profile \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"company_url": "<string>",
"domain": "<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/company-lite-profile"
payload = {
"company_url": "<string>",
"domain": "<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({
company_url: '<string>',
domain: '<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/company-lite-profile', 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/company-lite-profile",
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([
'company_url' => '<string>',
'domain' => '<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/company-lite-profile"
payload := strings.NewReader("{\n \"company_url\": \"<string>\",\n \"domain\": \"<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/company-lite-profile")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"company_url\": \"<string>\",\n \"domain\": \"<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/company-lite-profile")
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 \"company_url\": \"<string>\",\n \"domain\": \"<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": {
"company": {
"id": "<string>",
"urn": "<string>",
"public_identifier": "<string>",
"name": "<string>",
"localized": [
{
"locale": "<string>",
"name": "<string>",
"tagline": "<string>",
"description": "<string>"
}
],
"tagline": "<string>",
"description": "<string>",
"company_url": "<string>",
"website_url": "<string>",
"phone": "<string>",
"founded_on": {
"year": 123,
"month": 123,
"day": 123
},
"employee_count": 123,
"employee_count_range": {
"start": 123,
"end": 123
},
"industry_ids": [
"<string>"
],
"specialities": [
"<string>"
],
"hashtags": [
"<string>"
],
"organization_type": {
"code": "<string>",
"name": "<string>"
},
"page_type": "<string>",
"page_verified": true,
"page_verified_at": "<string>",
"active": true,
"archived": true,
"auto_generated": true,
"claimable": true,
"category_page": true,
"created_at": "<string>",
"default_locale": "<string>",
"announcement": "<string>",
"call_to_action": {
"text": "<string>",
"url": "<string>",
"type": "<string>",
"visible": true
},
"job_search_url": "<string>",
"headquarter": {
"description": "<string>",
"address": {
"country": "<string>",
"geographic_area": "<string>",
"city": "<string>",
"postal_code": "<string>",
"line1": "<string>",
"line2": "<string>"
},
"is_headquarter": true
},
"locations": [
{
"name": "<string>",
"latitude": 123,
"longitude": 123,
"locations": [
{
"description": "<string>",
"address": {
"country": "<string>",
"geographic_area": "<string>",
"city": "<string>",
"postal_code": "<string>",
"line1": "<string>",
"line2": "<string>"
},
"is_headquarter": true
}
]
}
],
"parent_company": {
"id": "<string>",
"urn": "<string>"
},
"competitors": [
{
"id": "<string>",
"urn": "<string>",
"suggested": true
}
],
"newsletter_urn": "<string>",
"group_urns": [
"<string>"
],
"credibility_highlights": [
{
"text": "<string>",
"featured": true,
"logo_url": "<string>"
}
],
"logo_url": "<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 company lite profile
The cheap company read: ONE LinkedIn request by the vanity URL or a numeric-id URL alike (the page’s own record), and every fact it states: id, vanity, name in every locale, tagline, about, website, phone, founding date, exact headcount and size range, industry ids, specialities, hashtags, organization and page type, the verified mark, headquarters and every location with coordinates, parent company, listed competitors, call to action and credibility highlights. The industry NAME and the follower count are enrich_linkedin_company_profile’s (two or three requests). cached 7d.
Contract:
- MCP tool
enrich_linkedin_company_lite_profile, 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/company-lite-profile \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"company_url": "<string>",
"domain": "<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/company-lite-profile"
payload = {
"company_url": "<string>",
"domain": "<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({
company_url: '<string>',
domain: '<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/company-lite-profile', 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/company-lite-profile",
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([
'company_url' => '<string>',
'domain' => '<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/company-lite-profile"
payload := strings.NewReader("{\n \"company_url\": \"<string>\",\n \"domain\": \"<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/company-lite-profile")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"company_url\": \"<string>\",\n \"domain\": \"<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/company-lite-profile")
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 \"company_url\": \"<string>\",\n \"domain\": \"<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": {
"company": {
"id": "<string>",
"urn": "<string>",
"public_identifier": "<string>",
"name": "<string>",
"localized": [
{
"locale": "<string>",
"name": "<string>",
"tagline": "<string>",
"description": "<string>"
}
],
"tagline": "<string>",
"description": "<string>",
"company_url": "<string>",
"website_url": "<string>",
"phone": "<string>",
"founded_on": {
"year": 123,
"month": 123,
"day": 123
},
"employee_count": 123,
"employee_count_range": {
"start": 123,
"end": 123
},
"industry_ids": [
"<string>"
],
"specialities": [
"<string>"
],
"hashtags": [
"<string>"
],
"organization_type": {
"code": "<string>",
"name": "<string>"
},
"page_type": "<string>",
"page_verified": true,
"page_verified_at": "<string>",
"active": true,
"archived": true,
"auto_generated": true,
"claimable": true,
"category_page": true,
"created_at": "<string>",
"default_locale": "<string>",
"announcement": "<string>",
"call_to_action": {
"text": "<string>",
"url": "<string>",
"type": "<string>",
"visible": true
},
"job_search_url": "<string>",
"headquarter": {
"description": "<string>",
"address": {
"country": "<string>",
"geographic_area": "<string>",
"city": "<string>",
"postal_code": "<string>",
"line1": "<string>",
"line2": "<string>"
},
"is_headquarter": true
},
"locations": [
{
"name": "<string>",
"latitude": 123,
"longitude": 123,
"locations": [
{
"description": "<string>",
"address": {
"country": "<string>",
"geographic_area": "<string>",
"city": "<string>",
"postal_code": "<string>",
"line1": "<string>",
"line2": "<string>"
},
"is_headquarter": true
}
]
}
],
"parent_company": {
"id": "<string>",
"urn": "<string>"
},
"competitors": [
{
"id": "<string>",
"urn": "<string>",
"suggested": true
}
],
"newsletter_urn": "<string>",
"group_urns": [
"<string>"
],
"credibility_highlights": [
{
"text": "<string>",
"featured": true,
"logo_url": "<string>"
}
],
"logo_url": "<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_company_lite_profile.
The company in any form: its page link (any linkedin.com host), the bare slug, the numeric id, a /company// or Sales Navigator company link, or a company urn (urn:li:fsd_company:). A run of digits is the id wherever it stands. Provide company_url XOR domain.
2048The company website instead of its LinkedIn URL (acme.com, www.acme.com and https://acme.com/pricing all fold to the same host): resolved to a LinkedIn identity through the stored corpus, so a miss is refused company_not_resolvable rather than searched for live. This is the way to turn a domain you already have into the company profile. Provide domain XOR company_url.
191Executor 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.