Skip to main content
POST
/
v1
/
company
/
enrich-linkedin
Company Enrich (LinkedIn)
curl --request POST \
  --url https://api.gtmapis.com/v1/company/enrich-linkedin \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "company_linkedin_url": "<string>"
}
'
{
  "company": {
    "name": "<string>",
    "domain": "<string>",
    "description": "<string>",
    "industry": "<string>",
    "employee_count": 123,
    "employee_range": "<string>",
    "founded_year": 123,
    "company_type": "<string>",
    "hq_city": "<string>",
    "hq_region": "<string>",
    "hq_country": "<string>",
    "linkedin_url": "<string>",
    "website": "<string>",
    "phone": "<string>",
    "technologies": [
      {}
    ]
  },
  "found": true,
  "credits_charged": 123
}

​
Company Enrich (LinkedIn)

Enrich a company record using its LinkedIn company page URL. Returns firmographic data including industry, employee count, headquarters, technologies, and more.

​
Endpoint

POST /v1/company/enrich-linkedin

​
Request

​
company_linkedin_url
string
required
LinkedIn company page URL (e.g., “https://linkedin.com/company/acme”)

​
Example Request

curl -X POST https://api.gtmapis.com/v1/company/enrich-linkedin \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gtm_test_your_key_here" \
  -d '{
    "company_linkedin_url": "https://linkedin.com/company/acme"
  }'

​
Response

​
company
object
Enriched company data
​
found
boolean
Whether the company was found
​
credits_charged
integer
Number of credits charged

​
Success Response

{
  "company": {
    "name": "Acme Inc",
    "domain": "acme.com",
    "description": "Enterprise software for sales teams",
    "industry": "Software",
    "employee_count": 180,
    "employee_range": "51-200",
    "founded_year": 2015,
    "company_type": "Private",
    "hq_city": "San Francisco",
    "hq_region": "California",
    "hq_country": "United States",
    "linkedin_url": "https://linkedin.com/company/acme",
    "website": "https://acme.com",
    "phone": "+14155551000",
    "technologies": ["Salesforce", "AWS", "React"]
  },
  "found": true,
  "credits_charged": 1
}

​
Not Found Response

{
  "company": {},
  "found": false,
  "credits_charged": 0
}

​
Credit Pricing

ResultCredits Charged
Company found1 credit
Not found0 credits
Error / failure0 credits
Credits are only charged when company data is successfully returned. No charge if the lookup returns no results.

​
Error Responses

​
400 Bad Request

{
  "error": "Bad Request",
  "message": "company_linkedin_url is required"
}

​
401 Unauthorized

{
  "error": "Unauthorized",
  "message": "Invalid API key"
}

​
Use Cases

Automatically enrich company records in your CRM with firmographic data from LinkedIn.
Use employee count, industry, and technologies to score inbound leads against your ICP.
Track competitor companies’ growth, technology stack, and hiring patterns.

Company Search

Search companies by firmographic criteria

Domain to LinkedIn

Find company LinkedIn from domain

LinkedIn to Domain

Find company domain from LinkedIn

ICP Search

Find people at a company