---
title: "Live fetch LinkedIn company"
method: POST
path: "/v1/linkedin-live-fetch/company/single"
tags: ["Live fetch"]
---

# Live fetch LinkedIn company

`POST /v1/linkedin-live-fetch/company/single`

Returns an enriched company with details for a given LinkedIn company identifier

<span>⚡ <strong>Rate limit:</strong> 600 requests per 1 minute</span>

<span>💰 <strong>Cost:</strong> 2 credits per company live fetch&nbsp;<span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>

## Request body

- object
  - `apiKey` string, required — Your Fiber API key
  - `type` 'slug' | 'orgId' | 'liUrl', required
  - `value` string, required — The company's LinkedIn slug (e.g. 'microsoft'), LinkedIn URL (e.g. 'https://www.linkedin.com/company/microsoft'), LinkedIn organization ID (e.g. '1441'), or Fiber company ID (e.g. 'comp_1441').
  - `getHistoricalHeadcount` boolean — Whether to compute the company's overall employee count over time and recent growth trends. This returns total headcount through time, not a per-department breakdown — for per-department headcount, use the Depth Chart endpoints. No additional cost, but may take longer.

## Response `200`

Default Response

- object
  - `output` object, required
    - `company` object, required — The enriched company data. A 404 status is returned if the company was not found.
      - `headline` string, nullable
      - `description` string, nullable
      - `employee_count` number, nullable
      - `follower_count` number, nullable
      - `founded_year` number, nullable
      - `industries` object[], nullable
        - `id` string, required
        - `name` string, required
        - `primary` boolean, nullable
      - `inferred_location` object, nullable
        - `street_address` string, nullable
        - `neighborhood` string, nullable
        - `city` string, nullable
        - `state_name` string, nullable
        - `state_code` string, nullable
        - `county` string, nullable
        - `postal_code` string, nullable
        - `country_code` string, nullable
        - `country_name` string, nullable
        - `coordinates` object, nullable
          - `lat` number, required
          - `lon` number, required
        - `timezone` string, nullable
        - `full_address` string, nullable
        - `formatted_address` string, nullable
      - `linkedin_url` string, nullable
      - `locations` object[], nullable
        - `address` string, nullable
        - `is_primary` boolean, nullable
        - `location` object, nullable
          - `street_address` string, nullable
          - `neighborhood` string, nullable
          - `city` string, nullable
          - `state_name` string, nullable
          - `state_code` string, nullable
          - `county` string, nullable
          - `postal_code` string, nullable
          - `country_code` string, nullable
          - `country_name` string, nullable
          - `coordinates` object, nullable
            - `lat` number, required
            - `lon` number, required
          - `timezone` string, nullable
          - `full_address` string, nullable
          - `formatted_address` string, nullable
      - `naics_codes` string[], nullable
      - `name` string, nullable
      - `org_id` string, nullable
      - `slug` string, required
      - `specialties` string[], nullable
      - `ticker` string, nullable
      - `type` string, nullable
      - `domain` string, nullable
      - `website` string, nullable
      - `est_employee_count_lower_bound` number, nullable
      - `est_employee_count_upper_bound` number, nullable
      - `standardized_industries` string[], nullable
      - `locations_stats` object, nullable
        - `USA` number
        - `GBR` number
        - `FRA` number
        - `IND` number
        - `BRA` number
        - `DEU` number
        - `ESP` number
        - `CAN` number
        - `AUS` number
        - `NLD` number
        - `ITA` number
        - `ZAF` number
        - `BEL` number
        - `CHN` number
        - `TUR` number
        - `MEX` number
        - `CHE` number
        - `NOR` number
        - `ARE` number
        - `SWE` number
        - `POL` number
        - `IDN` number
        - `ARG` number
        - `PRT` number
        - `COL` number
        - `CHL` number
        - `PAK` number
        - `DNK` number
        - `JPN` number
        - `NGA` number
        - `SGP` number
        - `PER` number
        - `NZL` number
        - `AUT` number
        - `IRL` number
        - `MYS` number
        - `BGD` number
        - `EGY` number
        - `ISR` number
        - `SAU` number
        - `PHL` number
        - `FIN` number
        - `IRN` number
        - `ROU` number
        - `CZE` number
        - `GRC` number
        - `HKG` number
        - `HUN` number
        - `KEN` number
        - `MAR` number
        - `VNM` number
        - `RUS` number
        - `UKR` number
        - `ECU` number
        - `THA` number
        - `LKA` number
        - `KOR` number
        - `BGR` number
        - `GHA` number
        - `SRB` number
        - `TWN` number
        - `HRV` number
        - `LTU` number
        - `PRI` number
        - `SVK` number
        - `TUN` number
        - `EST` number
        - `VEN` number
        - `CRI` number
        - `PAN` number
        - `URY` number
        - `LBN` number
        - `LUX` number
        - `CYP` number
        - `NPL` number
        - `JOR` number
        - `SVN` number
        - `MTQ` number
        - `QAT` number
        - `GLP` number
        - `UGA` number
        - `DZA` number
        - `GTM` number
        - `CMR` number
        - `LVA` number
        - `DOM` number
        - `AZE` number
        - `GEO` number
        - `SEN` number
        - `TZA` number
        - `ZWE` number
        - `KWT` number
        - `MLT` number
        - `OMN` number
        - `BOL` number
        - `SLV` number
        - `ARM` number
        - `PRY` number
        - `IRQ` number
        - `KHM` number
        - `BIH` number
        - `AGO` number
        - `BHR` number
        - `ALB` number
        - `KAZ` number
        - `CIV` number
        - `ETH` number
        - `MUS` number
        - `ZMB` number
        - `MKD` number
        - `COD` number
        - `BLR` number
        - `MOZ` number
        - `REU` number
        - `TTO` number
        - `GUF` number
        - `ISL` number
        - `MMR` number
        - `HND` number
        - `RWA` number
        - `MDG` number
        - `BEN` number
        - `UZB` number
        - `NAM` number
        - `BWA` number
        - `MDA` number
        - `JEY` number
        - `NIC` number
        - `SDN` number
        - `JAM` number
        - `IMN` number
        - `BFA` number
        - `MNG` number
        - `MNE` number
        - `MCO` number
        - `TGO` number
        - `AFG` number
        - `LBY` number
        - `XKX` number
        - `CYM` number
        - `MWI` number
        - `SOM` number
        - `PNG` number
        - `MDV` number
        - `MLI` number
        - `GIN` number
        - `PSE` number
        - `GAB` number
        - `LIE` number
        - `HTI` number
        - `SYR` number
        - `BRB` number
        - `YEM` number
        - `GGY` number
        - `NCL` number
        - `AND` number
        - `SUR` number
        - `MYT` number
        - `KGZ` number
        - `BHS` number
        - `GIB` number
        - `COG` number
        - `FJI` number
        - `BLM` number
        - `CUW` number
        - `CUB` number
        - `SLE` number
        - `BLZ` number
        - `NER` number
        - `LBR` number
        - `VIR` number
        - `PYF` number
        - `GUM` number
        - `MRT` number
        - `ABW` number
        - `SYC` number
        - `GUY` number
        - `LSO` number
        - `SWZ` number
        - `SSD` number
        - `LCA` number
        - `MAC` number
        - `SMR` number
        - `LAO` number
        - `BRN` number
        - `TCD` number
        - `BMU` number
        - `VGB` number
        - `PRK` number
        - `BTN` number
        - `BDI` number
        - `FRO` number
        - `TJK` number
        - `GMB` number
        - `STP` number
        - `ANT` number
        - `VCT` number
        - `DJI` number
        - `CPV` number
        - `TKM` number
        - `ATG` number
        - `TCA` number
        - `KNA` number
        - `GRD` number
        - `ASM` number
        - `VUT` number
        - `GNQ` number
        - `GRL` number
        - `SXM` number
        - `MNP` number
        - `COM` number
        - `TLS` number
        - `SJM` number
        - `CAF` number
        - `DMA` number
        - `MAF` number
        - `WSM` number
        - `BES` number
        - `MHL` number
        - `AIA` number
        - `TON` number
        - `COK` number
        - `SLB` number
        - `SPM` number
        - `GNB` number
        - `ATA` number
        - `TUV` number
        - `ALA` number
        - `IOT` number
        - `ERI` number
        - `PLW` number
        - `FSM` number
        - `NRU` number
        - `PCN` number
        - `FLK` number
        - `MSR` number
        - `VAT` number
        - `KIR` number
        - `SHN` number
        - `NIU` number
        - `WLF` number
        - `HMD` number
        - `CXR` number
        - `NFK` number
        - `ATF` number
        - `CCK` number
        - `SGS` number
        - `BVT` number
        - `UMI` number
        - `ESH` number
        - `TKL` number
        - `X-SOUTH_ASIA` number
        - `X-SOUTH_EAST_EUROPE` number
        - `X-NORTHERN_AFRICA` number
        - `X-PACIFIC` number
        - `X-SOUTH_WEST_EUROPE` number
        - `X-SOUTHERN_AFRICA` number
        - `X-WEST_INDIES` number
        - `X-SOUTH_AMERICA` number
        - `X-SOUTH_WEST_ASIA` number
        - `X-CENTRAL_EUROPE` number
        - `X-EASTERN_EUROPE` number
        - `X-WESTERN_EUROPE` number
        - `X-CENTRAL_AMERICA` number
        - `X-WESTERN_AFRICA` number
        - `X-SOUTH_ATLANTIC_OCEAN` number
        - `X-SOUTH_EAST_ASIA` number
        - `X-CENTRAL_AFRICA` number
        - `X-NORTH_AMERICA` number
        - `X-EAST_ASIA` number
        - `X-NORTHERN_EUROPE` number
        - `X-EASTERN_AFRICA` number
        - `X-SOUTHERN_INDIAN_OCEAN` number
        - `X-SOUTHERN_EUROPE` number
        - `X-CENTRAL_ASIA` number
        - `X-NORTHERN_ASIA` number
        - `X-ASIA` number
        - `X-EUROPE` number
        - `X-AFRICA` number
        - `X-OCEANIA` number
        - `X-AMERICAS` number
        - `X-ANTARCTICA` number
        - `X-ATLANTIC_OCEAN` number
        - `X-INDIAN_OCEAN` number
        - `X-MIDDLE_EAST` number
        - `X-MENA` number
        - `X-EMEA` number
        - `X-EUROPEAN_UNION` number
        - `X-EFTA` number
        - `X-APAC` number
        - `X-LATAM` number
        - `X-ANGLOSPHERE` number
        - `X-DACH` number
        - `X-NORDICS` number
        - `X-BENELUX` number
        - `X-GCC` number
        - `X-BRICS` number
        - `X-G20` number
        - `X-OECD` number
        - `X-SANCTIONED` number
      - `logo_url` string, nullable
      - `historical_headcount` object, nullable
        - `latest_snapshot_date` string, date, required
        - `snapshots` object[], required
          - `date` string, date, required
          - `employees` integer, required
        - `growth` object, required
          - `1m` object, nullable
            - `percent` number, required
            - `quantity` integer, required
          - `2m` object, nullable
            - `percent` number, required
            - `quantity` integer, required
          - `3m` object, nullable
            - `percent` number, required
            - `quantity` integer, required
          - `6m` object, nullable
            - `percent` number, required
            - `quantity` integer, required
          - `12m` object, nullable
            - `percent` number, required
            - `quantity` integer, required
          - `18m` object, nullable
            - `percent` number, required
            - `quantity` integer, required
          - `24m` object, nullable
            - `percent` number, required
            - `quantity` integer, required
          - `36m` object, nullable
            - `percent` number, required
            - `quantity` integer, required
      - `revenue_usd_lower_bound` string, nullable
      - `revenue_usd_upper_bound` string, nullable
    - `isCached404` boolean, nullable — True when the company is not found on LinkedIn but we have cached data in our database.
  - `chargeInfo` union, required
    - object — Credits were charged immediately for this operation
      - `method` 'charged-now', required
      - `creditsCharged` number, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits will be charged after the operation completes
      - `method` 'charging-later', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits that were charged for an asynchronous operation
      - `method` 'charged-for-async-process', required
      - `creditsCharged` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — No credits were charged for this operation
      - `method` 'free', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits were refunded for this operation
      - `method` 'credits-refunded', required
      - `creditsRefunded` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
  - `warnings` object[], nullable — Warnings about extraneous fields in request
    - `field` string, required — Full path to extraneous field (e.g., 'searchParams.ExtraField')
    - `message` string, required — Warning message
  - `advice` string[], nullable — Tips, recommendations, and suggestions for using this API effectively.

## Other responses

- `400` — Default Response
- `401` — Default Response
- `402` — Default Response
- `403` — Default Response
- `404` — Default Response
- `422` — Default Response
- `429` — Default Response
- `500` — Default Response
- `503` — Default Response

---

[API](https://skmtc.net/fiber/apis/fiber-ai-api.md) · [All operations](https://skmtc.net/fiber/apis/fiber-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fiber/fiber-ai-api/revisions/5b9ee17f79e9/schema)