---
title: "Get LinkedIn account insights of a company"
method: GET
path: "/linkedin/account-insights"
---

# Get LinkedIn account insights of a company

`GET /linkedin/account-insights`

## Request

- Base URL: `https://api.harvestapi.io`
- URL: `https://api.harvestapi.io/linkedin/account-insights`
- Auth: API key in header `X-API-Key`

Get in-depth insights about a LinkedIn company: company profile and revenue, AI-generated summaries (business model, strategic priorities, challenges, competitors), key people, headcount and hiring charts, job openings, suggested people to reach out to, and the latest alerts.

## Query parameters

- `query` string, url

## Response `200`

Account insights response

- object
  - `element` AccountInsights
    - `id` string: LinkedIn company ID
    - `name` string, nullable: Company name
    - `linkedinUrl` string, uri, nullable: Company page URL
    - `company` object, nullable: Company profile
      - `description` string, nullable
      - `industry` string, nullable
      - `type` string, nullable: Company type, e.g. "Public Company" or "Privately Held"
      - `yearFounded` integer, nullable
      - `website` string, nullable
      - `location` string, nullable: Headquarters location as one line, e.g. "Mountain View, California, United States"
      - `headquarters` object, nullable: Headquarters address
        - `country` string, nullable
        - `geographicArea` string, nullable: State or region
        - `city` string, nullable
        - `postalCode` string, nullable
        - `line1` string, nullable
        - `line2` string, nullable
      - `specialties` string[]
      - `revenueRange` object, nullable: Estimated annual revenue range
        - `min` AccountInsightsMoney, nullable: An amount of money: `amount` of `unit`, e.g. 402.84 BILLION USD
          - `amount` number
          - `unit` string: e.g. "MILLION" or "BILLION"
          - `currency` string: e.g. "USD"
        - `max` AccountInsightsMoney, nullable: An amount of money: `amount` of `unit`, e.g. 402.84 BILLION USD
          - `amount` number
          - `unit` string: e.g. "MILLION" or "BILLION"
          - `currency` string: e.g. "USD"
      - `employeeCount` integer, nullable: Number of employees on LinkedIn
      - `employeeCountRange` string, nullable: Headcount range, e.g. "10001+"
      - `employeeDisplayCount` string, nullable: Headcount as LinkedIn displays it, e.g. "200K+"
      - `employeeGrowth` AccountInsightsGrowth[]: Headcount change over the last six months, year and two years
        - `timespan` string: "SIX_MONTHS", "YEAR" or "TWO_YEAR"
        - `percentage` number: Headcount change over the timespan, in percent
      - `logoUrl` string
      - `coverUrl` string
    - `commonSearches` object, nullable: Employee counts of the common searches at the company. Counts are as LinkedIn displays them, e.g. "7.5K+"
      - `allEmployees` object: All employees of the company
        - `count` integer, nullable
        - `displayCount` string, nullable
      - `decisionMakers` object: Employees in decision-making roles
        - `displayCount` string, nullable
      - `teamLinkConnections` object: Employees connected to your team. Only for requests with a [custom account](/guides/custom-accounts)
        - `displayCount` string, nullable
      - `sharedAlumni` object: Employees who studied at the same schools as you. Only for requests with a [custom account](/guides/custom-accounts)
        - `displayCount` string, nullable
      - `personas` object[]: Employee counts per persona of your account. Only for requests with a [custom account](/guides/custom-accounts)
        - `name` string, nullable: Persona name, e.g. "Director+" or "CXO"
        - `type` string, nullable: e.g. "DEFAULT_DIRECTOR", "DEFAULT_CXO" or "USER_GENERATED"
        - `displayCount` string, nullable
    - `howTheyMakeMoney` object, nullable: AI-generated summary of the business model, with the latest yearly and quarterly revenue. Null when LinkedIn has no AI summary of the company (mostly smaller companies)
      - `text` string, nullable: How the company makes money
      - `source` string, nullable: Source URL of the summary
      - `annualRevenue` AccountInsightsRevenue, nullable: Revenue of a period: the reported figure and the estimated range
        - `period` string, nullable: "2025" for a year, "Q2 2026" for a quarter
        - `reported` AccountInsightsMoney, nullable: An amount of money: `amount` of `unit`, e.g. 402.84 BILLION USD
          - `amount` number
          - `unit` string: e.g. "MILLION" or "BILLION"
          - `currency` string: e.g. "USD"
        - `estimatedMin` AccountInsightsMoney, nullable: An amount of money: `amount` of `unit`, e.g. 402.84 BILLION USD
          - `amount` number
          - `unit` string: e.g. "MILLION" or "BILLION"
          - `currency` string: e.g. "USD"
        - `estimatedMax` AccountInsightsMoney, nullable: An amount of money: `amount` of `unit`, e.g. 402.84 BILLION USD
          - `amount` number
          - `unit` string: e.g. "MILLION" or "BILLION"
          - `currency` string: e.g. "USD"
        - `source` string, nullable: Source URL
      - `quarterRevenue` AccountInsightsRevenue, nullable: Revenue of a period: the reported figure and the estimated range
        - `period` string, nullable: "2025" for a year, "Q2 2026" for a quarter
        - `reported` AccountInsightsMoney, nullable: An amount of money: `amount` of `unit`, e.g. 402.84 BILLION USD
          - `amount` number
          - `unit` string: e.g. "MILLION" or "BILLION"
          - `currency` string: e.g. "USD"
        - `estimatedMin` AccountInsightsMoney, nullable: An amount of money: `amount` of `unit`, e.g. 402.84 BILLION USD
          - `amount` number
          - `unit` string: e.g. "MILLION" or "BILLION"
          - `currency` string: e.g. "USD"
        - `estimatedMax` AccountInsightsMoney, nullable: An amount of money: `amount` of `unit`, e.g. 402.84 BILLION USD
          - `amount` number
          - `unit` string: e.g. "MILLION" or "BILLION"
          - `currency` string: e.g. "USD"
        - `source` string, nullable: Source URL
    - `strategicPriorities` AccountInsightsSourcedText[]: AI-generated strategic priorities of the company, each with its source URL. Empty when LinkedIn has no AI summary of the company
      - `title` string, nullable
      - `description` string, nullable
      - `source` string, nullable: Source URL
    - `businessChallenges` AccountInsightsSourcedText[]: AI-generated business challenges of the company, each with its source URL. Empty when LinkedIn has no AI summary of the company
      - `title` string, nullable
      - `description` string, nullable
      - `source` string, nullable: Source URL
    - `competitiveLandscape` object, nullable: AI-generated overview of the competition. Null when LinkedIn has no AI summary of the company
      - `text` string, nullable: Overview of the competition
      - `source` string, nullable
      - `competitors` AccountInsightsCompanyCard[]: Main competitors
        - `id` string: LinkedIn company ID
        - `name` string, nullable
        - `industry` string, nullable
        - `location` string, nullable
        - `employeeCountRange` string, nullable
        - `employeeDisplayCount` string, nullable
        - `employeeGrowth` AccountInsightsGrowth[]
          - `timespan` string: "SIX_MONTHS", "YEAR" or "TWO_YEAR"
          - `percentage` number: Headcount change over the timespan, in percent
        - `linkedinUrl` string, uri
        - `logoUrl` string
      - `sources` string[]: Source URLs of the overview
    - `headcountInsights` object, nullable: Workforce summaries and the current headcount figures
      - `summaries` string[]: AI-generated observations about the headcount changes by department
      - `employeeCount` integer, nullable
      - `medianTenureYears` number, nullable: Median employee tenure in years
      - `growth` AccountInsightsGrowth[]
        - `timespan` string: "SIX_MONTHS", "YEAR" or "TWO_YEAR"
        - `percentage` number: Headcount change over the timespan, in percent
    - `keyPeople` AccountInsightsExecutive[]: Key executives of the company
      - `id` string: LinkedIn profile ID
      - `name` string, nullable: Full name
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `linkedinUrl` string, uri
      - `pictureUrl` string
      - `title` string, nullable
      - `companyName` string, nullable
      - `location` string, nullable
      - `industry` string, nullable
      - `degree` integer, nullable: Connection degree between the person and your account: 1, 2 or 3, and -1 when out of network. Only for requests with a [custom account](/guides/custom-accounts)
      - `positions` AccountInsightsPosition[]: Positions, latest first
        - `title` string, nullable
        - `companyName` string, nullable
        - `companyId` string, nullable: LinkedIn company ID
        - `location` string, nullable
        - `description` string, nullable
        - `startedOn` string, nullable: YYYY-MM
        - `current` boolean
        - `tenureAtPosition` object, nullable: Time in this position
          - `years` integer
          - `months` integer
        - `tenureAtCompany` object, nullable: Time at the company
          - `years` integer
          - `months` integer
    - `executiveVoices` object, nullable: Recent LinkedIn posts of the company executives. Null when there are none
      - `summary` string, nullable
      - `posts` AccountInsightsExecutivePost[]
        - `id` string, nullable: Post URN
        - `url` string, nullable: Post URL
        - `text` string, nullable
        - `createdAt` string, date-time, nullable: ISO 8601 date
        - `author` AccountInsightsExecutive
          - `id` string: LinkedIn profile ID
          - `name` string, nullable: Full name
          - `firstName` string, nullable
          - `lastName` string, nullable
          - `linkedinUrl` string, uri
          - `pictureUrl` string
          - `title` string, nullable
          - `companyName` string, nullable
          - `location` string, nullable
          - `industry` string, nullable
          - `degree` integer, nullable: Connection degree between the person and your account: 1, 2 or 3, and -1 when out of network. Only for requests with a [custom account](/guides/custom-accounts)
          - `positions` AccountInsightsPosition[]: Positions, latest first
            - `title` string, nullable
            - `companyName` string, nullable
            - `companyId` string, nullable: LinkedIn company ID
            - `location` string, nullable
            - `description` string, nullable
            - `startedOn` string, nullable: YYYY-MM
            - `current` boolean
            - `tenureAtPosition` object, nullable: Time in this position
              - …
            - `tenureAtCompany` object, nullable: Time at the company
              - …
    - `relatedNews` AccountInsightsNewsArticle[]: Recent news about the company
      - `title` string, nullable
      - `url` string, nullable
      - `description` string, nullable
      - `imageUrl` string, nullable
    - `relationshipExplorer` object, nullable: People at the company suggested to reach out to. The suggestions depend on the account used for scraping
      - `totalDisplayCount` string, nullable: Number of people found, as LinkedIn displays it
      - `total` integer, nullable: Number of people found
      - `highlights` object[]: How many of the people found have each highlight, e.g. "RPC" (recently changed jobs) or "RPOL" (posted on LinkedIn). "PCOLL" (your past colleagues) and "COMM" (shared experiences with you): only for requests with a [custom account](/guides/custom-accounts)
        - `id` string
        - `label` string, nullable
        - `count` integer, nullable
      - `companyHighlights` AccountHighlight[]: Highlights of the company itself, e.g. "HIRING_ON_LINKEDIN" or "SENIOR_LEADERSHIP_CHANGE"
        - `id` string: e.g. "HIRING_ON_LINKEDIN" or "SENIOR_LEADERSHIP_CHANGE" for a company, "RECENTLY_HIRED" or "POSTED_ON_LINKEDIN" for a person
        - `label` string, nullable
        - `header` string, nullable
        - `message` string, nullable
      - `leads` AccountInsightsLead[]: Up to 8 of the people found
        - `id` string: LinkedIn profile ID
        - `name` string, nullable: Full name
        - `firstName` string, nullable
        - `lastName` string, nullable
        - `linkedinUrl` string, uri
        - `pictureUrl` string
        - `headline` string, nullable
        - `summary` string, nullable
        - `location` string, nullable
        - `degree` integer, nullable: Connection degree between the person and your account: 1, 2 or 3, and -1 when out of network. Only for requests with a [custom account](/guides/custom-accounts)
        - `premium` boolean
        - `openProfile` boolean
        - `seniority` string[]: e.g. "CXO" or "Owner / Partner"
        - `currentPositions` AccountInsightsPosition[]
          - `title` string, nullable
          - `companyName` string, nullable
          - `companyId` string, nullable: LinkedIn company ID
          - `location` string, nullable
          - `description` string, nullable
          - `startedOn` string, nullable: YYYY-MM
          - `current` boolean
          - `tenureAtPosition` object, nullable: Time in this position
            - `years` integer
            - `months` integer
          - `tenureAtCompany` object, nullable: Time at the company
            - `years` integer
            - `months` integer
        - `highlights` AccountHighlight[]: Why the person is suggested
          - `id` string: e.g. "HIRING_ON_LINKEDIN" or "SENIOR_LEADERSHIP_CHANGE" for a company, "RECENTLY_HIRED" or "POSTED_ON_LINKEDIN" for a person
          - `label` string, nullable
          - `header` string, nullable
          - `message` string, nullable
    - `growthInsights` object: Headcount, hiring and job opening charts
      - `employeeCount` object, nullable: Total headcount over time
        - `total` integer, nullable: Current headcount
        - `changePercentage` number, nullable: Headcount change over the whole series (two years), in percent
        - `medianTenureYears` number, nullable: Median employee tenure in years
        - `monthly` AccountInsightsMonthlyCount[]: Headcount month by month over the last two years
          - `month` string: YYYY-MM
          - `count` integer
          - `changePercentage` number, nullable: Change against the previous month, in percent
      - `headcountByFunction` object, nullable: Headcount by job function. `total` is the company total over the last year
        - `total` AccountInsightsFunctionHeadcount
          - `function` string: Job function, e.g. "Engineering", or "Total"
          - `count` integer, nullable: Current headcount
          - `changePercentage` number, nullable: Change over the period, in percent
          - `monthly` AccountInsightsMonthlyCount[]
            - `month` string: YYYY-MM
            - `count` integer
            - `changePercentage` number, nullable: Change against the previous month, in percent
        - `threeMonths` AccountInsightsFunctionHeadcount[]: Headcount by function over the last three months
          - `function` string: Job function, e.g. "Engineering", or "Total"
          - `count` integer, nullable: Current headcount
          - `changePercentage` number, nullable: Change over the period, in percent
          - `monthly` AccountInsightsMonthlyCount[]
            - `month` string: YYYY-MM
            - `count` integer
            - `changePercentage` number, nullable: Change against the previous month, in percent
        - `sixMonths` AccountInsightsFunctionHeadcount[]: Headcount by function over the last six months
          - `function` string: Job function, e.g. "Engineering", or "Total"
          - `count` integer, nullable: Current headcount
          - `changePercentage` number, nullable: Change over the period, in percent
          - `monthly` AccountInsightsMonthlyCount[]
            - `month` string: YYYY-MM
            - `count` integer
            - `changePercentage` number, nullable: Change against the previous month, in percent
        - `oneYear` AccountInsightsFunctionHeadcount[]: Headcount by function over the last year
          - `function` string: Job function, e.g. "Engineering", or "Total"
          - `count` integer, nullable: Current headcount
          - `changePercentage` number, nullable: Change over the period, in percent
          - `monthly` AccountInsightsMonthlyCount[]
            - `month` string: YYYY-MM
            - `count` integer
            - `changePercentage` number, nullable: Change against the previous month, in percent
      - `newHires` object[], nullable: New hires month by month over the last two years
        - `month` string: YYYY-MM
        - `total` integer: All new hires
        - `senior` integer: Senior new hires
      - `jobOpenings` object, nullable: Job openings and their change over time, in total and by function
        - `latestQuarter` string, nullable: YYYY-MM of the latest figures
        - `total` AccountInsightsJobOpenings
          - `function` string: Job function, e.g. "Engineering", or "Total"
          - `latestCount` integer, nullable: Job openings in the latest quarter
          - `threeMonthPercentage` number, nullable: Change over three months, in percent
          - `sixMonthPercentage` number, nullable: Change over six months, in percent
          - `oneYearPercentage` number, nullable: Change over one year, in percent
        - `byFunction` AccountInsightsJobOpenings[]
          - `function` string: Job function, e.g. "Engineering", or "Total"
          - `latestCount` integer, nullable: Job openings in the latest quarter
          - `threeMonthPercentage` number, nullable: Change over three months, in percent
          - `sixMonthPercentage` number, nullable: Change over six months, in percent
          - `oneYearPercentage` number, nullable: Change over one year, in percent
    - `recentGrowthAlerts` AccountInsightsAlert[]: Up to 3 latest alerts about the company growth or risks, e.g. employees of another company moving here
      - `id` string: Alert ID
      - `type` string: e.g. "ACCOUNT_SHARED_UPDATE", "ACCOUNT_HEADCOUNT_ACCELERATED_FLOW", "LEAD_POSITION_CHANGE_NEW_COMPANY" or "LEAD_POSITION_CHANGE_SAME_COMPANY"
      - `createdAt` string, date-time, nullable: ISO 8601 date
      - `headline` string, nullable
      - `shortHeadline` string, nullable
      - `body` string, nullable
      - `imageUrl` string
      - `lead` AccountInsightsPerson
        - `id` string: LinkedIn profile ID
        - `name` string, nullable: Full name
        - `firstName` string, nullable
        - `lastName` string, nullable
        - `linkedinUrl` string, uri
        - `pictureUrl` string
    - `peopleAlsoViewed` AccountInsightsCompanyCard[]: Similar companies that people also viewed, up to 12
      - `id` string: LinkedIn company ID
      - `name` string, nullable
      - `industry` string, nullable
      - `location` string, nullable
      - `employeeCountRange` string, nullable
      - `employeeDisplayCount` string, nullable
      - `employeeGrowth` AccountInsightsGrowth[]
        - `timespan` string: "SIX_MONTHS", "YEAR" or "TWO_YEAR"
        - `percentage` number: Headcount change over the timespan, in percent
      - `linkedinUrl` string, uri
      - `logoUrl` string
    - `accountAlerts` object: Latest alerts about the company and its employees: company posts, job changes, etc.
      - `nextStart` integer, nullable: Offset of the next page of alerts; null when there are no more
      - `items` AccountInsightsAlert[]: Up to 20 latest alerts
        - `id` string: Alert ID
        - `type` string: e.g. "ACCOUNT_SHARED_UPDATE", "ACCOUNT_HEADCOUNT_ACCELERATED_FLOW", "LEAD_POSITION_CHANGE_NEW_COMPANY" or "LEAD_POSITION_CHANGE_SAME_COMPANY"
        - `createdAt` string, date-time, nullable: ISO 8601 date
        - `headline` string, nullable
        - `shortHeadline` string, nullable
        - `body` string, nullable
        - `imageUrl` string
        - `lead` AccountInsightsPerson
          - `id` string: LinkedIn profile ID
          - `name` string, nullable: Full name
          - `firstName` string, nullable
          - `lastName` string, nullable
          - `linkedinUrl` string, uri
          - `pictureUrl` string
  - `status` integer
  - `error` string
  - `query` object
    - `query` string

## Other responses

- `400`: Unexpected error

## Changes

- **2026-11-03** `bd2b8cb6739e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/harvestapi/apis/harvestapi-linkedin-api-reference/changes/linkedin/account-insights/get.md)

---

[API](https://skmtc.dev/harvestapi/apis/harvestapi-linkedin-api-reference.md) - [All operations](https://skmtc.dev/harvestapi/apis/harvestapi-linkedin-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/harvestapi/apis/harvestapi-linkedin-api-reference/revisions/bd2b8cb6739e?raw)