Request and Response

Request body, validation rules, and response shape for the LinkedIn company data endpoint.

Request body

{
  "liUrls": [
    "https://www.linkedin.com/company/apple/",
    "https://www.linkedin.com/company/microsoft/"
  ],
  "maxAgeHours": 0
}

Field	Type	Required	Notes
`liUrls`	`string[]`	Yes	1 to 200 valid URLs. URLs must point to `linkedin.com/company/...`, `linkedin.com/showcase/...`, or `linkedin.com/school/...`.
`maxAgeHours`	`number`	No	0 to 24. `0` means live refresh.
`maxAgeSeconds`	`number`	No	0 to 86400. If both freshness fields are present, `maxAgeSeconds` takes precedence.

Success response

{
  "message": "Success",
  "status_code": 200,
  "results": [
    {
      "final_li_url": "https://www.linkedin.com/company/apple/",
      "company_name": "Apple",
      "domain": "apple.com",
      "website": "http://www.apple.com/careers",
      "company_id": 162479,
      "company_size": "10,001+ employees",
      "employee_count_on_li": 181922,
      "follower_count": 18213841,
      "industries": "Computers and Electronics Manufacturing",
      "description": "We’re a diverse collective of thinkers and doers...",
      "headquarters": {
        "fullAddress": "1 Apple Park Way, Cupertino, California, 95014, US",
        "street": "1 Apple Park Way",
        "locality": "Cupertino",
        "region": "California",
        "postalCode": "95014",
        "country": "US"
      },
      "locations": [
        {
          "fullAddress": "1 Apple Park Way, Cupertino, California 95014, US",
          "street": "1 Apple Park Way",
          "cityStatePostalCountry": "Cupertino, California 95014, US"
        }
      ],
      "logo": "https://media.licdn.com/...",
      "banner_img": "https://media.licdn.com/...",
      "founded": 1976,
      "type": "Public Company",
      "specialties": ["Innovative Product Development", "Retail"],
      "original_li_url": "https://www.linkedin.com/company/apple/",
      "employees_on_li": [
        {
          "name": "Paul King",
          "link": "https://www.linkedin.com/in/pdking"
        }
      ],
      "funding_info": {
        "number_of_funding_rounds": 9,
        "last_round": {
          "type": "Post IPO debt",
          "date": "Jun 5, 2025",
          "money_raised": "$ 4.5B"
        }
      },
      "similar_pages": [],
      "affiliated_pages": []
    }
  ]
}

Common result fields

Each result is an object. Field availability depends on the LinkedIn page and the live data available at request time.

Common fields include:

affiliated_pages
banner_img
company_id
company_name
company_size
description
domain
employee_count_on_li
employees_on_li
final_li_url
follower_count
founded
funding_info
headquarters
industries
locations
logo
original_li_url
similar_pages
specialties
type
website