> ## Documentation Index
> Fetch the complete documentation index at: https://docs.harvestapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Company People Stats

> Get the People statistics of a LinkedIn company page: where the employees are located, where they studied, etc.

## Get the People tab statistics of a LinkedIn company

Returns the breakdown shown on the "People" tab of a company page: where the employees are located, where they studied, what they do, what they are skilled at, the service categories they offer and their fields of study. Every group is a list of values with the number of employees matching each value, up to 15 values per group, largest first.

<CodeGroup>
  ```javascript JavaScript theme={null}
  const params = new URLSearchParams({
    query: 'https://www.linkedin.com/company/google/', // by URL
    // query: 'google', // by universal name alternatively
    // query: '1441', // or by company ID
  });

  fetch(`https://api.harvestapi.io/linkedin/company-people-stats?${params.toString()}`, {
    headers: { 'X-API-Key': '<api-key>' },
  })
    .then((response) => response.json())
    .then((data) => console.log(data));
  ```

  ```bash cURL theme={null}
  curl --request GET \
    --url https://api.harvestapi.io/linkedin/company-people-stats?query=google \
    --header 'X-API-Key: <api-key>'
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.harvestapi.io/linkedin/company-people-stats?query=google"

  headers = {"X-API-Key": "<api-key>"}

  response = requests.request("GET", url, headers=headers)

  print(response.text)
  ```
</CodeGroup>


## OpenAPI

````yaml GET /linkedin/company-people-stats
openapi: 3.0.1
info:
  title: HarvestAPI LinkedIn API reference
  description: HarvestAPI LinkedIn API reference
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.harvestapi.io
security:
  - ApiKeyAuthHeader: []
paths:
  /linkedin/company-people-stats:
    get:
      summary: Get the LinkedIn company people stats
      description: >-
        Get the People statistics of a LinkedIn company page: where the
        employees are located, where they studied, etc.
      parameters:
        - name: query
          in: query
          description: >-
            URL or universal name or company ID of the LinkedIn company. A
            company ID skips the company lookup and answers faster
          schema:
            type: string
            format: url
      responses:
        '200':
          description: Company people stats response
          content:
            application/json:
              schema:
                type: object
                properties:
                  element:
                    $ref: '#/components/schemas/CompanyPeopleStats'
                  status:
                    type: integer
                  error:
                    type: string
                  query:
                    type: object
                    properties:
                      universalName:
                        type: string
                      companyId:
                        type: string
              example:
                element:
                  id: '1441'
                  universalName: google
                  linkedinUrl: https://www.linkedin.com/company/google
                  peopleStats:
                    - statTitle: Locations
                      values:
                        - title: United States
                          count: 79084
                        - title: California, United States
                          count: 47339
                        - title: San Francisco Bay Area
                          count: 42556
                    - statTitle: School
                      values:
                        - title: University of California, Berkeley
                          count: 3558
                        - title: Stanford University
                          count: 3191
                        - title: Massachusetts Institute of Technology
                          count: 1594
                    - statTitle: Current Function
                      values:
                        - title: Engineering
                          count: 76734
                        - title: Information Technology
                          count: 19508
                        - title: Business Development
                          count: 15830
                    - statTitle: Skill Explicit
                      values:
                        - title: Python (Programming Language)
                          count: 53899
                        - title: Java
                          count: 48710
                        - title: C++
                          count: 45410
                    - statTitle: Service categories
                      values:
                        - title: Consulting
                          count: 1870
                        - title: Marketing
                          count: 1545
                        - title: Software Development
                          count: 1396
                    - statTitle: Field of Study
                      values:
                        - title: Computer Science
                          count: 44460
                        - title: Computational Science
                          count: 39151
                        - title: Computer Engineering
                          count: 10590
                status: 200
                query:
                  universalName: google
        '400':
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    CompanyPeopleStats:
      type: object
      properties:
        id:
          type: string
          description: LinkedIn company ID
        universalName:
          type: string
          nullable: true
          description: >-
            Universal name of the company (the last part of its URL). Null when
            the company was requested by ID
        linkedinUrl:
          type: string
          format: uri
        peopleStats:
          type: array
          description: >-
            One entry per "People" tab group, always in this order: Locations,
            School, Current Function, Skill Explicit, Service categories, Field
            of Study. Each group holds up to 15 values sorted by count, largest
            first; a group without data has an empty values list
          items:
            $ref: '#/components/schemas/CompanyPeopleStat'
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
    CompanyPeopleStat:
      type: object
      properties:
        statTitle:
          type: string
          description: >-
            Name of the group: "Locations", "School", "Current Function", "Skill
            Explicit", "Service categories" or "Field of Study"
        values:
          type: array
          items:
            type: object
            properties:
              title:
                type: string
                description: Value within the group, e.g. "United States" for Locations
              count:
                type: integer
                description: Number of the company employees matching the value
  securitySchemes:
    ApiKeyAuthHeader:
      type: apiKey
      in: header
      name: X-API-Key

````