Documentation

API Reference

Use Company Data Guys to fetch live or recently stored LinkedIn company data.

Company Data Guys exposes one production API endpoint for LinkedIn company enrichment:

POST https://companydataguys.com/v1/linkedin/company-data

Send one or more LinkedIn company, showcase, or school URLs and receive normalized company records in a JSON response.

Quick start

curl -X POST "https://companydataguys.com/v1/linkedin/company-data" \
  -H "Authorization: Bearer lcda_live_your_api_key" \
  -H "Content-Type: application/json" \
  --data '{
    "liUrls": ["https://www.linkedin.com/company/apple/"],
    "maxAgeHours": 0
  }'

Endpoint behavior

  • maxAgeHours: 0 is the default and asks for a live refresh.
  • Stored results can be used when you pass a non-zero freshness window.
  • The API normalizes LinkedIn company, showcase, and school page URLs before lookup.
  • A request may include up to 200 URLs.
  • Responses are returned in the same order as the successfully resolved URLs.

Authentication

Use your dashboard API key with any one of these headers:

Authorization: Bearer lcda_live_your_api_key
x-api-key: lcda_live_your_api_key
api-key: lcda_live_your_api_key
x-company-data-api-key: lcda_live_your_api_key

API keys are created in the Company Data Guys dashboard and are shown in full only once after creation. The dashboard stores only the prefix, suffix, and hashed secret after that.