Documentation

API Reference

Endpoint, examples, limits, errors, and OpenAPI import.

POSThttps://companydataguys.com/v1/linkedin/company-data
Per request
Up to 200 URLs
Body
< 100 KB JSON
Live
1 credit / company
Cached
0.5 credits / company
Timeout
25s

For more details on how credits and billing work, see the credits/billing documentation.

Import OpenAPI

Use the spec URL in Postman, Insomnia, Bruno, or generated clients. It includes auth, limits, fields, and errors.

JSONPostmanInsomnia

Authentication

Create a key in the dashboard. The full secret is shown once; after that only the prefix, suffix, and hash are stored.

Authorization: Bearer <key>

Quickstart

Set maxAgeHours: 0 for fresh data.

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}'

Run it from the docs

200 OKPOST /v1/linkedin/company-data
{
"message": "Success"
"status_code": 200
"results": [
"0": {
"company_name": "Apple"
"domain": "apple.com"
"final_li_url": "https://www.linkedin.com/company/apple/"
"original_li_url": "https://www.linkedin.com/company/apple/"
"company_id": 162479
"company_size": "10,001+ employees"
"employee_count_on_li": 181922
"follower_count": 18213841
"industries": "Computers and Electronics Manufacturing"
"type": "Public Company"
"founded": 1976
"website": "https://www.apple.com/careers"
"logo": "https://media.licdn.com/..."
"headquarters": {
"fullAddress": "1 Apple Park Way, Cupertino, California, 95014, US"
"street": "1 Apple Park Way"
"locality": "Cupertino"
"region": "California"
"postalCode": "95014"
"country": "US"
}
"funding_info": {
"number_of_funding_rounds": 9
"last_round": {
"type": "Post IPO debt"
"date": "Jun 5, 2025"
"money_raised": "$ 4.5B"
"money_raised_usd": 4500000000
"money_raised_usd_qualifier": "exact"
}
}
"products": [
"0": {
"name": "iPhone"
"description": "Smartphone"
}
]
"similar_pages": [
]
"affiliated_pages": [
]
}
]
}

Batch up to 200 URLs

URLs run concurrently, but the response waits for the slowest live lookup. Split large live jobs when latency matters.

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/","https://www.linkedin.com/company/microsoft/"],"maxAgeHours":24}'

Request body

Only liUrls is required. If both maxAgeSeconds and maxAgeHours are sent, maxAgeSeconds wins.

FieldTypeLimitNotes
liUrlsstring[]1-200LinkedIn company, school, or showcase URLs.
maxAgeHoursnumber0-240 forces a live refresh. Non-zero allows stored snapshots.
maxAgeSecondsnumber0-86400Use for an exact freshness window.

Freshness, credits, and caching

Successful live results are timestamped so later requests can reuse fresh snapshots.

Live

maxAgeHours: 0 always refetches, stores the snapshot, and bills 1 credit per returned company.

Cached

maxAgeHours > 0 may return a stored snapshot inside the window and bills 0.5 credits per returned company.

Response fields

Missing values are omitted. JSON never contains JavaScript undefined.

Identity

company_name
Company display name.
company_id
LinkedIn organization id when available.
final_li_url
Normalized or redirected company URL.
original_li_url
The URL submitted in the request.
domain
Normalized website domain.
website
Website URL from the company page.
logo
Company logo URL.
banner_img
Company banner image URL.

Company profile

description
Company description.
slogan
Short tagline when present.
industries
Primary LinkedIn industry text.
type
Company type, for example Public Company.
founded
Founding year.
company_size
LinkedIn employee-size bucket.
employee_count_on_li
LinkedIn employee count.
follower_count
LinkedIn follower count.
job_count
Open LinkedIn job count when visible.
specialties
Array of specialties listed on the page.

Location and relationships

headquarters
Primary headquarters address object.
locations
Array of visible office locations.
funding_info
Funding rounds, investors, dates, and USD estimates.
products
Products listed on the company page.
updates
Recent social posts when visible.
similar_pages
Similar company pages.
affiliated_pages
Subsidiaries, acquired companies, and related pages.
employees_on_li
Small visible sample of LinkedIn employee profiles.

Errors

Errors return code, message, and status_code with a concrete fix.

401
missing_api_key
Send Authorization: Bearer <api_key>.
401
invalid_api_key
Create a new key in the dashboard or check the copied value.
400
too_many_urls
Send 200 or fewer URLs per request.
413
request_body_too_large
Keep the JSON body under 100 KB.
504
upstream_timeout
Retry with fewer URLs or set maxAgeHours to allow stored results.