Live enrichment endpoints: company and profile

Live enrichment fetches the latest data directly from LinkedIn for a specific company or person, rather than returning what Descovo has stored in its database. Use it when you need fresh details for a small number of high-value accounts or prospects — for example, to confirm current headcount, recent funding, or an executive’s latest role. Credits are charged at 2 credits per successful live fetch. If the live fetch fails, the API automatically falls back to a cached database result at no charge.

Company
Profile

Company live enrichment

Fetch the latest LinkedIn data for a specific company using its LinkedIn slug, URL, or organization ID.Endpoint: POST https://api.descovo.com/v1/linkedin-live-fetch/company/single
Auth: apiKey in the request body
Credit cost: 2 credits per live fetch (operation: liveEnrichCompany)

Request parameters

apiKey

string

required

Your Descovo API key.

type

string

required

The type of identifier you are providing. One of:

"slug" — LinkedIn company slug (e.g. "microsoft" from linkedin.com/company/microsoft/)
"liUrl" — Full LinkedIn company URL (e.g. "https://www.linkedin.com/company/microsoft/")
"orgId" — LinkedIn organization ID (numeric string, e.g. "1441") or a Descovo company ID that maps to an org ID

value

string

required

The identifier value corresponding to the type you specified.

Response fields

output

object

Hide properties

output.company

object

The enriched company data from LinkedIn.

Show company properties

output.company.preferred_name

string

Company’s display name.

output.company.linkedin_slug

string

LinkedIn organization slug.

output.company.employee_count

number

Reported employee count from LinkedIn.

output.company.location

object

Headquarters location with city and country_code.

chargeInfo

object

Show properties

chargeInfo.method

string

charged-now when live data was fetched. The fallback to cached data returns charged-now with creditsCharged: 0.

chargeInfo.creditsCharged

number

2 for a successful live fetch. 0 if the API fell back to cached data.

Example

Request using a LinkedIn slug:

{
  "apiKey": "sk_live_xxx",
  "type": "slug",
  "value": "microsoft"
}

Request using a full LinkedIn URL:

{
  "apiKey": "sk_live_xxx",
  "type": "liUrl",
  "value": "https://www.linkedin.com/company/microsoft/"
}

Response:

{
  "output": {
    "company": {
      "preferred_name": "Microsoft",
      "linkedin_slug": "microsoft",
      "employee_count": 221000,
      "location": {
        "city": "Redmond",
        "country_code": "US"
      }
    }
  },
  "chargeInfo": {
    "method": "charged-now",
    "creditsCharged": 2
  }
}

Fallback behavior

If the live fetch fails — for example, due to a LinkedIn availability issue — the API returns a cached version of the company from Descovo’s database. In this case, creditsCharged is 0. The response structure is identical; check creditsCharged to determine whether you received live or cached data.

If the company cannot be found at all, the API returns a 404. This usually means the identifier is incorrect or the company page no longer exists on LinkedIn.

When to use company live enrichment

You have a specific LinkedIn URL or slug for a high-value account and need the most current data.
You want to verify that headcount, funding, or location data is still accurate for a key prospect.
For bulk company data, use company search or audiences instead.

Profile live enrichment

Fetch the latest LinkedIn data for a specific person using their LinkedIn profile URL, slug, Sales Navigator URN, or user ID.Endpoint: POST https://api.descovo.com/v1/linkedin-live-fetch/profile/single
Auth: apiKey in the request body
Credit cost: 2 credits per live fetch (operation: liveEnrichPerson)

Request parameters

apiKey

string

required

Your Descovo API key.

identifier

string

required

A LinkedIn identifier for the person. Accepted formats:

LinkedIn slug (e.g. "williamhgates")
Full LinkedIn profile URL (e.g. "https://www.linkedin.com/in/williamhgates/")
Sales Navigator URN (e.g. "ACwAAA....")
LinkedIn numeric user ID

getDetailedEducation

boolean

default:"false"

When true, the response includes expanded education history with degree details and institution information. Increases response size and latency.

getDetailedWorkExperience

boolean

default:"false"

When true, the response includes a full work history with detailed company and role information for each position. Increases response size and latency.

Response fields

output

object

Hide properties

output.found

boolean

true if the profile was located (live or cached). false if it could not be found.

output.profile

object

The enriched profile data. Present when found is true.

Show profile properties

output.profile.first_name

string

Person’s first name.

output.profile.last_name

string

Person’s last name.

output.profile.title

string

Current job title.

output.profile.current_company

object

Current employer with name and linkedin_slug.

output.profile.location

object

Profile’s reported location with city and country_code.

chargeInfo

object

Show properties

chargeInfo.method

string

charged-now when live data was fetched. Fallback to cached data returns creditsCharged: 0.

chargeInfo.creditsCharged

number

2 for a successful live fetch. 0 if the API fell back to cached data.

Example

Request:

{
  "apiKey": "sk_live_xxx",
  "identifier": "https://www.linkedin.com/in/williamhgates/",
  "getDetailedEducation": false,
  "getDetailedWorkExperience": false
}

Response:

{
  "output": {
    "found": true,
    "profile": {
      "first_name": "Satya",
      "last_name": "Nadella",
      "title": "CEO",
      "current_company": {
        "name": "Microsoft",
        "linkedin_slug": "microsoft"
      },
      "location": {
        "city": "Bellevue",
        "country_code": "US"
      }
    }
  },
  "chargeInfo": {
    "method": "charged-now",
    "creditsCharged": 2
  }
}

Fallback behavior

If the live profile fetch fails, the API may return a cached database record with found: true and creditsCharged: 0. If neither live nor cached data is available, the response returns found: false. Check found and creditsCharged together to understand what you received.

Setting getDetailedEducation or getDetailedWorkExperience to true significantly increases response size and latency. Only enable these when you specifically need the detailed history.

When to use profile live enrichment

You have a specific LinkedIn URL for a prospect and need their most current role and company information.
You are validating that a profile’s current title or employer has not changed recently.
For enriching large numbers of profiles, use contact enrichment batch or audiences instead.

Overview

Endpoints

Live enrichment endpoints: company and profile

Company live enrichment

Request parameters

Response fields

Example

Fallback behavior

When to use company live enrichment

Profile live enrichment

Request parameters

Response fields

Example

Fallback behavior

When to use profile live enrichment

Overview

Endpoints

Documentation Index

​Company live enrichment

​Request parameters

​Response fields

​Example

​Fallback behavior

​When to use company live enrichment

​Profile live enrichment

​Request parameters

​Response fields

​Example

​Fallback behavior

​When to use profile live enrichment

Company live enrichment

Request parameters

Response fields

Example

Fallback behavior

When to use company live enrichment

Profile live enrichment

Request parameters

Response fields

Example

Fallback behavior

When to use profile live enrichment